What is BridgeNode MCP?

BridgeNode — x402 pay-per-request AI inference. OpenAI-compatible API + MCP, Solana USDC, gas-free.

How do I install BridgeNode MCP?

Clone BridgeNode MCP from https://github.com/bridgenode-ai/bridgenode-mcp and configure it as an MCP server in your client (Claude Desktop, Cursor, or VS Code).

Is BridgeNode MCP open source?

Yes, BridgeNode MCP is open source under the MIT-0 license. Source code is available at https://github.com/bridgenode-ai/bridgenode-mcp.

What category does BridgeNode MCP belong to?

BridgeNode MCP is listed under AI & ML MCP servers on MCPFind.

BridgeNode MCP — MCP Server for AI & ML

@bridgenode/mcp

Built for AI agents — no API keys, no registration, pay-as-you-go with Solana USDC via x402. Start free: free models and 2 free calls on paid models per client, no wallet required.

BridgeNode MCP wrapper — stdio MCP server that proxies requests to the remote https://bridgenode.cc/mcp (streamable-HTTP) with automatic x402 payment (Solana USDC). No API keys, no registration.

Installation (one-command)

claude mcp add bridgenode -s user -- npx -y @bridgenode/mcp@latest

Or manually (Claude Code, Cursor, other MCP clients):

{
  "mcpServers": {
    "bridgenode": {
      "command": "npx",
      "args": ["-y", "@bridgenode/mcp@latest"]
    }
  }
}

Configuration (.env)

# Solana wallet private key (base58) — agent's payment wallet
# Optional — Solana wallet private key (base58). Needed only for PAID calls:
# free models and the 2 free trials work without it.
BRIDGENODE_WALLET_KEY=

# Spending policy (fail-closed)
BRIDGENODE_MAX_PER_CALL=0.05
BRIDGENODE_DAILY_CAP=1.0

Tools

chat_completions — AI inference (free models run without payment; the first 2 calls to a PAID model are free per client, then x402 payment is automatic)
list_models — model list (free)
get_price_estimate — estimate cost of a chat request (free)

How it works

Local MCP client launches the wrapper via stdio
Wrapper connects to https://bridgenode.cc/mcp (streamable HTTP)
On tools/call receiving 402 (payment required) — the wrapper automatically signs the payment with BRIDGENODE_WALLET_KEY and retries the request
Spending policy checks every payment BEFORE signing (fail-closed)

Python packages

Prefer Python? The same BridgeNode toolkit is on PyPI:

Python SDK: pip install bridgenode-llm → https://pypi.org/project/bridgenode-llm
CLI: pip install bridgenode-cli → https://pypi.org/project/bridgenode-cli
Full toolkit (SDK + CLI): pip install bridgenode → https://pypi.org/project/bridgenode

Community

Moltbook agent profile: https://moltbook.com/u/bridgenode_eli
Discord: https://discord.gg/HUpVKxJxhG
X (Twitter): https://x.com/eliBNx

⭐ Star this repo — it helps AI agents discover BridgeNode.

Set up in your AI client

AI clientOperating system

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json

{
  "mcpServers": {
    "io-github-bridgenode-ai-bridgenode-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@bridgenode/mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Compatible MCP Clients

BridgeNode MCP works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.

Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.

VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.

Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.

Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

BridgeNode MCP