Docs

Hosted MCP
in a few minutes.

One product: hosted MCP on x402. Primary install is npx -y @agentpayxyz/mcp-server. Optional JS SDK: @agentpayxyz/sdk. API base: https://api.agentpay.so.

Get a key — 50 free calls QUICKSTART.md

Install

npx -y @agentpayxyz/mcp-server

JS SDK (optional): npm install @agentpayxyz/sdk. There is no Python SDK.

Get an API key

curl -s -X POST https://api.agentpay.so/api/merchants/register \
  -H "Content-Type: application/json" \
  -d '{ "name": "My Agent", "email": "you@example.com" }'

Claude Desktop / Cursor

{
  "mcpServers": {
    "agentpay": {
      "command": "npx",
      "args": ["-y", "@agentpayxyz/mcp-server"],
      "env": {
        "AGENTPAY_API_KEY": "apk_your_key_here",
        "AGENTPAY_MERCHANT_ID": "mer_your_merchant_id"
      }
    }
  }
}

Remote MCP

https://api.agentpay.so/api/mcp
Authorization: Bearer apk_your_key_here

Mint a short-lived host token:

curl -X POST https://api.agentpay.so/api/mcp/tokens \
  -H "Authorization: Bearer apk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "audience": "openai", "ttlSeconds": 3600 }'

REST

Authority bootstrap and governed access live on the same API host. See QUICKSTART.md Path B and openapi.yaml.

curl -s "https://api.agentpay.so/api/capabilities/authority-bootstrap?principalId=principal_1&subjectType=workspace&subjectRef=my-workbench&workbenchId=my-workbench" \
  -H "Authorization: Bearer apk_your_key_here"

Pricing on this surface

Launch: $0 on-ramp, 50 free calls, no card.
MCP Builder: $39/mo hosted MCP on x402, 75 bps on funded actions once money moves.
Growth: $149/mo exists; not the week-one offer.

London and Bangalore. GDPR. Card and x402/USDC are the advertised rails. Other regional rails stay unpublished until they settle with a receipt.