# BridgeNode — Instructions for AI Agents

BridgeNode is an AI inference service for agents: anonymous LLM access without API keys, without registration, without subscriptions. Pay per request with Solana USDC via x402 (HTTP 402). Transaction fees are sponsored — your agent only needs USDC in its own wallet.

## How to use

1. Call the OpenAI-compatible endpoint: `https://bridgenode.cc/v1/chat/completions`
2. First request returns `402 Payment Required` with a `PAYMENT-REQUIRED` header (price, payTo, memo, blockhash).
3. Sign a partial USDC `TransferChecked` + Memo transaction with your wallet, retry with `PAYMENT-SIGNATURE` header.
4. Response: `200` with the completion and `PAYMENT-RESPONSE` settlement receipt.

Use any x402-capable client or the official SDKs — they handle the handshake automatically.

## Models

- Available: gpt-oss-20b, gpt-oss-120b, glm-4.7-flash, glm-4.5-flash, glm-4.6v-flash, deepseek-v4-flash, glm-4.7-flashx, glm-5.2, glm-5.1, glm-5, glm-5-turbo, glm-4.7, glm-4.6, glm-4.5, glm-4.5-x, glm-4.5-air, glm-4.5-airx, glm-4-32b-0414-128k, glm-5v-turbo, glm-4.6v, glm-4.6v-flashx, glm-4.5v, glm-ocr, kimi-k2.7-code, kimi-k2.7-code-highspeed, kimi-k2.6, kimi-k2.5, MiniMax-M2.7, MiniMax-M2.7-highspeed, MiniMax-M2.5, MiniMax-M2.5-highspeed, MiniMax-M2.1, MiniMax-M2.1-highspeed, MiniMax-M2, deepseek-v4-pro, kimi-k3, glm-5.3, minimax-m3
- Live prices: `GET https://bridgenode.cc/v1/models` (single source of truth)
- Pricing: exact scheme — pay for `input tokens + max_tokens` before processing; minimum $0.002 per request

## Endpoints

- OpenAI-compatible: `https://bridgenode.cc/v1`
- MCP (streamable-http): `https://bridgenode.cc/mcp`
- Model list + prices: `https://bridgenode.cc/v1/models`
- Agent install map: `https://bridgenode.cc/llms.txt`
- Full agent guide: `https://bridgenode.cc/llms-full.txt`

## Install

- Python SDK: `pip install bridgenode-llm` — CLI: `pip install bridgenode-cli`
- TypeScript SDK: `npm i @bridgenode/llm` — MCP wrapper: `npm i @bridgenode/mcp`
- Skill: `npx skills add bridgenode-ai/bridgenode-skill`

## Rules

- Check live prices before use; spending limits: `BRIDGENODE_MAX_PER_CALL`, `BRIDGENODE_DAILY_CAP` (fail-closed, client-side)
- Reasoning models: use `max_tokens >= 200` — a too-small limit can produce an EMPTY answer; empty answers are NOT refunded (service provided)
- Refunds: if the provider fails before any content is delivered, the payment is refunded automatically

## More

- Discovery files: `https://bridgenode.cc/.well-known/agent-card.json`, `https://bridgenode.cc/.well-known/mcp.json`, `https://bridgenode.cc/.well-known/ai-manifest.json`, `https://bridgenode.cc/.well-known/api-catalog`
- ClawHub skill: https://clawhub.ai/bridgenode/skills/bridgenode
- Listed on x402-list: https://x402-list.com/services/bridgenode
- Listed on nohumans.directory: https://nohumans.directory/l/f1f74751-9d5
- Listed on gold-402: https://github.com/Haustorium12/gold-402/blob/main/directory/learning.md