关于 Forge Agent Hub
Forge Agent Hub 是一个开源 MCP 服务,用于调用按次付费的 API,费用通过 Base 上的 USDC x402 支付。软件包可在本地提供完整 API 目录,托管网关则提供其原有工具集。
主要功能
- 01列出 API 端点和价格
- 02为目录中的 API 路径提供工具
- 03可选自动执行 x402 付款
- 04支持 stdio 和本地 Streamable HTTP
- 05提供托管远程网关
适用场景
- 01查找可用 API 工具及其价格
- 02通过 MCP 客户端调用 API 路径
- 03使用 x402 付款自动完成符合条件的调用
- 04无需运行进程即可连接托管网关
MCP 相关
该服务提供免费的端点列表工具,以及与 API 路径对应的付费工具。它支持本地 stdio 和 Streamable HTTP,也提供托管的 Streamable HTTP 网关。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
服务地址
https://x402-gateway.forge-x402.workers.dev/mcp一键复制安装命令
Claude CodeTerminal
claude mcp add --transport http forge-agent-hub-forge-agent https://x402-gateway.forge-x402.workers.dev/mcpCursor.cursor/mcp.json
{"mcpServers":{"forge-agent-hub-forge-agent":{"type":"http","url":"https://x402-gateway.forge-x402.workers.dev/mcp"}}}在 Cursor 中打开VS Code.vscode/mcp.json
{"servers":{"forge-agent-hub-forge-agent":{"type":"http","url":"https://x402-gateway.forge-x402.workers.dev/mcp"}}}在 VS Code 中打开Claude Desktopclaude_desktop_config.json
{"mcpServers":{"forge-agent-hub-forge-agent":{"type":"http","url":"https://x402-gateway.forge-x402.workers.dev/mcp"}}}Windsurf~/.codeium/windsurf/mcp_config.json
{"mcpServers":{"forge-agent-hub-forge-agent":{"serverUrl":"https://x402-gateway.forge-x402.workers.dev/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
forge-agent-mcp
开源 MCP 服务,封装了 Forge Agent Hub 的 x402 API。
- 在线远程服务(已托管):
https://x402-gateway.forge-x402.workers.dev/mcp(Streamable HTTP) - 此软件包(v1.3.0): stdio(以及可选的本地 Streamable HTTP),涵盖完整目录(两个 API 主机)。托管远程服务仍是原始网关 MCP。
联系方式:[email protected]
许可证:MIT
此软件包未发布到 npm(无需额外账户)。克隆并使用 Node 20+ 运行。
工具
list_endpoints— 免费。列出付费工具、价格(以 Base 上的 USDC 计价)和 HTTP 路径。- 每个目录路径对应一个付费工具(
iban、eu_vat、sanctions_check等;目前共 58 个)。未付款的调用会返回 HTTP 402 挑战。如果设置了EVM_PRIVATE_KEY且已安装@x402/fetch,服务会使用签名后的 x402 v2 付款重试。网关上的托管远程服务仍只提供原始网关工具。Wave-1 工具(包括两个 $3 的操作手册)支持使用?demo=1获取带标签的示例;此外,每个 IP 每个 UTC 日的前 3 次成功真实 HTTP 调用也免费。
stdio
{
"mcpServers": {
"forge-agent-hub": {
"command": "node",
"args": ["/path/to/forge-agent-mcp/src/server.mjs"]
}
}
}
git clone https://github.com/forge-agent-hub/forge-agent-mcp
cd forge-agent-mcp
npm install
node src/server.mjs
Streamable HTTP(本地)
npm run start:http
# listens on 127.0.0.1:8787/mcp
托管远程服务
如果不想运行进程,请优先使用在线网关:
{
"mcpServers": {
"forge-agent-api": {
"url": "https://x402-gateway.forge-x402.workers.dev/mcp",
"transport": "streamable-http"
}
}
}
托管工具的付款通过网关上的 @x402/mcp 在 MCP _meta 中传递。
环境变量
| 变量 | 用途 |
|---|---|
API_BASE | 默认值为 https://x402-gateway.forge-x402.workers.dev |
EVM_PRIVATE_KEY | 可选。启用此进程中的自动付款。切勿提交此密钥。 |
PORT | 使用 --http 运行时的 HTTP 端口(默认值为 8787) |
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。