# ForgeMesh Utility Grid MCP

> ForgeMesh Utility Grid MCP is a paid MCP server for developer tools. Search 400+ pay-per-call APIs for free and call them with USDC micropayments on Base. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** CLI, API
- **Website:** https://x402.forgemesh.io
- **Repository:** https://github.com/forgemeshlabs/utility-grid-mcp
- **MCP Registry name:** io.github.forgemeshlabs/utility-grid-mcp
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

Rather than listing one tool per API, this local server exposes seven compact meta-tools so an agent can browse a large catalog without bloating its context. Discovery is free: list every route with its live price, summarise categories, search by keyword and fetch an exact input schema with worked examples. Calling a route then goes through one generic tool that handles the x402 payment handshake.

The catalog spans OCR and vision, audio, PDFs, web extraction, geodata, math, time, space data, dictionary and Bible lookups, QR codes and hashing, and novelty endpoints such as fortunes. The site also lists a post-quantum TLS readiness check for $0.05. Prices run from $0.005 to $0.05 per call, paid in USDC on Base with no account or API key.

A wallet private key is needed only for the three paid tools. The README advises a dedicated, low-balance wallet, and the server refuses to sign for any payee beyond the two Utility Grid wallets, any network but Base mainnet, any asset but USDC or any amount over $0.05 a call or $10 a session; environment variables can only lower those caps.

## Features

- **Free catalog search:** Browse, search and read exact specs without a wallet.
- **Seven meta-tools:** A handful of tools instead of hundreds.
- **Pay per call:** $0.005 to $0.05 in USDC via x402.
- **Spending caps:** Per-call and per-session limits that can only be lowered.
- **Live catalog:** New routes appear without changes to the server.
- **No accounts:** No API keys or subscriptions.

## Good for

- Let an agent find a fitting utility API by keyword
- Run OCR on a receipt image and pay per call
- Look up airport or timezone data
- Budget an agent's paid API use with hard caps

## Install

### Claude Code (Terminal)

```sh
claude mcp add utility-grid-mcp --env WALLET_PRIVATE_KEY='<WALLET_PRIVATE_KEY>' -- npx -y @forgemeshlabs/utility-grid-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "utility-grid-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@forgemeshlabs/utility-grid-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "utility-grid-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@forgemeshlabs/utility-grid-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "utility-grid-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@forgemeshlabs/utility-grid-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "utility-grid-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@forgemeshlabs/utility-grid-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "utility-grid-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@forgemeshlabs/utility-grid-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

## Tools

- `list_tools`: Lists every route with its live price and a per-category summary; free.
- `list_capabilities`: Shows category counts or every route in one category; free.
- `search_capabilities`: Keyword search across route paths, ids and descriptions; free.
- `get_endpoint_spec`: Returns a route's price, input schema and worked examples; free.
- `call_endpoint`: Calls any route by path and JSON body, handling x402 payment.
- `daily_402`: Returns one featured endpoint rotated by UTC date, $0.005.
- `agent_service_directory`: Lists the ForgeMesh x402 services, $0.05.

## FAQ

### Do I need a wallet?

Only for the three paid tools; the discovery tools work without one.

### What does a call cost?

Between $0.005 and $0.05 in USDC on Base.

### What stops overspending?

Caps of $0.05 per call and $10 per session that env variables can only lower, plus payee, network and asset checks.

### What do I need to run it?

Node.js 20 or later; start it with npx -y @forgemeshlabs/utility-grid-mcp.

### Is ForgeMesh Utility Grid MCP free?

No. ForgeMesh Utility Grid MCP is a paid product.

### How do I add ForgeMesh Utility Grid MCP to Claude Code?

Run this command in your terminal: claude mcp add utility-grid-mcp --env WALLET_PRIVATE_KEY='<WALLET_PRIVATE_KEY>' -- npx -y @forgemeshlabs/utility-grid-mcp

### What are the best alternatives to ForgeMesh Utility Grid MCP?

The closest alternatives to ForgeMesh Utility Grid MCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/forgemesh-utility-grid-mcp
