# BridgeNode MCP

> BridgeNode MCP is a freemium MCP server for ai models and llm tooling. Pay-per-request LLM inference for agents, settled in Solana USDC through x402. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://bridgenode.cc
- **Repository:** https://github.com/bridgenode-ai/bridgenode-mcp
- **MCP Registry name:** io.github.bridgenode-ai/bridgenode-mcp
- **Categories:** AI models and LLM tooling
- **Listing updated:** 2026-11-15

## About

This package is a local stdio wrapper around BridgeNode's remote MCP endpoint. When a call returns an HTTP 402 payment request, the wrapper signs the payment with your Solana wallet key and retries, so an agent can buy inference without accounts or API keys. The service also exposes an OpenAI-compatible API.

A fail-closed spending policy checks every payment before signing, with defaults of 0.05 per call and 1.0 per day in environment variables. The wallet key is optional: free models and two free calls to each paid model per client work without one.

Three tools are listed: chat_completions, which accepts OpenAI-style tools and tool_choice and returns tool_calls, list_models and get_price_estimate, the last two free. A Python SDK and CLI are also on PyPI. The package is MIT licensed.

## Features

- **Automatic x402 payment:** Signs and retries when a call needs payment, using Solana USDC.
- **Spending caps:** Per-call and daily limits are checked before any signature.
- **Free tier:** Free models, plus 2 free calls to each paid model per client.
- **OpenAI-style tool calls:** chat_completions accepts tools and tool_choice and passes them through.
- **Price estimates:** Estimate a request's cost before sending it.
- **No keys or registration:** Agents pay with a wallet instead of an account.

## Good for

- Give an agent pay-as-you-go access to several LLMs
- Estimate the cost of a chat request before running it
- Try free models without a wallet
- Cap an agent's inference budget per day

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http bridgenode-mcp https://bridgenode.cc/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://bridgenode.cc/mcp
```

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

```json
{
  "mcpServers": {
    "bridgenode-mcp": {
      "url": "https://bridgenode.cc/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "bridgenode-mcp": {
      "type": "http",
      "url": "https://bridgenode.cc/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "bridgenode-mcp": {
      "serverUrl": "https://bridgenode.cc/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "bridgenode-mcp": {
      "type": "http",
      "url": "https://bridgenode.cc/mcp"
    }
  }
}
```

## Tools

- `chat_completions`: AI inference; free models need no payment and the first 2 calls to a paid model are free per client.
- `list_models`: List available models.
- `get_price_estimate`: Estimate the cost of a chat request.

## FAQ

### Do I need an API key?

No. Free models work without a wallet and paid calls use a Solana wallet via x402.

### How do I limit spending?

Set BRIDGENODE_MAX_PER_CALL (default 0.05) and BRIDGENODE_DAILY_CAP (default 1.0).

### What licence is the wrapper?

MIT.

### Is there a Python option?

Yes, the SDK and CLI are on PyPI as bridgenode-llm and bridgenode-cli.

### Is BridgeNode MCP free?

BridgeNode MCP has a free plan, with paid plans for more usage or features.

### How do I add BridgeNode MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http bridgenode-mcp https://bridgenode.cc/mcp

### What are the best alternatives to BridgeNode MCP?

The closest alternatives to BridgeNode MCP are Claude Code Ultimate Guide, signafAIde, Toolkien, Lugh and HypePaper.

## Alternatives

- [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.
- [signafAIde](https://ai-powered.com/mcp/signafaide): signafAIde is a freemium MCP server for security.
- [Toolkien](https://ai-powered.com/mcp/toolkien): Toolkien is an open-source MCP server for ai models and llm tooling.
- [Lugh](https://ai-powered.com/mcp/lugh): Lugh is an open-source MCP server for ai models and llm tooling.
- [HypePaper](https://ai-powered.com/mcp/hypepaper): HypePaper is a freemium MCP server for ai models and llm tooling.
- [Agent Data Tools: Compact (find, describe, run)](https://ai-powered.com/mcp/agent-data-tools-compact-find-describe-run): Agent Data Tools: Compact (find, describe, run) is a freemium MCP server for developer tools.
- [Angel Agent Guard: pre-purchase check + prompt-injection scan](https://ai-powered.com/mcp/angel-agent-guard-pre-purchase-check-prompt-injection-scan): Angel Agent Guard: pre-purchase check + prompt-injection scan is a freemium MCP server for ai models and llm tooling.
- [Mizan Calibration](https://ai-powered.com/mcp/mizan-calibration): Mizan Calibration is a free MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/bridgenode-mcp
