Gatewards

本地服务

gatewards.com金融数据018 周前更新

代码仓库访问官网

关于 Gatewards

Gatewards 是供 Agent 经网关发现并调用付费 API 的 MCP 服务。它支持按 Agent 设置支出上限和跨 Agent 请求去重，并提供代理与自托管 x402 支付模式。

主要功能

01发现付费 API 服务
02经网关调用 API
03按 Agent 限制支出
04缓存响应并对请求去重
05以自托管方式结算 x402 支付

适用场景

01限制 Agent 的 API 调用开支
02避免多个 Agent 重复请求
03通过 x402 支付 API 调用费用

MCP 相关

Gatewards 提供发现服务、调用 API、检查预算、查看套餐和订阅等工具。代理模式由网关执行预算限制并处理缓存与去重；x402 模式则由 Agent 自行签署 USDC 支付。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "rtahabas-gatewards": {
      "command": "npx",
      "args": [
        "-y",
        "@gatewards/mcp-server"
      ],
      "env": {
        "GATEWARDS_API_KEY": "<GATEWARDS_API_KEY>",
        "GATEWARDS_GATEWAY_URL": "<GATEWARDS_GATEWAY_URL>"
      }
    }
  }
}

启动命令npx -y @gatewards/mcp-server

需要配置的环境变量

GATEWARDS_API_KEY密钥Gatewards agent API key (gw_agent_…). Required for authenticated proxy calls; the server starts without it but cannot reach the gateway.

GATEWARDS_GATEWAY_URLGateway base URL. Defaults to http://localhost:3001; set to https://api.gatewards.com for the hosted gateway.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@gatewards/mcp-server0.2.0-beta.2stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

@gatewards/mcp-server

一个 MCP 服务，让任何 Agent（Claude Desktop、Cursor、VS Code 或你自己的 MCP 客户端）都能通过 Gatewards 发现并调用付费 API，同时支持按 Agent 设置支出上限、跨 Agent 请求去重，以及非托管式 x402 结算。

Agent 自行保管 API 密钥和钱包。Gatewards 会在请求路径中强制执行支出上限：超出预算的调用会在执行前被拒绝，而不是事后才记录。

安装

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

Claude Desktop

将以下内容添加到你的 claude_desktop_config.json：

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

从你的 Gatewards 控制面板获取 Agent 密钥。

两种模式

模式	方式	功能
代理（默认）	`--api-key=gw_agent_xxx`	通过网关路由调用。按 Agent 强制执行预算、缓存响应，并跨 Agent 去重。不需要钱包，也无需链上支付。
x402（自托管）	`--private-key=0x... --rpc-url=... --usdc-address=...`	Agent 自行签署 USDC 付款。当 API 返回 `402` 时，付款会在链上结算，随后请求会携带回执重试。密钥不会离开你的设备。

若需治理和缓存，请选择代理模式。只有在确实需要按调用进行链上支付时，才添加 x402。

工具

工具	功能
`gatewards_discover_services`	列出市场上的付费 API 服务（名称、端点、价格）。
`gatewards_call_api`	发起 `GET`/`POST` 调用。若发生付款，则返回状态、数据和费用。
`gatewards_check_budget`	当前每日支出、剩余预算和有效订阅。
`gatewards_get_plans`	列出某项服务的预付费额度套餐。
`gatewards_subscribe`	购买某项服务的额度套餐（仅限代理模式）。

配置

标志或环境变量（标志优先）：

标志	环境变量	默认值	说明
`--gateway`	`GATEWARDS_GATEWAY_URL`	`http://localhost:3001`	网关基础 URL。
`--api-key`	`GATEWARDS_API_KEY`	—	Agent 密钥。启用代理模式。
`--private-key`	`GATEWARDS_PRIVATE_KEY`	—	用于 x402 模式、以 `0x` 为前缀的密钥。不会发送到任何地方。
`--rpc-url`	`GATEWARDS_RPC_URL`	—	x402 模式必需。
`--usdc-address`	`GATEWARDS_USDC_ADDRESS`	—	x402 模式必需。
`--network`	`GATEWARDS_NETWORK`	`base-sepolia`	例如 `base`、`base-sepolia`。
`--merchant`	`GATEWARDS_MERCHANT_URL`	—	将绝对 URL 限制为此源。