MCP server

Model Context Protocol server exposing Ax402 control-plane actions as agent tools for Cursor, Claude Desktop, and compatible hosts. API key auth only — no JWT support.

Build and run

pnpm --filter @axlabs/ax402-mcp-server build
AX402_API_KEY=ax402_live_... \\
AX402_BASE_URL=https://api.staging.ax402.io \\
node tools/mcp-server/dist/index.js

Cursor configuration

{
  "mcpServers": {
    "ax402": {
      "command": "node",
      "args": ["/path/to/ax402-sdk/tools/mcp-server/dist/index.js"],
      "env": {
        "AX402_API_KEY": "ax402_live_...",
        "AX402_BASE_URL": "https://api.staging.ax402.io",
        "AX402_EVM_PRIVATE_KEY": "0x..."
      }
    }
  }
}

Build from the ax402-sdk repo — the package is not published to npm yet.

Tools

• ax402_list_apis — apis:read
• ax402_get_api — apis:read
• ax402_list_endpoints — endpoints:read
• ax402_create_api — apis:write + verified email
• ax402_add_endpoint — endpoints:write
• ax402_import_openapi — openapi:read
• ax402_add_domain — domains:write
• ax402_list_domains — domains:read
• ax402_verify_domain — domains:write
• ax402_domain_suggest — domains:read
• ax402_stats_overview — stats:read
• ax402_stats_api — stats:read
• ax402_settlements_list — settlements:read
• ax402_inspect_url — buyer (no wallet)
• ax402_supported_networks — authenticated
• ax402_platform_config — public
• ax402_pay_url — buyer (AX402_EVM_PRIVATE_KEY)

Scopes

Create keys with the apiManager preset for create/update flows. Add AX402_EVM_PRIVATE_KEY to enable in-process payment via ax402_pay_url.

Related

Agent guide · CLI reference · /llms.txt