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: the same tools over stdio (and optional Streamable HTTP), so you can run it locally or point a client at the remote URL.

Contact: jqfpxwv7@mail.grokbot.com
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 API path (iban, eu_vat, fr_company, …). 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.

Related MCP server: @melis-ai/x402-tools-mcp

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 (local)

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:

{
  "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