Gatewards

io.github.rtahabas由 GitHub 账号 rtahabas 发布v0.2.0-beta.2更新于 Nov 3, 2026

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

已验证STDIO仅桌面金融开发者工具AI 与机器学习

概览

AI 生成的概览

让 AI 代理通过 Gatewards 网关发现并调用付费 API，支持按代理的消费上限、缓存、去重以及可选的 x402 链上支付。

可以做什么
  • 发现市场上的付费 API 服务，含名称、端点与价格
  • 以 GET 或 POST 调用服务 API，返回状态、数据以及产生的费用
  • 查询当日消费、剩余预算与生效中的订阅
  • 列出某服务的预付额度方案，并在代理模式下购买额度包
适用场景
适合代理需要调用第三方付费 API，且希望在调用发出前就强制执行消费上限，并在多个代理之间共享缓存与去重的场景。只有在确实需要按次链上结算时才启用 x402 模式。
运行要求
以 stdio 本地运行，通常通过 npx 启动，需要 Node.js。代理模式需要代理 API 密钥（GATEWARDS_API_KEY 或 --api-key 参数）；x402 模式需要私钥、RPC URL 和 USDC 地址。网关地址默认指向本地地址，实际使用需改为托管网关。需要能访问网关的网络。
安装前请注意
GATEWARDS_API_KEY 是凭据，文档中的配置方式把它写在命令行参数里。x402 模式需要钱包私钥（GATEWARDS_PRIVATE_KEY），用于签署真实的 USDC 链上支付；README 称私钥不会外发，但一旦泄露即可能损失资金。订阅会购买额度包，调用也可能按次计费，涉及真实支出。调用与支付凭证会发送到所配置的网关。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Gatewards，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

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

来源：packages/mcp-server/README.md，提交 1d598d0

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.2.0-beta.2最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分