io.github.BSVKey/inference-mcp is an MCP server published by io.github.BSVKey, hosted at inference.bsvkey.com. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 6 tools, including list_models, infer, channel_balance, open_channel, x402_infer.
Pay-per-token Claude & Grok inference, settled in Bitcoin BSV. npm package or hosted remote.
181 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
No parameters.
{
"name": "list_models",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
}
}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: <code> (<http status>): <message>". 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.
| Parameter | Type | Description |
|---|---|---|
| model | string | Model id or policy: auto|cheapest|best, claude-*, grok-*. |
| apiKey | string | channelId:channelSecret for a funded channel. Omit to use the Authorization header (preferred). |
| prompt * | string | The user prompt. |
| system | string | Optional system prompt. |
| maxTokens | integer | Max output tokens. |
| webSearch | boolean | Let the model search the live web (adds a per-search fee). |
{
"name": "infer",
"description": "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: <code> (<http status>): <message>\". 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.",
"inputSchema": {
"type": "object",
"required": [
"prompt"
],
"properties": {
"model": {
"type": "string",
"default": "auto",
"description": "Model id or policy: auto|cheapest|best, claude-*, grok-*."
},
"apiKey": {
"type": "string",
"description": "channelId:channelSecret for a funded channel. Omit to use the Authorization header (preferred)."
},
"prompt": {
"type": "string",
"description": "The user prompt."
},
"system": {
"type": "string",
"description": "Optional system prompt."
},
"maxTokens": {
"type": "integer",
"default": 512,
"description": "Max output tokens."
},
"webSearch": {
"type": "boolean",
"default": false,
"description": "Let the model search the live web (adds a per-search fee)."
}
},
"additionalProperties": false
}
}Check a prepaid channel’s remaining Bitcoin BSV balance, spend, and request count. Uses the Authorization header or apiKey. On failure returns isError "error: <code> (<status>): <message>": no_channel_key, or invalid_channel (401/404: not found, bad secret, or closed).
| Parameter | Type | Description |
|---|---|---|
| apiKey | string | channelId:channelSecret. Omit to use the Authorization header (preferred). |
{
"name": "channel_balance",
"description": "Check a prepaid channel’s remaining Bitcoin BSV balance, spend, and request count. Uses the Authorization header or apiKey. On failure returns isError \"error: <code> (<status>): <message>\": no_channel_key, or invalid_channel (401/404: not found, bad secret, or closed).",
"inputSchema": {
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "channelId:channelSecret. Omit to use the Authorization header (preferred)."
}
},
"additionalProperties": false
}
}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).
No parameters.
{
"name": "open_channel",
"description": "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).",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
}
}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: <code> (<status>): <message>". 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).
| Parameter | Type | Description |
|---|---|---|
| model | string | Model id or policy: auto|cheapest|best, claude-*, grok-*. |
| prompt * | string | The user prompt. |
| system | string | Optional system prompt. |
| payment | string | The base64 X-PAYMENT header value your wallet signed for the quote from step 1. Omit to get the quote. |
| maxTokens | integer | Max output tokens. |
| webSearch | boolean | Let the model search the live web (adds a per-search fee to the quote). |
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":<from quote>,"payload":{"txBlob":<signed blob>,"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: <code> (<status>): <message>". 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).
| Parameter | Type | Description |
|---|---|---|
| model | string | Model id or policy: auto|cheapest|best, claude-*, grok-*. |
| prompt * | string | The user prompt. |
| system | string | Optional system prompt. |
| payment | string | The base64 X-PAYMENT value carrying your signed XRP Payment for the quote from step 1. Omit to get the quote. |
| maxTokens | integer | Max output tokens. |
Buy Claude and Grok inference metered per token, settled in Bitcoin BSV. list_models and open_channel are free. infer and channel_balance need a prepaid channel key sent as "Authorization: Bearer channelId:channelSecret" (fund one at https://inference.bsvkey.com). x402_infer (Bitcoin BSV) and xrp_infer (XRP) pay per call with no channel: call once for the quote, sign it in your own wallet, call again with payment. This server never takes a private key.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"name": "x402_infer",
"description": "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: <code> (<status>): <message>\". 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).",
"inputSchema": {
"type": "object",
"required": [
"prompt"
],
"properties": {
"model": {
"type": "string",
"default": "grok-4.3",
"description": "Model id or policy: auto|cheapest|best, claude-*, grok-*."
},
"prompt": {
"type": "string",
"description": "The user prompt."
},
"system": {
"type": "string",
"description": "Optional system prompt."
},
"payment": {
"type": "string",
"description": "The base64 X-PAYMENT header value your wallet signed for the quote from step 1. Omit to get the quote."
},
"maxTokens": {
"type": "integer",
"default": 512,
"description": "Max output tokens."
},
"webSearch": {
"type": "boolean",
"default": false,
"description": "Let the model search the live web (adds a per-search fee to the quote)."
}
},
"additionalProperties": false
}
}{
"name": "xrp_infer",
"description": "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\":<from quote>,\"payload\":{\"txBlob\":<signed blob>,\"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: <code> (<status>): <message>\". 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).",
"inputSchema": {
"type": "object",
"required": [
"prompt"
],
"properties": {
"model": {
"type": "string",
"default": "claude-haiku-4-5",
"description": "Model id or policy: auto|cheapest|best, claude-*, grok-*."
},
"prompt": {
"type": "string",
"description": "The user prompt."
},
"system": {
"type": "string",
"description": "Optional system prompt."
},
"payment": {
"type": "string",
"description": "The base64 X-PAYMENT value carrying your signed XRP Payment for the quote from step 1. Omit to get the quote."
},
"maxTokens": {
"type": "integer",
"default": 512,
"description": "Max output tokens."
}
},
"additionalProperties": false
}
}