@bsvkey/inference-mcp 1.0.0 → 1.1.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Embryo Space Inc. (BSVKey)
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Embryo Space Inc. (BSVKey)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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
@@ -19,27 +24,28 @@ need a funded channel key.
 
 ## Install
 
+Published on npm as **[@bsvkey/inference-mcp](https://www.npmjs.com/package/@bsvkey/inference-mcp)**.
+
 ### Claude Code
 ```bash
 claude mcp add bsvkey-inference \
   --env BSVKEY_API_KEY=channelId:channelSecret \
-  -- node /absolute/path/to/integrations/mcp/server.js
+  -- npx -y @bsvkey/inference-mcp
 ```
-Once published to npm, replace the command with `npx -y @bsvkey/inference-mcp`.
 
 ### Claude Desktop / Codex / any MCP host (JSON config)
 ```json
 {
   "mcpServers": {
     "bsvkey-inference": {
-      "command": "node",
-      "args": ["/absolute/path/to/integrations/mcp/server.js"],
+      "command": "npx",
+      "args": ["-y", "@bsvkey/inference-mcp"],
       "env": { "BSVKEY_API_KEY": "channelId:channelSecret" }
     }
   }
 }
 ```
-After npm publish: `"command": "npx", "args": ["-y", "@bsvkey/inference-mcp"]`.
+No npm? Grab the single-file server directly (`https://inference.bsvkey.com/mcp/server.js`) and use `"command": "node", "args": ["server.js"]`.
 
 ## Configuration (env)
 | Var | Default | Meaning |
@@ -62,7 +68,8 @@ printf '%s\n' \
 > compatible, optional live web search, on-chain settlement. MCP + portable SKILL.md.
 
 ## Publishing (operator)
-- To make `npx @bsvkey/inference-mcp` work, publish this folder to npm
-  (`npm publish --access public`) from an account that owns the `@bsvkey` scope.
+- Live on npm under the `@bsvkey` org (owner: `interence`). First publish: v1.0.0.
+- To ship an update: bump `version` in `package.json`, then
+  `npm publish --access public` (2FA/security-key prompt applies).
+- Canonical source: https://github.com/BSVKey/inference-mcp
 - To list on a skills marketplace (e.g. bopen.ai), submit `SKILL.md` + this README.
-- Publishing is an operator action requiring your own credentials — not done here.

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,14 +1,21 @@
 {
   "name": "@bsvkey/inference-mcp",
-  "version": "1.0.0",
-  "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",
-  "homepage": "https://inference.bsvkey.com"
+  "homepage": "https://inference.bsvkey.com",
+  "repository": { "type": "git", "url": "git+https://github.com/BSVKey/inference-mcp.git" },
+  "bugs": { "url": "https://github.com/BSVKey/inference-mcp/issues" }
 }

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}`);
   }