About BridgeNode MCP
BridgeNode MCP is a stdio wrapper for AI agents that routes inference requests to BridgeNode’s remote service. It offers free model discovery and cost estimates, with automatic Solana USDC x402 payments for paid calls.
Key features
- 01OpenAI-style chat inference
- 02List available models
- 03Estimate request costs
- 04Automatic x402 payment
- 05Per-call and daily spending limits
Use cases
- 01Run chat inference from an MCP client
- 02Compare models before making a request
- 03Pay automatically for paid inference
MCP support
It exposes BridgeNode inference through a local stdio MCP server that proxies to the remote streamable-HTTP endpoint. For paid calls, it signs x402 payments using a Solana wallet and checks spending limits before signing.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://bridgenode.cc/mcpclaude mcp add --transport http bridgenode-ai-bridgenode https://bridgenode.cc/mcp{"mcpServers":{"bridgenode-ai-bridgenode":{"type":"http","url":"https://bridgenode.cc/mcp"}}}Open in Cursor{"servers":{"bridgenode-ai-bridgenode":{"type":"http","url":"https://bridgenode.cc/mcp"}}}Open in VS Code{"mcpServers":{"bridgenode-ai-bridgenode":{"type":"http","url":"https://bridgenode.cc/mcp"}}}{"mcpServers":{"bridgenode-ai-bridgenode":{"serverUrl":"https://bridgenode.cc/mcp"}}}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
3| Parameter | Type | Required | Description |
|---|---|---|---|
| mode | enum | No | Smart routing profile (auto/eco/premium).auto | eco | premium |
| model | string | No | Explicit model id (see list_models / /v1/models). Mutually exclusive with mode. |
| tools | array | No | OpenAI-style tool schemas the model may call. Forwarded unchanged; they count as input tokens for the price (§4.2/§5.3). |
| messages | array | Yes | Chat messages (text content only). An assistant turn that calls a tool may carry content: null with tool_calls. |
| max_tokens | integer | No | Max output tokens (billed upfront, §4.2). MCP calls are non-stream: cap per config. Use >= 200 — reasoning models share this budget with their thinking and a smaller limit can return an empty answer. |
| tool_choice | string|object | No | OpenAI tool_choice: 'auto', 'none', 'required', or {type: function, function: {name}}. |
Details
From the project README@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). Accepts OpenAI-styletools/tool_choice— the model's answer then carriestool_calls(the wrapper passes arguments through unchanged)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/callreceiving 402 (payment required) — the wrapper automatically signs the payment withBRIDGENODE_WALLET_KEYand retries the request - Spending policy checks every payment BEFORE signing (fail-closed)
Links
- Website: https://bridgenode.cc
- Protocol: x402 V2 (docs.x402.org)
- npm: https://www.npmjs.com/package/@bridgenode/mcp
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.
Comments
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.