inference-mcp
Server Details
Pay-per-token Claude & Grok inference, settled in Bitcoin BSV. npm package or hosted remote.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- BSVKey/inference-mcp
- GitHub Stars
- 0
- Server Listing
- @bsvkey/inference-mcp
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 6 tools
The three inference tools (infer, x402_infer, xrp_infer) share the same core action and are separated only by payment rail, but the descriptions make the prerequisites and payment models explicit enough for an agent to pick correctly. open_channel is also documentation-as-tool rather than an action, which could momentarily confuse an agent expecting a real operation.
Conventions are mixed: verb_noun (list_models, open_channel), noun_verb (channel_balance), and bare/prefix-verb (infer, x402_infer, xrp_infer). The names are still self-descriptive and readable, but there is no predictable pattern across the set.
Six tools is a well-scoped surface for a metered inference gateway with two payment rails. open_channel is arguably filler since it only explains a website flow, but the rest each earn their place.
Discovery (list_models), funding guidance (open_channel), balance/usage (channel_balance), and inference on two rails are all covered, closing the main agent loop. Minor gaps: no tool to list past receipts/usage history, close or top up a channel programmatically, and receipt verification is deferred to an external client library.
Available Tools
6 toolschannel_balanceAInspect
Check a prepaid channel’s remaining Bitcoin BSV balance, spend, and request count. Uses the Authorization header or apiKey. On failure returns isError "error: (): ": no_channel_key, or invalid_channel (401/404: not found, bad secret, or closed).
Inputs: apiKey.
inferAInspect
Run one metered inference (OpenAI-compatible), paid per token in Bitcoin BSV from your prepaid channel. Returns the completion plus a receipt: satoshis charged, model routed to, remaining balance, and the broker-signed usage receipt. Needs a funded channel key: send the HTTP header "Authorization: Bearer channelId:channelSecret" with the MCP request, or pass apiKey. Thinking models (claude-sonnet-5, claude-opus-5, claude-opus-5-5, claude-fable-5-1) bill their hidden reasoning as output, and maxTokens is raised to at least 1024 for them. On failure the tool returns isError with text "error: (): ". Codes: no_channel_key (no Authorization header and no apiKey); invalid_channel (401: channel not found, bad secret, or closed; open a new one); insufficient_balance (402: the channel cannot cover the worst case for this call; the text includes requiredSats and balanceSats; top up at the website, or lower maxTokens / turn off webSearch); invalid_request (400: unknown model or policy, a model whose provider is not enabled, or a malformed prompt; call list_models); upstream_failed (502: the model provider failed; nothing is charged, retry or pick another model). Nothing is charged on any error. This server does not verify its own receipt: check usageReceipt offline with @bsvkey/x402-bsv-client (verifyReceipt, verifyCharge, verifyMeter) against the key at /v1/receipt-key.
Inputs: prompt (required), model, apiKey, system, +2 more.
list_modelsAInspect
List the models this BSV inference gateway sells, with LIVE retail price (satoshis per 1,000 tokens) at the current BSV/USD rate. No key needed. Call first to choose a model.
Inputs: no named parameters.
open_channelAInspect
Explains how to open + fund a prepaid channel. Funding is a real Bitcoin BSV payment signed by a wallet, so it is done once at the website; you then send the returned channel key as "Authorization: Bearer channelId:channelSecret" (or pass it as apiKey).
Inputs: no named parameters.
x402_inferAInspect
Run one inference paid PER CALL in Bitcoin BSV via x402, no prepaid channel. Non-custodial, two steps: (1) call without payment to get the 402 quote (status payment_required, accepts[]); nothing is spent. (2) Build and sign a BSV payment for that quote in your own wallet (for example fetchWithX402 / buildPayment in @bsvkey/x402-bsv-client) and call again with the same prompt, model, maxTokens and webSearch plus payment = the base64 X-PAYMENT value. Returns the completion plus the on-chain settlement txid. This server never takes a private key: a wif argument is refused. On failure returns isError "error: (): ". Codes: key_refused (a private key was sent; it was not used or forwarded); payment_failed (402: the payment did not settle; nothing is spent); invalid_request (400: unknown model or bad input; nothing is spent); upstream_failed (502: the payment SETTLED but the model provider then failed; the text includes the settlement txid. There is no automatic refund: contact embryospace@gmail.com with that txid).
Inputs: prompt (required), model, system, payment, +2 more.
xrp_inferAInspect
Run one inference paid PER CALL in XRP on the XRP Ledger via x402, no channel. Non-custodial, two steps: (1) call without payment to get the 402 quote (exact drops, destination, destination tag, signed quote; priced from the XRP Ledger's own XRP/RLUSD market); nothing is spent. (2) Sign one XRP Payment for exactly that in your own wallet and call again with the same prompt, model and maxTokens plus payment = base64 of {"x402Version":1,"scheme":"exact","network":,"payload":{"txBlob":,"quote":<accepts[0].extra.quote>}}. The broker checks the payment before broadcasting it, waits for validation (a few seconds), and returns the completion, the settlement tx hash, and a signed receipt. This server never takes a wallet seed: an xrpSeed argument is refused. On failure returns isError "error: (): ". Codes: key_refused; pending (202: submitted but not validated yet; call again with the same payment); payment_failed (402: the payment was refused before broadcast or did not settle; nothing is spent unless the text includes a settlement tx); invalid_request (400); upstream_failed (502: the payment SETTLED but the model provider then failed; the text includes the settlement tx. No automatic refund: contact embryospace@gmail.com with it).
Inputs: prompt (required), model, system, payment, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Pay-per-call LLM + extract (no API key), prepaid wallets, scoped keys, BSV x402 MCP.
Ask Claude, GPT, Grok, GLM, Kimi or DeepSeek from your client; token price plus a $0.001 call fee.
Ask Claude, GPT, Grok, GLM, Kimi or DeepSeek from your client; token price plus a $0.001 call fee.
GPT, Claude, Gemini, DeepSeek, Grok, Qwen and GLM through one API key. Pay per token.
Related MCP Servers
- AlicenseAqualityBmaintenancePay-per-request AI with Bitcoin Lightning: Claude, GPT, Gemini, DeepSeek, Mistral and more. Load a prepaid spend token, no account or provider API keys. You only pay for successful calls.5122 npm2MIT
- AlicenseAqualityBmaintenancePay-per-call Claude and GPT models with prepaid USDC on Solana. Sign in once with your wallet and use a capped solx_ token. You only pay for successful calls.5294 npmMIT
- AlicenseNot gradedqualityDmaintenanceOpenAI-compatible inference broker that routes AI requests to the cheapest qualifying model and settles payments per token in USDC on Base L2 via x402 micropayments.MIT
- FlicenseAqualityBmaintenanceEnables LLMs to read and write the BSV social graph with an on-chain identity, OS-keychain wallet, and 38 tools for posts, replies, follows, messages, payments, profiles, and more, with every write broadcast as a real BSV mainnet transaction visible across 50+ shared apps.4214 npm1-
Glama MCP Gateway
Add one secure layer between your agents and this server.