Pay MCP Client

Model Context Protocol (MCP) client for AI-powered payment operations. Connects LLMs to the Pay Server for payment operations.

Setup

npm install
npm run build
npm start

Cursor Configuration

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "wallet-mcp-server": {
      "command": "node",
      "args": ["/path/to/mcp-server/build/index.js"],
      "env": {
        "WALLET_API_URL": "http://localhost:3001"
      }
    }
  }
}

Available Tools

Utility Tools

| Tool | Description | |------|-------------| | get_time | Get current date and time | | add | Add two numbers together |

Wallet Tools

| Tool | Description | Parameters | |------|-------------|------------| | get_eth_balance | Get ETH balance for wallet | token | | sign_eth_transaction | Sign and broadcast ETH transaction | token, recipientAddress, amount | | get_transaction_history | Get transaction history | token |

Supplier Tools

| Tool | Description | Parameters | |------|-------------|------------| | get_suppliers | Get list of available suppliers | - | | get_supplier | Get supplier details by ID | supplierId | | pay_supplier | Pay a supplier by ID | token, supplierId, amount |

Token Format

The bearer token is 168 characters:

• ephSk (64 chars): Ephemeral secret key hex
• keyId (64 chars): MPC key ID
• address (40 chars): Wallet address (without 0x)

Example Usage

Once connected to Cursor, you can use natural language:

• "What's my ETH balance?" (provide token)
• "Send 0.001 ETH to 0x..." (provide token)
• "Show my transaction history" (provide token)
• "List available suppliers"
• "Pay Amazon 0.01 ETH" (provide token)

Dependencies

• @modelcontextprotocol/sdk - MCP SDK
• Requires wallet-api running on http://localhost:3001