BridgeNode MCP

io.github.bridgenode-aiPublished by GitHub account bridgenode-aiv1.8.1Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableFinanceAI & ML

Overview

AI-generated overview

BridgeNode MCP gives an assistant OpenAI-compatible chat completions from many models, paid per request in Solana USDC via x402, with free models and trials.

What you can do
  • Send chat completion requests to supported models, including OpenAI-style tools and tool_choice, with tool calls returned
  • List available models and their prices
  • Estimate the USDC cost of a chat request before paying
  • Free models and the first paid-model calls per client run without payment; later calls are paid automatically through x402
When to use it
Useful when an assistant needs model inference without signing up for an API key or account, or when you want pay-per-request pricing with a spending cap instead of a subscription.
Requirements
Runs as a local stdio process via npx (Node.js) that proxies to the remote streamable-HTTP endpoint, or can be used as a remote endpoint. No API keys or registration. Paid calls need a Solana wallet private key in BRIDGENODE_WALLET_KEY, plus optional spending limits BRIDGENODE_MAX_PER_CALL and BRIDGENODE_DAILY_CAP. Network access required.
Before you install
Paid calls spend real Solana USDC; the wrapper signs payments automatically with the wallet key in BRIDGENODE_WALLET_KEY, so that key controls funds and should be a dedicated low-balance wallet. Spending policy defaults are fail-closed but should be set deliberately. Prompts and requests are sent to the third-party BridgeNode service.

Installation

In SourceWeft

  1. Open BridgeNode MCP 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.bridgenode-ai%2Fbridgenode-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": {
    "bridgenode": {
      "type": "http",
      "url": "https://bridgenode.cc/mcp"
    }
  }
}

README

@bridgenode/mcp

[npm version] [npm downloads] [License: MIT-0] [CI] [Website] [BridgeNode on x402-list] [@bridgenode/mcp on AI Agents Listing] [GitHub Stars]

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)

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

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

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

Configuration (.env)

bash
# 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.05BRIDGENODE_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-style tools / tool_choice — the model's answer then carries tool_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

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

Links

Python packages

Prefer Python? The same BridgeNode toolkit is on PyPI:

Community

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

Source: README.md at commit a0cfa36

Tools

3

chat_completions

Chat completions with x402 payment

Send a chat completion request to any supported model. Free models are served without payment; the first calls to a PAID model are also free per client (free trials), after which x402 payment (Solana USDC) is required — an unpaid call returns 402 with the exact price; retry with _meta["x402/payment"]. Responses are non-streaming. Pass either mode (auto/eco/premium) or model (explicit id) — one of the two is required; model wins if both are sent. Use this tool to generate text; inspect models and prices first with the free list_models tool. Start with a FREE model (no payment at all) and keep max_tokens >= 200 — a thinking model spends part of that budget on reasoning, so a smaller limit can return an empty answer.

Parametersmodemodeltoolsmessagesrequiredmax_tokenstool_choice

list_models

List available models and prices

List available models and their prices — free, no payment, no authentication required. Read-only: no state changes; data is served from the server's local config, so repeated calls return identical results (idempotent). Accepts no parameters: the input schema is an empty object, and any arguments passed are ignored. Calling it without arguments returns the complete catalog with per-token prices; there is no filtering, pagination, or configuration. Use this tool to inspect models and prices before calling the paid chat_completions tool. Same data as GET /v1/models (§5.2). Do not use it to generate text (use chat_completions) or to estimate a specific request's cost (use get_price_estimate).

Takes no parameters.

get_price_estimate

Estimate the cost of a chat request

Estimate the USDC cost of a chat completion request before paying — free, no payment, no authentication required. Read-only: no state changes and no external calls; the estimate is computed locally from server pricing config, so repeated calls with identical inputs return identical results (idempotent). Use this tool to check the exact price for a given model/mode, messages, and max_tokens before calling the paid chat_completions tool. Provide either mode (auto/eco/premium routing) or model (explicit id, mutually exclusive with mode); one of the two is required — if both are sent, model wins. mode values: auto = cheapest model fitting the context, eco = cheapest available, premium = best model.

Parametersmodemodelmessagesrequiredmax_tokens

Version history

3
  1. v1.8.1LatestOct 11, 2026
  2. v1.7.0Oct 5, 2026
  3. v1.6.0Sep 16, 2026

Score

100% 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
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts