Forge Agent Hub

io.github.forge-agent-hub由 GitHub 账号 forge-agent-hub 发布v1.3.0更新于 Nov 11, 2026

Pay-per-call APIs via x402 USDC on Base. Hosted MCP: original gateway; stdio: full catalog.

已验证Streamable HTTP可网页运行金融商业与电商

概览

AI 生成的概览

封装 Forge Agent Hub 按次付费 x402 API 的 MCP 服务器，让助手列出付费端点并在 Base 上以 USDC 付费调用。

可以做什么
  • 列出付费目录：免费获取工具、USDC（Base）价格与 HTTP 路径
  • 调用付费端点：每个目录路径一个工具，如 IBAN、欧盟增值税、制裁名单核查等约 58 个
  • 处理支付：未付费调用返回 HTTP 402 挑战；配置私钥与支付库后，服务器会以签名的 x402 支付重试
  • 试用样例：部分首批工具支持演示参数，返回带标注的示例结果
  • 可本地以 stdio 或本地 Streamable HTTP 运行，也可使用托管远程网关
适用场景
适合让助手访问按次付费的数据与核验类 API（银行账户、增值税、制裁名单等查询），又不想自行编写客户端，并愿意在 Base 上以 USDC 按次付费的场景。
运行要求
需要托管远程端点（Streamable HTTP），或在本地克隆后用 Node 20+ 与 npm install 运行；该包未发布到 npm。可选环境变量：API_BASE、用于自动支付的 EVM_PRIVATE_KEY，以及本地 HTTP 模式的 PORT。
安装前请注意
自动支付需要 EVM_PRIVATE_KEY，即可动用资金的钱包私钥，务必不要提交到版本库，并谨慎启用。付费调用会花费 Base 上的 USDC，每 IP 每日的免费调用次数有限。调用会把查询数据发送给第三方网关。

安装

在 SourceWeft 中

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

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.forge-agent-hub%2Fforge-agent-mcp/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "forge-agent-hub": {
      "type": "http",
      "url": "https://x402-gateway.forge-x402.workers.dev/mcp"
    }
  }
}

README

forge-agent-mcp

Open-source MCP server that wraps the Forge Agent Hub x402 APIs.

  • Live remote (already hosted): https://x402-gateway.forge-x402.workers.dev/mcp (Streamable HTTP)
  • This package (v1.3.0): stdio (and optional local Streamable HTTP) covering the full catalog (both API hosts). The hosted remote remains the original gateway MCP.

Contact: [email protected]
Licence: MIT

This package is not published to npm (no extra account). Clone and run with Node 20+.

Tools

  • list_endpoints — free. Lists paid tools, prices (USDC on Base) and HTTP paths.
  • One paid tool per catalog path (iban, eu_vat, sanctions_check, …; currently 58). An unpaid call returns the HTTP 402 challenge. If EVM_PRIVATE_KEY is set and @x402/fetch is installed, the server retries with a signed x402 v2 payment. The hosted remote at the gateway still exposes the original gateway tools only. Wave-1 tools (including two $3 playbooks) accept ?demo=1 for a labelled sample; the first 3 successful real HTTP calls per IP per UTC day are also free.

stdio

json
{  "mcpServers": {    "forge-agent-hub": {      "command": "node",      "args": ["/path/to/forge-agent-mcp/src/server.mjs"]    }  }}
bash
git clone https://github.com/forge-agent-hub/forge-agent-mcpcd forge-agent-mcpnpm installnode src/server.mjs

Streamable HTTP (local)

bash
npm run start:http# listens on 127.0.0.1:8787/mcp

Hosted remote

Prefer the live gateway when you do not want to run a process:

json
{  "mcpServers": {    "forge-agent-api": {      "url": "https://x402-gateway.forge-x402.workers.dev/mcp",      "transport": "streamable-http"    }  }}

Payment for hosted tools is passed in MCP _meta via @x402/mcp on the gateway.

Environment

VariablePurpose
API_BASEDefault https://x402-gateway.forge-x402.workers.dev
EVM_PRIVATE_KEYOptional. Enables automatic payment in this process. Never commit it.
PORTHTTP port when run with --http (default 8787)

来源：README.md，提交 2d0ed4c

工具

0
SourceWeft 尚未读取此服务器的工具。

版本历史

1
  1. v1.3.0最新Nov 11, 2026

评分

已满足适用检查项的 85%

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

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分

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

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