Gatewards MCP Server

@gatewards/mcp-server

An MCP server that lets any agent (Claude Desktop, Cursor, VS Code, or your own MCP client) discover and call paid APIs through Gatewards — with per-agent spend caps, cross-agent dedup, and non-custodial x402 settlement.

The agent keeps its own API key and wallet. Gatewards enforces the spend limit in the request path: a call over budget is refused before it fires, not logged after.

Install

npx @gatewards/mcp-server --api-key=gw_agent_xxx --gateway=https://api.gatewards.com

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "gatewards": {
      "command": "npx",
      "args": [
        "@gatewards/mcp-server",
        "--api-key=gw_agent_xxx",
        "--gateway=https://api.gatewards.com"
      ]
    }
  }
}

Get an agent key from your Gatewards dashboard.

Two modes

Mode	How	What you get
Proxy (default)	--api-key=gw_agent_xxx	Routes calls through the gateway. Per-agent budget enforcement, response caching, and cross-agent dedup. No wallet, no on-chain payment.
x402 (self-custody)	--private-key=0x... --rpc-url=... --usdc-address=...	The agent signs USDC payments itself. When an API returns 402, payment is settled on-chain and the request retries with a receipt. Keys never leave your machine.

Pick proxy mode for governance and caching. Add x402 only when you actually need to pay per call on-chain.

Tools

Tool	What it does
gatewards_discover_services	List paid API services on the marketplace (name, endpoint, price).
gatewards_call_api	Make a GET/POST call. Returns status, data, and cost if a payment was made.
gatewards_check_budget	Current daily spend, remaining budget, and active subscriptions.
gatewards_get_plans	List prepaid credit plans for a service.
gatewards_subscribe	Buy a credit bundle for a service (proxy mode only).

Configuration

Flags or environment variables (flags win):

Flag	Env	Default	Notes
--gateway	GATEWARDS_GATEWAY_URL	http://localhost:3001	Gateway base URL.
--api-key	GATEWARDS_API_KEY	—	Agent key. Enables proxy mode.
--private-key	GATEWARDS_PRIVATE_KEY	—	0x-prefixed key for x402 mode. Never sent anywhere.
--rpc-url	GATEWARDS_RPC_URL	—	Required for x402 mode.
--usdc-address	GATEWARDS_USDC_ADDRESS	—	Required for x402 mode.
--network	GATEWARDS_NETWORK	base-sepolia	e.g. base, base-sepolia.
--merchant	GATEWARDS_MERCHANT_URL	—	Restrict absolute URLs to this origin.

Either --api-key or --private-key is required.

License

Apache-2.0