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 分