Back to Browse

Forge Agent MCP Server

Developer ToolsUse Caution3.5MCP RegistryRemote
Free

Server data from the Official MCP Registry

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

About

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

Remote endpoints: streamable-http: https://x402-gateway.forge-x402.workers.dev/mcp

Security Report

3.5
Use Caution3.5High Risk

The server is a straightforward MCP wrapper that forwards tool arguments as query parameters to x402 API hosts and reads its payment key from an environment variable, with no hardcoded secrets or shell execution. The main concerns are the Streamable HTTP mode, which sends a wildcard CORS header on a server with no authentication, letting any web page in the user's browser invoke paid tools, and automatic payment signing with no spending cap. The hosts in tools.json were not provided, so their trustworthiness could not be verified. Supply chain analysis found 6 known vulnerabilities in dependencies (0 critical, 4 high severity).

3 files analyzed · 11 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Found in Source Code

Found by scanning the linked source code. This listing connects to a hosted endpoint, so none of this runs on your machine: it describes what the server software does where it is hosted.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Applies to the server that hosts this plugin, not to your machine.

File System Read

Reads files on the server that hosts it, not on your machine.

crypto_signing

Applies to the server that hosts this plugin, not to your machine.

How to Connect

Remote Plugin

No local installation needed. Your AI client connects to the remote endpoint directly.

Add this to your MCP configuration to connect:

{
  "mcpServers": {
    "io-github-forge-agent-hub-forge-agent-mcp": {
      "url": "https://x402-gateway.forge-x402.workers.dev/mcp"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub 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: 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 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)

Reviews

No reviews yet

Be the first to review this server!