MCP Server

The Paxeer Model Context Protocol (MCP) Server enables AI assistants to interact with Paxeer networks through natural language. Built on the Model Context Protocol 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

Cursor Setup

Open Settings

Navigate to Cursor → Settings → Cursor Settings → MCP

Configure Server

Click "Add new Global MCP server" and add this configuration to mcp.json:

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

Restart

Restart Cursor to activate the MCP server. You'll see a notification when it's ready.

Private Key Setup

Security Notice: Generate a dedicated wallet for MCP operations. Never use your main wallet's private key.

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:

# 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

# .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:

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

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

Security Guidelines

Security Guidelines:

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

For production:

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

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.