@aibtc/mcp-server 1.76.0 → 1.76.1

package/dist/tools/inference-marketplace.tools.d.ts

@@ -7,8 +7,11 @@
  * accounts, no API keys. These tools sign locally with the unlocked wallet and
  * call the gateway, so an agent can register/update/check in one step.
  *
+ * Each listing charges a flat `pricePerRequest`, set by the provider, in its
+ * `acceptedToken` (sBTC or USDCx), as a whole number of the token's base unit.
+ *
  * - inference_register_provider: verify + list an endpoint (signed)
- * - inference_update_provider:   change name/models/payout/endpoint in place (signed)
+ * - inference_update_provider:   change name/models/payout/endpoint/price in place (signed)
  * - inference_reveal_key:        reveal or rotate the gateway↔endpoint shared key (signed)
  * - inference_check_provider:    re-run the health/functional probe (unsigned)
  * - inference_list_providers:    list registered providers + health (unsigned)

package/dist/tools/inference-marketplace.tools.js

@@ -7,8 +7,11 @@
  * accounts, no API keys. These tools sign locally with the unlocked wallet and
  * call the gateway, so an agent can register/update/check in one step.
  *
+ * Each listing charges a flat `pricePerRequest`, set by the provider, in its
+ * `acceptedToken` (sBTC or USDCx), as a whole number of the token's base unit.
+ *
  * - inference_register_provider: verify + list an endpoint (signed)
- * - inference_update_provider:   change name/models/payout/endpoint in place (signed)
+ * - inference_update_provider:   change name/models/payout/endpoint/price in place (signed)
  * - inference_reveal_key:        reveal or rotate the gateway↔endpoint shared key (signed)
  * - inference_check_provider:    re-run the health/functional probe (unsigned)
  * - inference_list_providers:    list registered providers + health (unsigned)
@@ -110,10 +113,20 @@ const allowUnsafeGatewayArg = z
     .optional()
     .describe("Allow a gateway host outside localhost / *.aibtc.com. Required to send wallet-signed headers " +
     "(and any apiKey) to an arbitrary host — leave unset unless you deliberately self-host the gateway.");
+const acceptedTokenArg = z
+    .enum(["sBTC", "USDCx"])
+    .describe("Token callers pay in, and the unit of pricePerRequest.");
+/** Whole base units only: the gateway rejects decimals, zero and negatives. */
+const pricePerRequestArg = z
+    .string()
+    .regex(/^[1-9][0-9]*$/, "pricePerRequest must be a whole number greater than zero, in base units")
+    .describe("Flat price per request, as a whole number in the accepted token's base unit: sats for sBTC " +
+    "(\"5\" = 5 sats), 0.000001 USDCx for USDCx (\"2000\" = 0.002 USDCx). No decimals.");
 export function registerInferenceMarketplaceTools(server) {
     // Register (verify + list) an endpoint — signed
     server.registerTool("inference_register_provider", {
-        description: "List an OpenAI-compatible model endpoint on the AIBTC Inference Marketplace and get paid per request in sBTC. " +
+        description: "List an OpenAI-compatible model endpoint on the AIBTC Inference Marketplace and get paid a flat price per request " +
+            "that you set, in sBTC (default) or USDCx. " +
             "Signs a registration message with the unlocked payout wallet (proving ownership) and POSTs it. " +
             "The gateway verifies the signature recovers to payoutAddress, that the endpoint is reachable AND actually " +
             "serving inference, and that model ids are real/commercial Hugging Face repos — then lists it. " +
@@ -132,6 +145,8 @@ export function registerInferenceMarketplaceTools(server) {
                 .string()
                 .optional()
                 .describe("Stacks address that receives sBTC. Defaults to the unlocked wallet's address (must match the gateway network)."),
+            pricePerRequest: pricePerRequestArg,
+            acceptedToken: acceptedTokenArg.optional().describe("Token callers pay in: sBTC (default) or USDCx. Sets the unit of pricePerRequest."),
             apiKey: z
                 .string()
                 .optional()
@@ -139,7 +154,7 @@ export function registerInferenceMarketplaceTools(server) {
             gateway: gatewayArg,
             allowUnsafeGateway: allowUnsafeGatewayArg,
         }),
-    }, async ({ name, endpoint, models, payoutAddress, apiKey, gateway, allowUnsafeGateway }) => {
+    }, async ({ name, endpoint, models, payoutAddress, pricePerRequest, acceptedToken, apiKey, gateway, allowUnsafeGateway }) => {
         try {
             const account = requireUnlockedWallet();
             const base = resolveGateway(gateway, allowUnsafeGateway ?? false);
@@ -153,6 +168,8 @@ export function registerInferenceMarketplaceTools(server) {
                     endpoint,
                     payoutAddress: payout,
                     models,
+                    pricePerRequest,
+                    ...(acceptedToken ? { acceptedToken } : {}),
                     ...(apiKey ? { apiKey } : {}),
                 }),
             });
@@ -173,7 +190,8 @@ export function registerInferenceMarketplaceTools(server) {
     });
     // Update a listing in place — signed
     server.registerTool("inference_update_provider", {
-        description: "Update your marketplace listing in place — name, models, payout address, endpoint, or description — no delete/re-add. " +
+        description: "Update your marketplace listing in place — name, models, payout address, endpoint, description, price, or accepted " +
+            "token — no delete/re-add. Switching acceptedToken requires a new pricePerRequest in the same call. " +
             "Signs an update message with the unlocked payout wallet and PATCHes it. Only fields you pass change. " +
             "Changing the endpoint re-verifies reachability before taking effect. Requires an unlocked wallet.",
         inputSchema: z.object({
@@ -183,12 +201,17 @@ export function registerInferenceMarketplaceTools(server) {
             models: z.array(z.string()).optional().describe("New Hugging Face repo id list."),
             payoutAddress: z.string().optional().describe("New payout address (must match the gateway network)."),
             description: z.string().optional().describe("New description."),
+            pricePerRequest: pricePerRequestArg.optional(),
+            acceptedToken: acceptedTokenArg.optional().describe("New token callers pay in: sBTC or USDCx. Requires pricePerRequest too."),
             apiKey: z.string().optional().describe("Set/replace the key your endpoint requires (locks the endpoint)."),
             gateway: gatewayArg,
             allowUnsafeGateway: allowUnsafeGatewayArg,
         }),
-    }, async ({ providerId, name, endpoint, models, payoutAddress, description, apiKey, gateway, allowUnsafeGateway }) => {
+    }, async ({ providerId, name, endpoint, models, payoutAddress, description, pricePerRequest, acceptedToken, apiKey, gateway, allowUnsafeGateway, }) => {
         try {
+            if (acceptedToken !== undefined && pricePerRequest === undefined) {
+                throw new Error("Changing acceptedToken requires a new pricePerRequest in that token's base unit (sats for sBTC, 0.000001 USDCx for USDCx).");
+            }
             const account = requireUnlockedWallet();
             const base = resolveGateway(gateway, allowUnsafeGateway ?? false);
             const patch = {};
@@ -202,10 +225,14 @@ export function registerInferenceMarketplaceTools(server) {
                 patch.payoutAddress = payoutAddress;
             if (description !== undefined)
                 patch.description = description;
+            if (pricePerRequest !== undefined)
+                patch.pricePerRequest = pricePerRequest;
+            if (acceptedToken !== undefined)
+                patch.acceptedToken = acceptedToken;
             if (apiKey !== undefined)
                 patch.apiKey = apiKey;
             if (Object.keys(patch).length === 0) {
-                throw new Error("Nothing to update — pass at least one of name/endpoint/models/payoutAddress/description/apiKey.");
+                throw new Error("Nothing to update — pass at least one of name/endpoint/models/payoutAddress/description/pricePerRequest/acceptedToken/apiKey.");
             }
             const headers = signAuthHeaders(account, "update", providerId);
             const { ok, status, body } = await gatewayFetch(`${base}/v1/providers/${providerId}`, {
@@ -283,7 +310,8 @@ export function registerInferenceMarketplaceTools(server) {
     });
     // List registered providers — unsigned
     server.registerTool("inference_list_providers", {
-        description: "List providers registered on the marketplace with their models, health/status, and flagged state. No signature " +
+        description: "List providers registered on the marketplace with their models, price per request and accepted token, health/status, " +
+            "and flagged state. No signature " +
             "required. Use it to find your provider id (match on payoutAddress) after registering.",
         inputSchema: z.object({
             gateway: gatewayArg,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aibtc/mcp-server",
-  "version": "1.76.0",
+  "version": "1.76.1",
   "description": "Bitcoin-native MCP server for AI agents: BTC/STX wallets, DeFi yield, sBTC peg, NFTs, and x402 payments.",
   "mcpName": "io.github.aibtcdev/mcp-server",
   "type": "module",

package/skill/SKILL.md

@@ -4,7 +4,7 @@ description: Bitcoin L1 wallet for agents - check balances, send BTC, manage UTX
 license: MIT
 metadata:
   author: aibtcdev
-  version: 1.76.0 # x-release-please-version
+  version: 1.76.1 # x-release-please-version
   npm: "@aibtc/mcp-server"
   github: https://github.com/aibtcdev/aibtc-mcp-server
 ---
@@ -224,13 +224,13 @@ tools sign locally with the unlocked wallet and call the gateway, so an agent ca
 register and manage a listing in one step.
 
 ```
-"Register my endpoint https://my-host/v1 serving Qwen/Qwen2.5-7B-Instruct on the inference marketplace"
+"Register my endpoint https://my-host/v1 serving Qwen/Qwen2.5-7B-Instruct on the inference marketplace at 5 sats per request"
 ```
 
 | Tool | Description | Signed |
 |------|-------------|:------:|
-| `inference_register_provider` | Verify + list an endpoint (name, models, payout, optional apiKey) | ✅ |
-| `inference_update_provider` | Change name/models/payout/endpoint/description/apiKey in place | ✅ |
+| `inference_register_provider` | Verify + list an endpoint (name, models, payout, `pricePerRequest`, optional `acceptedToken` sBTC/USDCx, optional apiKey) | ✅ |
+| `inference_update_provider` | Change name/models/payout/endpoint/description/price/token/apiKey in place (a token switch needs a new price) | ✅ |
 | `inference_reveal_key` | Reveal or rotate the gateway↔endpoint shared key (`rotate: true`) | ✅ |
 | `inference_check_provider` | Re-run the health/functional probe | — |
 | `inference_list_providers` | List providers + health (find your id by `payoutAddress`) | — |