What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

BridgeNode — x402 pay-per-request LLM inference for AI agents (Solana USDC)

BridgeNode — anonymous pay-per-request LLM inference for AI agents without API keys or registration. OpenAI-compatible chat completions endpoint + MCP access...

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.9k

Updated

Oct 9, 2026

Version

1.0.36

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.9K downloads reported by the source. Last updated 10/9/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 9, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 9, 2026
Adoption signal: 1.9K downloadsadoption · observed Oct 9, 2026
Latest release: 1.0.36release · observed Sep 23, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s171becd4jxw36qz2j3atmxh2s8ce8jx:bridgenode

Install using `clawhub skill install s171becd4jxw36qz2j3atmxh2s8ce8jx:bridgenode` in an isolated environment before connecting it to live workloads.
No published capability contract is available yet, so validate auth and request/response behavior manually.
Review the upstream CLAWHUB listing at https://clawhub.ai/bridgenode/bridgenode before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-bridgenode-bridgenode/snapshot"

Documentation

CLAWHUB

157,491 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: bridgenode
version: 1.0.16
description: BridgeNode — x402 pay-per-request AI inference for agents. OpenAI-compatible API + MCP server with tool calling, Solana USDC, gas-free micropayments. No API keys. Free models included. Live prices: bridgenode.cc/v1/models Use when an agent lacks a provider API key or wants privacy-preserving per-request AI inference pricing.
metadata:
  author: BridgeNode
  version: "1.0.16"
  url: https://bridgenode.cc
  repository: https://github.com/bridgenode-ai/bridgenode-skill
  network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
  currency: USDC
  openclaw:
    emoji: "⚡"
    homepage: https://bridgenode.cc
compatibility: Any OpenAI-compatible agent with x402 payment support; MCP clients (streamable-http)
---

# BridgeNode

## Overview (natural language)

BridgeNode is an AI inference service for agents: anonymous LLM access without API keys, without registration, without subscriptions. Agents get an OpenAI-compatible chat completions endpoint and pay as they go with Solana USDC micropayments via the x402 payment protocol (HTTP 402). Model prices are published per token on the public models endpoint; transaction fees are sponsored, so an agent only needs USDC in its own wallet. Works with any OpenAI-compatible agent, MCP clients, and x402-capable SDKs.


## Free access (start here — no payment, no wallet)

- **Free models** (`gpt-oss-20b, gpt-oss-120b, glm-4.7-flash, glm-4.5-flash, glm-4.6v-flash`) are served without payment: no 402, no wallet, no gas. Same endpoint, same request body.

**Free model notes (read before choosing one):**
- `glm-4.7-flash` — ⚠️ **temporarily unreliable**: z.ai free model: slower than the Groq free models — a reply can take up to a minute, and the provider is sometimes overloaded. If it returns an error (rate limit / temporarily overloaded), retry once or switch to gpt-oss-20b, the most reliable free model.
- `glm-4.5-flash` — ⚠️ **temporarily unreliable**: z.ai free model: slower than the Groq free models — a reply can take up to a minute, and the provider is sometimes overloaded. If it returns an error (rate limit / temporarily overloaded), retry once or switch to gpt-oss-20b, the most reliable free model.
- `glm-4.6v-flash`: z.ai free model: slower than the Groq free models — a reply can take up to a minute, and the provider is sometimes overloaded. If it returns an error (rate limit / temporarily overloaded), retry once or switch to gpt-oss-20b, the most reliable free model.
- **Free trials:** a client that has never called us gets **2 free calls on PAID models** without payment — real inference from a real model before any wallet exists. The remaining count travels in the response headers (`X-Bridgenode-Free-Trials-Remaining`).
- When the trials are used up, the third call returns **402** with a machine-readable offer in `extensions.bridgenode` (free models, trials left, `how_to_pay`, `docs`) — not a dead end.
- Check the live list: `GET https://bridgenode.cc/v1/models` (`"fre

examples/curl/README.md

# BridgeNode curl example

Manual x402 flow with curl. This shows the protocol steps; for automatic
payment handling use [x402curl](https://github.com/second-state/x402-skill)
(drop-in curl replacement) or the SDK examples.

> ⚠️ Mainnet warning: Solana mainnet, real USDC. Minimum charge: $0.002.
> Check the 402 `amount` before signing.

## Step 1 — Request, get 402

```bash
curl -sS -D - -o /dev/null https://bridgenode.cc/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4-flash","messages":[{"role":"user","content":"hello"}],"max_tokens":100}'
```

Expected: `HTTP/1.1 402 Payment Required` with a `PAYMENT-REQUIRED` header
(base64 JSON: scheme, network, amount, asset, payTo, memo, feePayer).

## Step 2 — Sign the partial transaction

Decode the `PAYMENT-REQUIRED` header and sign a partial transaction:
USDC `TransferChecked` (amount from the 402) + Memo instruction, signed with
the agent's Solana keypair. The fee payer is NOT signed by the agent —
BridgeNode sponsors gas.

Use any x402-capable signer: `x402curl`, the official SDKs (`x402[svm,httpx]`,
`@x402/svm`), or the Solana `pay` CLI. This produces a base64 JSON payload
(`x402Version`, `resource`, `accepted`, `payload.transaction`).

## Step 3 — Retry with PAYMENT-SIGNATURE

```bash
PAYLOAD="<base64 JSON from step 2>"
curl -sS https://bridgenode.cc/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "PAYMENT-SIGNATURE: $PAYLOAD" \
  -d '{"model":"deepseek-v4-flash","messages":[{"role":"user","content":"hello"}],"max_tokens":100}'
```

Expected: `200 OK` with the completion and a `PAYMENT-RESPONSE` header
(settlement receipt).

## Automatic alternative — x402curl

```bash
# install: https://github.com/second-state/x402-skill
# config: X402_PRIVATE_KEY=... (agent's Solana keypair)
x402curl -sS https://bridgenode.cc/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4-flash","messages":[{"role":"user","content":"hello"}],"max_tokens":100}'
```

x402curl detects the 402, signs the payment, and retries automatically.

## Expected output (Step 1)

```
HTTP/2 402
payment-required: <base64 JSON — scheme, network, amount, asset, payTo, memo, feePayer, recentBlockhash>
{"x402Version":2,"error":"PAYMENT-SIGNATURE header is required","resource":{...},"accepts":[{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","amount":"2000","payTo":"<BridgeNode wallet>","maxTimeoutSeconds":30,"extra":{...}}]}
```

## Expected output (Step 3, after signing)

```
HTTP/2 200
payment-response: <base64 JSON — SettlementResponse: success, payer, transaction, network, amount>
{"id":"...","object":"chat.completion","model":"deepseek-v4-flash","choices":[...],"usage":{...}}
```

- The exact `amount` comes from the 402 response (minimum charge: 2000 atomic units = $0.002).
- Live prices always: `GET https://bridgenode.cc/v1/models`.

## Troubleshooting

- **`402` ins

examples/mcp/README.md

# BridgeNode MCP example

Call BridgeNode through its MCP server with x402 payment.

## Server

- URL: `https://bridgenode.cc/mcp` (streamable-http)
- Tool: `chat_completions` (model | mode, messages, max_tokens)
- Payment: x402 handshake per tool call (via `_meta["x402/payment"]`)

Prices are annotated in `tools/list` (`x-x402`) as an indication; the actual
amount is in the 402 response — always check it before signing.

## Option A — one-command wrapper (any MCP client)

```bash
npx -y @bridgenode/mcp@latest
```

Use this as the MCP server command in your client (Claude Code, Cursor,
Windsurf, etc.). The wrapper connects to `https://bridgenode.cc/mcp` and
handles x402 payment automatically with the agent's wallet.

Claude Code example:

```bash
claude mcp add bridgenode -- npx -y @bridgenode/mcp@latest
```

## Option B — direct streamable-http

Configure your MCP client with:

```
URL: https://bridgenode.cc/mcp
Transport: streamable-http
```

## What the agent sees

1. `tools/list` → `chat_completions` with `x-x402` price annotation.
2. `tools/call` → server returns payment required (result with
   `structuredContent` PaymentRequired object).
3. Client signs the USDC transaction, retries the call with
   `_meta["x402/payment"]`.
4. Server settles, runs inference, returns the completion with
   `_meta["x402/payment-response"]` (settlement receipt).

## Expected output (`tools/list`)

```json
{"result":{"tools":[{"name":"chat_completions","title":"Chat completions with x402 payment","description":"Send a chat completion request to any supported model. Paid tool: x402 payment (Solana USDC) is required — the first call returns 402 with the exact price; retry with _meta[\"x402/payment\"]. ...","inputSchema":{...},"x-x402":{"scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","amount":"2000","asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","payTo":"<BridgeNode wallet>"}}]}}
```

- The `x-x402` amount is **indicative** (floor); the exact amount is in the 402 response — always check it before signing.

## Troubleshooting

- **`tools/call` returns payment required** — expected on the first call; that is the x402 challenge, not an error.
- **Client can't connect** — use the one-command wrapper (`npx -y @bridgenode/mcp@latest`) or point the client at `https://bridgenode.cc/mcp` with `streamable-http`.
- **`503 Service busy`** — retry with backoff.
- **Empty answer from reasoning models** — use `max_tokens >= 200`.

## Notes

- Solana mainnet, real USDC. Minimum charge: $0.002 per request.
- Gas sponsored by BridgeNode — the agent only needs USDC, no SOL.
- Free tools (e.g., model list) skip payment.

examples/python/README.md

# BridgeNode Python example

Buyer-side example: AI agent pays for and calls BridgeNode with the official
x402 Python SDK (`x402[svm,httpx]`).

## Setup

```bash
pip install "x402[svm,httpx]" "solana==0.39.0" python-dotenv
cp .env.example .env
# fill SVM_PRIVATE_KEY (agent's Solana keypair, must have USDC ATA)
```

## Run

```bash
python main.py
```

## What it does

1. `GET /v1/models` — free, lists models and prices.
2. `POST /v1/chat/completions` — x402 payment handled automatically:
   request → 402 → sign partial TX (USDC TransferChecked + Memo) →
   retry with `PAYMENT-SIGNATURE` → 200 + `PAYMENT-RESPONSE`.

## Expected output

```
Initialized SVM account: <your wallet address>
Models & prices: {"object":"list","data":[{"id":"deepseek-v4-flash","pricing":{"prompt":2e-07,"completion":4e-07},...}]}

POST https://bridgenode.cc/v1/chat/completions
Status: 200
Body: {"id":"...","object":"chat.completion","model":"deepseek-v4-flash","choices":[...],"usage":{...}}

Payment response: {
  "success": true,
  "payer": "<your wallet address>",
  "transaction": "<signature>",
  "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
  "amount": "2000"
}
```

- The exact `amount` comes from the 402 response (minimum charge: 2000 atomic units = $0.002).
- Live prices always: `GET https://bridgenode.cc/v1/models`.

## Troubleshooting

- **`SVM_PRIVATE_KEY missing`** — copy `.env.example` to `.env` and fill in the keypair.
- **`InsufficientFunds` / payment rejected** — the wallet needs a USDC ATA with balance on Solana mainnet.
- **`Invalid account`** — the agent must have an existing USDC ATA (it is derived from the wallet address automatically when funded).
- **`402` spam / timeout** — the server rate-limits 402 responses per IP; wait a moment and retry.
- **Empty answer from reasoning models** — use `max_tokens >= 200`; too-small limits can produce an empty response (service was provided, no refund).

## Notes

- Solana mainnet, real USDC. Minimum charge: $0.002 per request.
- Gas is sponsored by BridgeNode — the agent only needs USDC, no SOL.
- The agent must have an existing USDC ATA (associated token account).
- Funding: send USDC on Solana mainnet to the agent's own wallet — BridgeNode never holds balances; every request is paid individually via x402 (exact amount in the 402 response). The USDC ATA is derived from the agent's wallet address; no manual token account setup needed.

examples/README.md

# BridgeNode Examples

Buyer-side examples: how an AI agent pays for and calls BridgeNode via x402.

All examples are **client-side only** — they use the public x402 SDKs and the
public BridgeNode endpoint (`https://bridgenode.cc/v1`). No server code.

> ⚠️ **Mainnet warning:** BridgeNode runs on Solana mainnet with real USDC.
> Use a wallet with a small balance. Minimum charge per request: $0.002 USDC.
> Check the 402 `amount` before signing.

## Contents

| Example | Stack | What it shows |
|---|---|---|
| [curl/](curl/README.md) | curl + x402curl | Manual x402 flow: request → 402 → sign → retry |
| [python/](python/README.md) | Python + `x402[svm,httpx]` | OpenAI-compatible call with automatic payment |
| [typescript/](typescript/README.md) | TypeScript + `@x402/svm` | Fetch wrapper with automatic payment |
| [mcp/](mcp/README.md) | MCP client | Paid tool call through the BridgeNode MCP server |

## Flow (x402 V2, exact scheme)

1. `POST /v1/chat/completions` without payment → server responds `402` with a
   `PAYMENT-REQUIRED` header (base64 JSON: amount, payTo, memo).
2. Client signs a partial transaction: USDC `TransferChecked` + Memo.
3. Client retries with `PAYMENT-SIGNATURE` header.
4. Server verifies, settles (gas sponsored by BridgeNode), returns `200` with a
   `PAYMENT-RESPONSE` header (settlement receipt).

Network: `solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp` (mainnet) · Asset: USDC
`EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`

Models and live prices: `GET https://bridgenode.cc/v1/models` (free).

Github ReposUpdated 6h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.