Forge Agent Hub

io.github.forge-agent-hubPublished by GitHub account forge-agent-hubv1.3.0Updated Nov 11, 2026

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

VerifiedStreamable HTTPWeb executableFinanceBusiness & Commerce

Overview

AI-generated overview

MCP server wrapping Forge Agent Hub's pay-per-call x402 APIs, letting an assistant list paid endpoints and call them with optional USDC payment on Base.

What you can do
  • List the paid catalog: free listing of tools, prices in USDC on Base and HTTP paths
  • Call paid endpoints: one tool per catalog path, such as IBAN, EU VAT and sanctions checks (about 58)
  • Handle payment: an unpaid call returns an HTTP 402 challenge; with a private key and the payment library set, the server retries with a signed x402 payment
  • Try samples: some wave-1 tools accept a demo flag for labelled sample output
  • Run locally over stdio or local Streamable HTTP, or use the hosted remote gateway
When to use it
Useful when you want an assistant to reach paid data and verification APIs (bank account, VAT, sanctions and similar lookups) without building your own client, especially if you are willing to pay per call in USDC on Base.
Requirements
Either the hosted remote endpoint (Streamable HTTP) or a local clone run with Node 20+ and npm install; the package is not on npm. Optional environment variables: API_BASE, EVM_PRIVATE_KEY for automatic payment, and PORT for local HTTP mode.
Before you install
Automatic payment requires EVM_PRIVATE_KEY, a wallet private key that can spend funds; keep it out of version control and only enable it deliberately. Paid calls cost USDC on Base, and the first few free calls per IP per day are limited. Calls send your query data to a third-party gateway.

Installation

In SourceWeft

  1. Open Forge Agent Hub in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.forge-agent-hub%2Fforge-agent-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

Source: README.md at commit 2d0ed4c

Tools

0
SourceWeft has not read this server's tools yet.

Version history

1
  1. v1.3.0LatestNov 11, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts