MCP server

@ax402/mcp-server exposes Ax402 seller API 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 and/or HEDERA_ACCOUNT_ID + HEDERA_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..."
      }
    }
  }
}

To enable Hedera payments on ax402_pay_url, add HEDERA_ACCOUNT_ID and HEDERA_PRIVATE_KEY to env.

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

Tools

Tool	Scope
`ax402_list_apis`	apis:read
`ax402_get_api`	apis:read
`ax402_discovery_urls`	apis:read — gateway OpenAPI / well-known URLs
`ax402_set_discovery_guidance`	apis:write — guidance, contact email, OpenAPI version
`ax402_list_endpoints`	endpoints:read
`ax402_update_endpoint_schemas`	endpoints:write — request/response JSON Schema
`ax402_create_api`	apis:write + verified email — optional discovery fields
`ax402_add_endpoint`	endpoints:write
`ax402_import_openapi`	openapi:read — persists schemas from the spec when present
`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` and/or Hedera keys)

See API discovery for gateway OpenAPI / well-known manifests.

Environment

Variable	Required	Purpose
`AX402_API_KEY`	Yes	Seller API key
`AX402_BASE_URL`	No	API base URL (default `https://api.ax402.io`)
`AX402_EVM_PRIVATE_KEY`	For `ax402_pay_url`	EVM signer
`HEDERA_ACCOUNT_ID`	For `ax402_pay_url`	Hedera payer account
`HEDERA_PRIVATE_KEY`	For `ax402_pay_url`	Hedera private key

Scopes

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

Agent guide · CLI reference · API discovery · /llms.txt · Source on GitHub