@bsvkey/inference-mcp 1.0.1 → 1.1.0

package/README.md

@@ -5,7 +5,12 @@ settled in BSV**, through the hosted gateway at **inference.bsvkey.com**. Zero
 dependencies (Node ≥ 18, uses global `fetch`). It's a thin HTTP client — it never
 holds your keys or runs models; every call is billed through the gateway.
 
-Tools: `list_models`, `infer`, `channel_balance`, `open_channel`.
+Tools: `list_models`, `infer`, `channel_balance`, `open_channel`, `x402_infer`.
+
+Two ways to pay: a **prepaid channel** (`infer`, fund once, draw down per token) or
+**per call via x402** (`x402_infer` — no channel; the agent pays each request in BSV
+with its own key). `x402_infer` needs a funded WIF (`wif` arg or `BSVKEY_WIF`) and the
+optional `@bsvkey/x402-bsv-client` + `@bsv/sdk` packages (installed with this one).
 
 ## Quick start
 1. **Fund a channel once** at https://inference.bsvkey.com (BRC-100 wallet, or

package/SKILL.md

@@ -12,7 +12,10 @@ subscription, no account, no card. Models: Claude (haiku/sonnet/opus) and Grok
 (grok-4.3 fast, grok-4.6), with optional live web search.
 
 Install it as an MCP server (see README.md) — this skill assumes those four tools
-are available: `list_models`, `open_channel`, `infer`, `channel_balance`.
+are available: `list_models`, `open_channel`, `infer`, `channel_balance`, `x402_infer`.
+
+`x402_infer` is an alternative to `infer`: instead of a prepaid channel, it pays for a
+single call in BSV via x402, using a funded key (`wif` arg or `BSVKEY_WIF`). No channel setup.
 
 ## When to use
 - The user/agent wants to buy inference on demand and pay only for what it uses.

package/package.json

@@ -1,13 +1,17 @@
 {
   "name": "@bsvkey/inference-mcp",
-  "version": "1.0.1",
-  "description": "MCP server: buy Claude & Grok inference metered per token, settled in BSV, through the hosted inference.bsvkey.com gateway.",
+  "version": "1.1.0",
+  "description": "MCP server: buy Claude & Grok inference metered per token, settled in BSV, through the hosted inference.bsvkey.com gateway. Channels or per-call x402.",
   "mcpName": "io.github.BSVKey/inference-mcp",
   "type": "module",
   "bin": { "bsvkey-inference-mcp": "server.js" },
   "main": "server.js",
   "engines": { "node": ">=18" },
   "files": ["server.js", "SKILL.md", "README.md", "LICENSE"],
+  "optionalDependencies": {
+    "@bsvkey/x402-bsv-client": "^0.1.0",
+    "@bsv/sdk": "^1"
+  },
   "keywords": ["mcp", "model-context-protocol", "bsv", "inference", "pay-per-token", "http-402", "x402", "claude", "grok", "micropayments", "agents"],
   "author": "Embryo Space Inc. DBA BSVKey",
   "license": "MIT",

package/server.js

@@ -85,6 +85,24 @@ export const TOOLS = [
       'Explains how to open + fund a prepaid channel. Funding is a real BSV payment signed by a wallet, so it is done once at the website; you then paste the returned channel key here (or set BSVKEY_API_KEY).',
     inputSchema: { type: 'object', properties: {}, additionalProperties: false },
   },
+  {
+    name: 'x402_infer',
+    description:
+      'Run one inference paid PER CALL in BSV via x402 — no prepaid channel needed. You provide a funded BSV private key (wif or BSVKEY_WIF); the tool fetches the 402 quote, builds + signs a BSV payment, retries with X-PAYMENT, and returns the completion plus the on-chain settlement txid. Non-custodial: signing happens locally in this process, the key never leaves it. Needs @bsvkey/x402-bsv-client + @bsv/sdk (installed with this package).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        prompt: { type: 'string', description: 'The user prompt.' },
+        model: { type: 'string', description: 'Model id or policy: auto|cheapest|best, claude-*, grok-*.', default: 'grok-4.3' },
+        system: { type: 'string', description: 'Optional system prompt.' },
+        maxTokens: { type: 'integer', description: 'Max output tokens.', default: 512 },
+        webSearch: { type: 'boolean', description: 'Let the model search the live web (adds a per-search fee to the quote).', default: false },
+        wif: { type: 'string', description: 'A funded BSV private key (WIF) to pay from. Omit to use BSVKEY_WIF. Never leaves this process.' },
+      },
+      required: ['prompt'],
+      additionalProperties: false,
+    },
+  },
 ];
 
 async function callTool(name, args = {}) {
@@ -154,6 +172,45 @@ async function callTool(name, args = {}) {
         ],
       };
     }
+    case 'x402_infer': {
+      const wif = args.wif || process.env.BSVKEY_WIF || '';
+      if (!wif) throw new Error(`No BSV key. Pass wif "<WIF>" or set BSVKEY_WIF — an agent-funded key to pay per call. Fund its address at ${SITE}.`);
+      let x402;
+      try {
+        x402 = await import('@bsvkey/x402-bsv-client');
+      } catch {
+        throw new Error('Pay-per-call needs @bsvkey/x402-bsv-client and @bsv/sdk. Install them: npm i @bsvkey/x402-bsv-client @bsv/sdk');
+      }
+      const url = `${BASE}/x402/chat/completions`;
+      const init = {
+        method: 'POST',
+        headers: { 'content-type': 'application/json' },
+        body: JSON.stringify({
+          model: args.model || 'grok-4.3',
+          messages: [
+            ...(args.system ? [{ role: 'system', content: args.system }] : []),
+            { role: 'user', content: String(args.prompt || '') },
+          ],
+          max_tokens: args.maxTokens || 512,
+          web_search: args.webSearch === true,
+        }),
+      };
+      const res = await x402.fetchWithX402(url, init, { wif });
+      const data = await res.json().catch(() => ({}));
+      if (!res.ok) {
+        const msg = data?.error?.message || data?.error || data?.reason || `x402 inference failed (${res.status})`;
+        throw new Error(typeof msg === 'string' ? msg : JSON.stringify(msg));
+      }
+      const settle = x402.readSettlement(res) || {};
+      return {
+        model: data.model || args.model,
+        completion: data.choices?.[0]?.message?.content ?? '',
+        paidSats: data.x_bsv?.paidSats,
+        payTo: data.x_bsv?.payTo,
+        settlementTxid: settle.transaction,
+        network: settle.network,
+      };
+    }
     default:
       throw new Error(`unknown tool: ${name}`);
   }