MCP server

@ax402/mcp-server exposes Ax402 control-plane actions as MCP tools for Cursor, Claude Desktop, and compatible hosts. API key auth only — no JWT support.

Install and run

npx @ax402/mcp-server

Requires Node.js 18+.

Set AX402_API_KEY (scoped ax402_live_... key from the Ax402 dashboard). Optional: AX402_BASE_URL (default https://api.ax402.io). For paying gateway URLs, set AX402_EVM_PRIVATE_KEY.

From source

git clone https://github.com/AxLabs/ax402-sdks.git
cd ax402-sdks && pnpm install
pnpm --filter @ax402/mcp-server build

AX402_API_KEY=ax402_live_... \
AX402_BASE_URL=https://api.ax402.io \
node tools/mcp-server/dist/index.js

Cursor configuration

{
  "mcpServers": {
    "ax402": {
      "command": "npx",
      "args": ["-y", "@ax402/mcp-server"],
      "env": {
        "AX402_BASE_URL": "https://api.ax402.io",
        "AX402_API_KEY": "ax402_live_...",
        "AX402_EVM_PRIVATE_KEY": "0x..."
      }
    }
  }
}

Example config: cursor-mcp.json.example in the ax402-sdks repo.

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_settlements_export — settlements:read
• ax402_billing_overview — billing:read
• ax402_income_summary — income:read
• ax402_apis_slug_check — apis:read
• ax402_apis_probe_upstream — apis:read
• ax402_scopes_list — JWT session
• ax402_facilitator_stats — authenticated
• ax402_billing_catalog — public billing catalog
• 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 · Source on GitHub