@aibtc/mcp-server 1.70.1 → 1.72.0

package/dist/tools/yield-dashboard.tools.js

@@ -17,6 +17,7 @@ import { contractPrincipalCV, standardPrincipalCV, uintCV, hexToCV, cvToValue, }
 import { NETWORK } from "../services/x402.service.js";
 import { getWalletAddress } from "../services/x402.service.js";
 import { getHiroApi } from "../services/hiro-api.js";
+import { getStackingService } from "../services/stacking.service.js";
 import { createJsonResponse, createErrorResponse } from "../utils/index.js";
 // ============================================================================
 // Constants
@@ -41,10 +42,6 @@ const ALEX_TOKEN_Y_NAME = "token-abtc";
 const ALEX_FACTOR = 100_000_000;
 // Bitflow public API
 const BITFLOW_API = "https://app.bitflow.finance/api";
-// Stacking (PoX-4)
-const POX_CONTRACT = "SP000000000000000000002Q6VF78";
-const POX_NAME = "pox-4";
-const POX_CONTRACT_ID = `${POX_CONTRACT}.${POX_NAME}`;
 // Mainnet Hiro API base URL (direct — not network-switched, this skill is mainnet-only)
 const MAINNET_HIRO_API = "https://api.hiro.so";
 // ============================================================================
@@ -225,24 +222,18 @@ async function readStackingPosition(walletAddress) {
         details: {},
     };
     try {
-        const hiro = getHiroApi("mainnet");
-        const res = await hiro.callReadOnlyFunction(POX_CONTRACT_ID, "get-stacker-info", [standardPrincipalCV(walletAddress)], POX_CONTRACT);
-        if (res.okay && res.result) {
-            const hex = res.result.startsWith("0x") ? res.result.slice(2) : res.result;
-            const cv = hexToCV(hex);
-            const val = cvToValue(cv, true);
-            if (val && typeof val === "object" && "lock-amount" in val) {
-                const lockAmount = val["lock-amount"];
-                pos.valueSats =
-                    typeof lockAmount === "bigint"
-                        ? Number(lockAmount)
-                        : typeof lockAmount === "number"
-                            ? lockAmount
-                            : 0;
-                pos.apyPct = 8.0;
-                pos.details.apySource = "static estimate, not live";
-                pos.details.stackerInfo = val;
-            }
+        const info = await getStackingService("mainnet").getStakerInfo(walletAddress);
+        if (info) {
+            pos.valueSats = Number(info.amountUstx);
+            pos.apyPct = 8.0;
+            pos.details.apySource = "static estimate, not live";
+            pos.details.stakerInfo = {
+                signerManager: info.signerManager,
+                firstRewardCycle: info.firstRewardCycle,
+                numCycles: info.numCycles,
+                unlockCycle: info.unlockCycle,
+                unlockBurnHeight: info.unlockBurnHeight,
+            };
         }
     }
     catch (e) {
@@ -288,7 +279,7 @@ Read-only. Mainnet-only. Requires an unlocked wallet for address context.
 
 Note: ALEX LP and Bitflow LP position values are 0 — these protocols do not
 expose user LP positions via read-only calls. APY figures are still returned.`,
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         try {
             if (NETWORK !== "mainnet") {
@@ -364,7 +355,7 @@ Known limitations:
 - ALEX LP and Bitflow LP: valueSats shows 0 (protocol does not expose user
   LP balances via read-only calls). APY is still returned.
 - Stacking: denominated in microSTX, not sats.`,
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         try {
             if (NETWORK !== "mainnet") {
@@ -415,7 +406,7 @@ Data sources:
 - STX Stacking: static 8.0% estimate
 
 Mainnet data only (contract addresses are mainnet-specific).`,
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         try {
             // APY breakdown does not require a wallet — use burn address as dummy
@@ -474,13 +465,13 @@ Risk tolerance levels:
 - high:   Zest 50%, ALEX 30%, Bitflow 20%, Stacking 0%
 
 Read-only. Mainnet-only. Requires an unlocked wallet for address context.`,
-        inputSchema: {
+        inputSchema: z.object({
             riskTolerance: z
                 .enum(["low", "medium", "high"])
                 .optional()
                 .default("medium")
                 .describe("Risk tolerance level: low, medium, or high (default: medium)"),
-        },
+        }),
     }, async ({ riskTolerance }) => {
         try {
             if (NETWORK !== "mainnet") {

package/dist/tools/yield-hunter.tools.d.ts

@@ -1,3 +1,3 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { McpServer } from "@modelcontextprotocol/server";
 export declare function registerYieldHunterTools(server: McpServer): void;
 //# sourceMappingURL=yield-hunter.tools.d.ts.map

package/dist/tools/yield-hunter.tools.js

@@ -273,7 +273,7 @@ Default settings:
 - Deposit threshold: 10,000 sats (0.0001 sBTC)
 - Reserve: 0 sats (deposit all sBTC to maximize yield)
 - Check interval: 10 minutes`,
-        inputSchema: {
+        inputSchema: z.object({
             threshold: z
                 .string()
                 .optional()
@@ -286,7 +286,7 @@ Default settings:
                 .number()
                 .optional()
                 .describe("Check interval in seconds. Default: 600 (10 minutes)"),
-        },
+        }),
     }, async ({ threshold, reserve, interval }) => {
         try {
             if (NETWORK !== "mainnet") {
@@ -363,7 +363,7 @@ Default settings:
 
 Stops the background process that monitors and deposits sBTC.
 Your existing Zest positions remain untouched.`,
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         try {
             if (!state.running) {
@@ -403,7 +403,7 @@ Shows:
 - Statistics (checks run, deposits made)
 - Recent activity logs
 - Current Zest position`,
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         try {
             const status = await getFullStatus();
@@ -419,7 +419,7 @@ Shows:
 
 Adjust the deposit threshold, reserve, or check interval.
 Changes take effect on the next check cycle.`,
-        inputSchema: {
+        inputSchema: z.object({
             threshold: z
                 .string()
                 .optional()
@@ -432,7 +432,7 @@ Changes take effect on the next check cycle.`,
                 .number()
                 .optional()
                 .describe("Check interval in seconds"),
-        },
+        }),
     }, async ({ threshold, reserve, interval }) => {
         try {
             const changes = [];

package/dist/utils/bitcoin.d.ts

@@ -231,4 +231,12 @@ export declare function deriveTaprootKeyPair(mnemonic: string, network: Network)
  * ```
  */
 export declare function deriveNostrKeyPair(mnemonic: string, _network: Network): NostrKeyPair;
+/**
+ * Decode a Bitcoin address into the `{ version, hashbytes }` pox-addr tuple used by
+ * Stacks contracts (sBTC withdrawals, PoX signer-manager payout addresses).
+ */
+export declare function btcAddressToPoxAddr(address: string, network: Network): {
+    version: number;
+    hashbytesHex: string;
+};
 //# sourceMappingURL=bitcoin.d.ts.map

package/dist/utils/bitcoin.js

@@ -326,4 +326,28 @@ export function deriveNostrKeyPair(mnemonic, _network) {
         publicKey,
     };
 }
+/**
+ * Decode a Bitcoin address into the `{ version, hashbytes }` pox-addr tuple used by
+ * Stacks contracts (sBTC withdrawals, PoX signer-manager payout addresses).
+ */
+export function btcAddressToPoxAddr(address, network) {
+    const decoded = btc
+        .Address(network === "mainnet" ? btc.NETWORK : btc.TEST_NETWORK)
+        .decode(address);
+    if (decoded.type === "tr" && decoded.pubkey) {
+        return { version: 0x06, hashbytesHex: Buffer.from(decoded.pubkey).toString("hex") };
+    }
+    switch (decoded.type) {
+        case "pkh":
+            return { version: 0x00, hashbytesHex: Buffer.from(decoded.hash).toString("hex") };
+        case "sh":
+            return { version: 0x01, hashbytesHex: Buffer.from(decoded.hash).toString("hex") };
+        case "wpkh":
+            return { version: 0x04, hashbytesHex: Buffer.from(decoded.hash).toString("hex") };
+        case "wsh":
+            return { version: 0x05, hashbytesHex: Buffer.from(decoded.hash).toString("hex") };
+        default:
+            throw new Error("Unsupported BTC address type. Supported: P2PKH, P2SH, P2WPKH, P2WSH, P2TR.");
+    }
+}
 //# sourceMappingURL=bitcoin.js.map

package/dist/utils/fee.js

@@ -88,7 +88,7 @@ export async function resolveFee(fee, network, txType = "all") {
             const clamps = FEE_CLAMPS[txType];
             const multipliers = { low: 1n, medium: 2n, high: 3n };
             const fallbackFee = clamps.floor * multipliers[fee.toLowerCase()];
-            console.info(`Using fallback fee: ${fallbackFee} uSTX (${fee} preset, ${txType} type)`);
+            console.error(`Using fallback fee: ${fallbackFee} uSTX (${fee} preset, ${txType} type)`);
             return fallbackFee;
         }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aibtc/mcp-server",
-  "version": "1.70.1",
+  "version": "1.72.0",
   "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",
@@ -52,17 +52,18 @@
     "@bitflowlabs/core-sdk": "^3.0.0",
     "@buildonspark/spark-sdk": "^0.7.14",
     "@faktoryfun/styx-sdk": "^1.3.5",
-    "@modelcontextprotocol/sdk": "^1.27.1",
+    "@modelcontextprotocol/client": "^2.1.0",
+    "@modelcontextprotocol/server": "^2.1.0",
     "@noble/curves": "^2.0.1",
     "@noble/hashes": "^2.0.1",
     "@scure/base": "^2.0.0",
     "@scure/bip32": "^1.4.0",
     "@scure/bip39": "^2.0.1",
     "@scure/btc-signer": "^2.0.1",
-    "@stacks/common": "^7.3.1",
-    "@stacks/encryption": "^7.3.1",
-    "@stacks/network": "^7.3.1",
-    "@stacks/transactions": "^7.3.1",
+    "@stacks/common": "^7.6.0",
+    "@stacks/encryption": "^7.6.0",
+    "@stacks/network": "^7.6.0",
+    "@stacks/transactions": "^7.6.0",
     "@stacks/wallet-sdk": "^7.2.0",
     "alex-sdk": "^3.2.1",
     "axios": "^1.17.0",
@@ -75,7 +76,7 @@
     "tslib": "^2.8.1",
     "ws": "^8.21.0",
     "x402-stacks": "^2.0.3",
-    "zod": "^4.3.6"
+    "zod": "^4.6.5"
   },
   "devDependencies": {
     "@types/node": "^22.19.13",

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.70.1 # x-release-please-version
+  version: 1.72.0 # x-release-please-version
   npm: "@aibtc/mcp-server"
   github: https://github.com/aibtcdev/aibtc-mcp-server
 ---

package/skill/references/stacks-defi.md

@@ -360,7 +360,7 @@ Utility services for agents:
 | Category | Endpoints |
 |----------|-----------|
 | **Inference** | `/inference/openrouter/chat`, `/inference/cloudflare/chat` |
-| **Stacks** | `/stacks/address`, `/stacks/decode`, `/stacks/profile` |
+| **Stacks** | `/stacks/address/{address}`, `/stacks/decode/transaction`, `/stacks/decode/clarity`, `/stacks/profile/{address}` |
 | **Hashing** | `/hashing/sha256`, `/hashing/keccak256`, `/hashing/hash160` |
 | **Storage** | `/storage/kv/*`, `/storage/paste/*`, `/storage/db/*`, `/storage/memory/*` |