Gatewards

from rtahabas

Drop-in spend governance and cross-agent dedup proxy for AI agent fleets — per-agent budget enforcement and non-custodial x402 settlement over MCP.

🔥🔥🔥✓ VerifiedPaid serviceNeeds API keys

#payments

@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.

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).

License

Apache-2.0

Copy & paste — that's it

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

Before it works, you'll need: GATEWARDS_API_KEYGATEWARDS_PRIVATE_KEY

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.

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.