Gatewards

io.github.rtahabasPublished by GitHub account rtahabasv0.2.0-beta.2Updated Nov 3, 2026

Drop-in spend governance + cross-agent dedup proxy for AI agent fleets, with x402 settlement.

VerifiedSTDIODesktop onlyFinanceDeveloper ToolsAI & ML

Overview

AI-generated overview

Lets an AI agent discover and call paid APIs through the Gatewards gateway, with per-agent spend caps, caching, dedup and optional x402 on-chain payment.

What you can do
  • Discover paid API services on the marketplace, with name, endpoint and price
  • Call a service's API by GET or POST and get back status, data and any cost paid
  • Check current daily spend, remaining budget and active subscriptions
  • List prepaid credit plans for a service and buy a credit bundle in proxy mode
When to use it
Useful when an agent needs to call third-party paid APIs and you want a hard spend limit enforced before a call fires, plus response caching and deduplication across several agents. Only add the x402 mode if you actually need to settle payments on-chain per call.
Requirements
Runs locally over stdio, typically via npx, so Node.js is needed. Either an agent API key (GATEWARDS_API_KEY, or the --api-key flag) for proxy mode, or a private key plus RPC URL and USDC address for x402 mode. The gateway URL defaults to a local address and must be pointed at the hosted gateway for real use. Network access to the gateway is required.
Before you install
The agent key GATEWARDS_API_KEY is a credential and is passed on the command line in the documented setup. x402 mode requires a wallet private key (GATEWARDS_PRIVATE_KEY) that signs real USDC payments on-chain; the README says it never leaves the machine, but a leaked key means lost funds. Subscribing buys credit bundles and calls can incur per-call charges, so spending is real money. Calls and payment receipts go to the configured gateway.

Installation

In SourceWeft

  1. Open Gatewards in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@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

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

Claude Desktop

Add to your claude_desktop_config.json:

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

ModeHowWhat you get
Proxy (default)--api-key=gw_agent_xxxRoutes 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

ToolWhat it does
gatewards_discover_servicesList paid API services on the marketplace (name, endpoint, price).
gatewards_call_apiMake a GET/POST call. Returns status, data, and cost if a payment was made.
gatewards_check_budgetCurrent daily spend, remaining budget, and active subscriptions.
gatewards_get_plansList prepaid credit plans for a service.
gatewards_subscribeBuy a credit bundle for a service (proxy mode only).

Configuration

Flags or environment variables (flags win):

FlagEnvDefaultNotes
--gatewayGATEWARDS_GATEWAY_URLhttp://localhost:3001Gateway base URL.
--api-keyGATEWARDS_API_KEY—Agent key. Enables proxy mode.
--private-keyGATEWARDS_PRIVATE_KEY—0x-prefixed key for x402 mode. Never sent anywhere.
--rpc-urlGATEWARDS_RPC_URL—Required for x402 mode.
--usdc-addressGATEWARDS_USDC_ADDRESS—Required for x402 mode.
--networkGATEWARDS_NETWORKbase-sepoliae.g. base, base-sepolia.
--merchantGATEWARDS_MERCHANT_URL—Restrict absolute URLs to this origin.

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

License

Apache-2.0

Source: packages/mcp-server/README.md at commit 1d598d0

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.0-beta.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts