Skip to main content

​
Prerequisites

  • Node.js 18+
  • A wallet with USDC on Base (+ small ETH for gas)

​
Claude Code

claude mcp add xenarch -- npx @xenarch/agent-mcp

​
Claude Desktop

Edit your config file:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "xenarch": {
      "command": "npx",
      "args": ["@xenarch/agent-mcp"],
      "env": {
        "XENARCH_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY"
      }
    }
  }
}
Restart Claude Desktop after saving.

​
Other MCP clients

Any client that supports the MCP stdio transport can use the server: 
npx @xenarch/agent-mcp
The server communicates over stdin/stdout using the MCP protocol.

​
Wallet configuration

Set XENARCH_PRIVATE_KEY in the MCP server’s env block:
{
  "env": {
    "XENARCH_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY"
  }
}

​
Configuration variables

VariableDefaultDescription
XENARCH_PRIVATE_KEY—Wallet private key
XENARCH_NETWORKbasebase or base-sepolia
XENARCH_RPC_URLhttps://mainnet.base.orgBase RPC endpoint
XENARCH_API_BASEhttps://api.xenarch.devPlatform API
XENARCH_AUTO_APPROVE_MAX—Auto-approve payments up to this USD amount

​
Testnet

For testing without real funds: 
{
  "mcpServers": {
    "xenarch": {
      "command": "npx",
      "args": ["@xenarch/agent-mcp"],
      "env": {
        "XENARCH_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY",
        "XENARCH_NETWORK": "base-sepolia",
        "XENARCH_RPC_URL": "https://sepolia.base.org"
      }
    }
  }
}

​
Troubleshooting

Tools not appearing: Restart your MCP client. Verify npx @xenarch/agent-mcp runs without errors in your terminal. “No wallet configured”: Set XENARCH_PRIVATE_KEY or create ~/.xenarch/wallet.json. “Insufficient USDC”: Fund your wallet with USDC on Base. You also need a small amount of ETH for gas (~$0.01).