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 分