Skip to main content
Glama
@bridgenode/mcp

@bridgenode/mcp

Official

@bridgenode/mcp

npm version npm downloads License: MIT-0 CI Website BridgeNode on x402-list

AI 에이전트를 위해 제작 — API 키 불필요, 회원가입 불필요, x402를 통한 Solana USDC 종량제 결제.

BridgeNode MCP 래퍼 — 원격 https://bridgenode.cc/mcp(streamable-HTTP)로 요청을 프록시하는 stdio MCP 서버로, 자동 x402 결제(Solana USDC)를 지원합니다. API 키가 필요 없고 회원가입도 필요 없습니다.

도구 설치 (원커맨드)

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

또는 수동으로 설치 (Claude Code, Cursor, 기타 MCP 클라이언트):

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

Related MCP server: @hpp-io/x402-mcp-bridge

설정 지원 (.env)

# Solana wallet private key (base58) — agent's payment wallet
BRIDGENODE_WALLET_KEY=

# Spending policy (fail-closed)
BRIDGENODE_MAX_PER_CALL=0.05
BRIDGENODE_DAILY_CAP=1.0

도구

  • chat_completions — AI 추론 지원 (유료; x402 결제 자동)

  • list_models — 모델 목록 (무료)

  • get_price_estimate — 채팅 요청 비용 견적 (무료)

작동 보

  1. 로컬 MCP 클라이언트가 stdio를 통해 래퍼를 실행합니다.

  2. 래퍼가 https://bridgenode.cc/mcp(streamable HTTP)에 연결합니다.

  3. tools/call이 402(결제 필요)를 받으면 — 래퍼가 BRIDGENODE_WALLET_KEY로 결제를 자동 서명하고 요청을 다시 시도합니다.

  4. 결제 정책이 서명 전에 모든 결제를 검사합니다 (실패 시 차단).

링크

Python 패키지

Python을 더 선호하시나요? 동일한 BridgeNode 툴킷을 PyPI에서 사용할 수 있습니다:

커뮤니티

Available Tools

3 tools
chat_completionsChat completions with x402 paymentAInspect

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.

Inputs: messages (required), mode, model, tools, +2 more. Returns: id, model, usage, object, +2 more

get_price_estimateEstimate the cost of a chat requestA
Read-onlyIdempotent
Inspect

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.

Inputs: messages (required), mode, model, max_tokens. Returns: model, amount_usdc, input_tokens, amount_atomic, +1 more

list_modelsList available models and pricesA
Read-onlyIdempotent
Inspect

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).

Inputs: no named parameters. Returns: data, object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.7/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct role: list_models returns the catalog, get_price_estimate prices a specific request, and chat_completions performs inference. The descriptions explicitly cross-reference each other ('use chat_completions', 'use get_price_estimate'), eliminating any realistic misselection.

    Naming Consistency4/5

    get_price_estimate and list_models follow a clean verb_noun pattern, but chat_completions is a bare noun naming a resource/action endpoint. The deviation is minor and the naming remains predictable and readable.

    Tool Count4/5

    Three tools is lean but plausibly matches the narrow gateway scope: inspect models, estimate cost, generate text. It sits at the low edge of the ideal range, with little redundancy, though it leaves almost no room for ancillary operations.

    Completeness4/5

    The core pay-per-request lifecycle (discover models, price a request, execute) is fully covered, including the 402 payment retry flow. Minor gaps exist: no streaming option, no balance/usage or payment-status tool, and no embeddings or other model modalities.

    Maintenance

    ActivitySlowing
    ResponsivenessMostly unanswered

    Related MCP Connectors

    Related MCP Servers