---
title: 'MCP Server'
description: 'Enable AI assistants to interact with Paxeer networks through natural language using the Model Context Protocol'
keywords: ['mcp', 'ai', 'model context protocol', 'claude', 'cursor', 'windsurf', 'blockchain ai']
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

The Paxeer Model Context Protocol (MCP) Server enables AI assistants to interact with Paxeer networks through natural language. Built on the [Model Context Protocol](https://modelcontextprotocol.io/) standard, it provides seamless blockchain integration for AI coding assistants.

## What is MCP?

The Model Context Protocol is an open standard that connects AI systems with external tools and data sources. It enables:

- Real-time data access from external services
- Function execution and operations
- Context preservation across interactions
- Specialized capabilities beyond base training

The Paxeer MCP Server leverages this protocol to bring blockchain functionality directly to your AI assistant.

## Capabilities

| Category | Features |
| --- | --- |
| Account Management | Wallet addresses • Balance queries • Contract verification |
| Token Operations | HPX transfers • ERC20/721/1155 support • Token approvals |
| Blockchain Data | Block information • Transaction details • Network status |
| Smart Contracts | State queries • Function execution • Event logs |
| Networks | Paxeer Mainnet (chain ID 125) |

## Setup Guide

<Tabs>
<Tab title="Cursor">

### Cursor Setup

<Steps>

<Step title="Open Settings">
Navigate to `Cursor → Settings → Cursor Settings → MCP`
</Step>

<Step title="Configure Server">
Click **"Add new Global MCP server"** and add this configuration to `mcp.json`:

```json
{
  "mcpServers": {
    "paxeer-mcp-server": {
      "command": "npx",
      "args": ["-y", "@paxeer/mcp-server"],
      "env": {
        "PRIVATE_KEY": "your_private_key_here"
      }
    }
  }
}
```
</Step>

<Step title="Restart">
Restart Cursor to activate the MCP server. You'll see a notification when it's ready.
</Step>

</Steps>

</Tab>
<Tab title="Windsurf">

### Windsurf Setup

<Steps>

<Step title="Open Settings">
Navigate to `Windsurf → Settings → Windsurf Settings → Cascade`
</Step>

<Step title="Add Configuration">
Add the Paxeer MCP Server to your configuration:

```json
{
  "mcpServers": {
    "paxeer": {
      "command": "npx",
      "args": ["-y", "@paxeer/mcp-server"],
      "env": {
        "PRIVATE_KEY": "your_private_key_here"
      }
    }
  }
}
```
</Step>

<Step title="Activate">
Save and restart Windsurf. The server loads automatically.
</Step>

</Steps>

</Tab>
<Tab title="Claude Desktop">

### Claude Desktop Setup

<Steps>

<Step title="Install Claude">
Download [Claude Desktop](https://claude.ai/download) from Anthropic.
</Step>

<Step title="Edit Configuration">
Open **Settings** → **Developer** → **Edit Config** and add:

```json
{
  "mcpServers": {
    "paxeer": {
      "command": "npx",
      "args": ["-y", "@paxeer/mcp-server"],
      "env": {
        "PRIVATE_KEY": "your_private_key_here"
      }
    }
  }
}
```
</Step>

<Step title="Restart">
Save and restart Claude Desktop to enable Paxeer tools.
</Step>

</Steps>

</Tab>
<Tab title="Claude CLI">

### Claude CLI Setup

<Steps>

<Step title="Install CLI">
```bash
npm install -g @anthropic-ai/claude-code
```
</Step>

<Step title="Add Server">
```bash
claude mcp add paxeer-mcp-server npx @paxeer/mcp-server
```
</Step>

<Step title="Start Session">
```bash
claude
```

The Paxeer MCP Server activates automatically in your session.
</Step>

</Steps>

</Tab>
</Tabs>

## Private Key Setup

<Warning>**Security Notice**: Generate a dedicated wallet for MCP operations. Never use your main wallet's private key.</Warning>

Export your private key from your wallet:

- Look for "Export Private Key" or "Show Private Key" in wallet settings
- Ensure the key starts with `0x`
- Fund the wallet with small amounts for testing

## Features

The Paxeer MCP Server enables your AI assistant to:

### Blockchain Operations

- Query account balances and transaction history
- Execute token transfers (HPX and ERC-20 tokens)
- Interact with smart contracts
- Monitor network status

### Available Tools

#### Core Operations

| Tool | Purpose | Example |
| --- | --- | --- |
| `get_address_from_private_key` | Retrieve wallet address | "What's my wallet address?" |
| `get_balance` | Check HPX balance | "Check balance of 0x123..." |
| `transfer_hpx` | Send HPX tokens | "Send 1 HPX to 0x456..." |
| `is_contract` | Verify contract address | "Is 0x789... a contract?" |

#### Token Management

| Tool | Purpose | Example |
| --- | --- | --- |
| `get_token_info` | Token metadata | "Get USDC token info" |
| `get_token_balance` | Token balance | "Check my USDC balance" |
| `transfer_token` | Token transfer | "Send 100 USDC to 0x123..." |
| `approve_token_spending` | Token approval | "Approve DEX for USDC" |

#### Blockchain Data

| Tool | Purpose | Example |
| --- | --- | --- |
| `get_chain_info` | Network information | "Show Paxeer mainnet info" |
| `get_block_by_number` | Block details by number | "Get block 12345" |
| `get_latest_block` | Latest block details | "Get latest block" |
| `get_transaction` | Transaction data | "Show tx 0xTXID..." |
| `read_contract` | Contract state | "Read contract reserves" |

## Resource URIs

Access blockchain data through standardized URIs:

```bash
# Network data
evm://paxeer/chain

# Block information
evm://paxeer/block/latest
evm://paxeer/block/12345

# Transactions
evm://paxeer/tx/0xabc123...
evm://paxeer/tx/0xabc123.../receipt

# Token data
evm://paxeer/token/0xTOKEN_ADDRESS
evm://paxeer/token/0xTOKEN_ADDRESS/balanceOf/0xWALLET...
```

## Configuration

### Environment Setup

```bash
# .env file
PRIVATE_KEY=0x_your_private_key_here

# Optional
CUSTOM_RPC_URL=https://your-rpc.com
CUSTOM_CHAIN_ID=125
```

### HTTP Server Mode

For web applications:

```bash
# Start HTTP server
npx @paxeer/mcp-server --http

# Connect from web app
const eventSource = new EventSource('http://localhost:3001/sse');
```

## Security Guidelines

<Warning>
**Security Guidelines:**

1. **Use a dedicated wallet** - Create a new wallet specifically for MCP
2. **Minimal funding** - Only add funds needed for testing
3. **Environment variables** - Never hardcode private keys
4. **Monitor activity** - Regularly check transaction history

**For production:**

- Implement transaction limits
- Use multi-signature wallets
- Add contract whitelisting
- Enable rate limiting

</Warning>

## Troubleshooting

**Connection issues**: Verify Node.js 18+ is installed and restart your AI assistant.

**Private key errors**: Ensure key format starts with `0x` and wallet has sufficient funds.