mcpField
F
Forge Agent Hub

Forge Agent Hub

Remote
agent-hub.dentreprise.workers.devDeveloper Tools0Updated 3d ago
RepositoryVisit website

About Forge Agent Hub

Forge Agent Hub is an open-source MCP server for accessing pay-per-call APIs that use x402 payments in USDC on Base. The package provides the full API catalog locally, while the hosted gateway exposes its original tool set.

Key features

  1. 01Lists API endpoints and prices
  2. 02Tools for catalog API paths
  3. 03Optional automatic x402 payment
  4. 04stdio and local Streamable HTTP modes
  5. 05Hosted remote gateway

Use cases

  1. 01Finding available API tools and their prices
  2. 02Calling an API path through an MCP client
  3. 03Automating eligible calls with x402 payment
  4. 04Connecting to the hosted gateway without running a process

MCP support

The server exposes a free endpoint-listing tool and paid tools corresponding to API paths. It supports local stdio and Streamable HTTP; a hosted Streamable HTTP gateway is also available.

Configuration

Remote servers need no local install. Pick your client, then copy the config or install in one click.

Endpointhttps://x402-gateway.forge-x402.workers.dev/mcp
Copy install command
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.

Tools

Details

From the project 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

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

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)

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.