@aibtc/mcp-server 1.33.4 → 1.35.0

package/dist/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAuBpE;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyDxD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAqDpE;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmExD"}

package/dist/tools/index.js

@@ -7,6 +7,7 @@ import { registerTokenTools } from "./tokens.tools.js";
 import { registerNftTools } from "./nft.tools.js";
 import { registerStackingTools } from "./stacking.tools.js";
 import { registerBnsTools } from "./bns.tools.js";
+import { registerStyxTools } from "./styx.tools.js";
 import { registerQueryTools } from "./query.tools.js";
 import { registerEndpointTools } from "./endpoint.tools.js";
 import { registerDefiTools } from "./defi.tools.js";
@@ -18,10 +19,40 @@ import { registerYieldHunterTools } from "./yield-hunter.tools.js";
 import { registerPillarTools } from "./pillar.tools.js";
 import { registerPillarDirectTools } from "./pillar-direct.tools.js";
 import { registerBitcoinTools } from "./bitcoin.tools.js";
+import { registerRelayDiagnosticTools } from "./relay-diagnostic.tools.js";
+import { getSkillForTool } from "./skill-mappings.js";
+/**
+ * Wraps server.registerTool to inject _meta.skill from TOOL_SKILL_MAP when a mapping exists.
+ * Returns a cleanup function that restores the original method.
+ */
+function withSkillMeta(server) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const original = server.registerTool;
+    const hasOwn = Object.prototype.hasOwnProperty.call(server, "registerTool");
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    server.registerTool = function (name, config, cb) {
+        const skill = getSkillForTool(name);
+        const patched = skill
+            ? { ...config, _meta: { ...(config._meta ?? {}), skill } }
+            : config;
+        return original.call(server, name, patched, cb);
+    };
+    return () => {
+        if (hasOwn) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            server.registerTool = original;
+        }
+        else {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            delete server.registerTool;
+        }
+    };
+}
 /**
  * Register all tools with the MCP server
  */
 export function registerAllTools(server) {
+    const restoreRegisterTool = withSkillMeta(server);
     // Wallet & Balance
     registerWalletTools(server);
     // Wallet Management (create, import, unlock, lock, etc.)
@@ -48,6 +79,8 @@ export function registerAllTools(server) {
     registerDefiTools(server);
     // Bitflow DEX (disabled until API key integration is complete)
     // registerBitflowTools(server);
+    // Styx BTC→sBTC conversion
+    registerStyxTools(server);
     // Scaffolding (generate x402 endpoint projects)
     registerScaffoldTools(server);
     // OpenRouter AI (call AI models directly)
@@ -60,5 +93,8 @@ export function registerAllTools(server) {
     registerPillarDirectTools(server);
     // Bitcoin L1 (read-only: balance, fees, UTXOs)
     registerBitcoinTools(server);
+    // Relay Diagnostics (sponsor relay health, nonce status, stuck transactions)
+    registerRelayDiagnosticTools(server);
+    restoreRegisterTool();
 }
 //# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,6BAA6B,EAAE,MAAM,8BAA8B,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,+DAA+D;AAC/D,6DAA6D;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,mBAAmB;IACnB,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAE5B,yDAAyD;IACzD,6BAA6B,CAAC,MAAM,CAAC,CAAC;IAEtC,YAAY;IACZ,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAE9B,kBAAkB;IAClB,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAE9B,OAAO;IACP,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAE1B,mBAAmB;IACnB,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAE3B,iBAAiB;IACjB,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAEzB,iBAAiB;IACjB,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAE9B,cAAc;IACd,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAEzB,qBAAqB;IACrB,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAE3B,iBAAiB;IACjB,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAE9B,iCAAiC;IACjC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAE1B,+DAA+D;IAC/D,gCAAgC;IAEhC,gDAAgD;IAChD,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAE9B,0CAA0C;IAC1C,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAEhC,+CAA+C;IAC/C,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAEjC,yCAAyC;IACzC,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAE5B,mDAAmD;IACnD,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAElC,+CAA+C;IAC/C,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/relay-diagnostic.tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"relay-diagnostic.tools.d.ts","sourceRoot":"","sources":["../../src/tools/relay-diagnostic.tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8BpE"}
+{"version":3,"file":"relay-diagnostic.tools.d.ts","sourceRoot":"","sources":["../../src/tools/relay-diagnostic.tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOpE,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAuGpE"}

package/dist/tools/relay-diagnostic.tools.js

@@ -3,20 +3,25 @@
  *
  * Tools for checking sponsor relay health and diagnosing nonce issues
  */
+import { z } from "zod";
 import { createJsonResponse, createErrorResponse } from "../utils/index.js";
-import { checkRelayHealth, formatRelayHealthStatus } from "../utils/relay-health.js";
+import { checkRelayHealth, formatRelayHealthStatus, attemptRbf, attemptFillGaps } from "../utils/relay-health.js";
 import { NETWORK } from "../services/x402.service.js";
+import { getWalletManager } from "../services/wallet-manager.js";
 export function registerRelayDiagnosticTools(server) {
     server.registerTool("check_relay_health", {
         description: `Check the sponsor relay health and nonce status.
 
-Use this tool to diagnose send_inbox_message failures. It will:
+Use this tool to diagnose sponsored transaction failures. It will:
 - Check relay availability
 - Inspect sponsor address nonce state
 - Detect nonce gaps that block transactions
+- Detect mempool desync (confirmed nonce far behind mempool nonce)
+- List stuck transactions with txid, nonce, and how long they have been pending
 - Report mempool congestion
 
-If nonce gaps are detected, wait for AIBTC team to clear them before retrying sends.`,
+If nonce gaps or stuck transactions are detected, the output includes
+txids and pending durations to share with the AIBTC team for recovery.`,
         inputSchema: {},
     }, async () => {
         try {
@@ -27,7 +32,65 @@ If nonce gaps are detected, wait for AIBTC team to clear them before retrying se
             });
         }
         catch (error) {
-            return createErrorResponse(error instanceof Error ? error.message : String(error));
+            return createErrorResponse(error);
+        }
+    });
+    server.registerTool("recover_sponsor_nonce", {
+        description: `Attempt automated recovery of stuck sponsor transactions via the relay API.
+
+Run check_relay_health first to identify stuck txids and missing nonces, then use
+this tool to trigger recovery without needing to contact the AIBTC team manually.
+
+Two recovery modes are available:
+- rbf: Replace-by-fee — rebroadcasts stuck transactions with a higher fee so miners
+  prioritize them. Provide specific txids or omit to bump all stuck transactions.
+- fill-gaps: Nonce gap-fill — submits placeholder transactions to fill any missing
+  nonces that are blocking the queue. Provide specific nonces or omit to fill all gaps.
+- both: Attempt both RBF and gap-fill in sequence (default).
+
+If the relay does not yet support these endpoints it returns a 404 or 501 and this
+tool will respond with a clear message rather than throwing an error. In that case,
+share the txids and nonces from check_relay_health with the AIBTC team.`,
+        inputSchema: {
+            action: z
+                .enum(["rbf", "fill-gaps", "both"])
+                .default("both")
+                .describe("Which recovery operation to attempt"),
+            txids: z
+                .array(z.string())
+                .optional()
+                .describe("Specific stuck transaction IDs for RBF (omit to bump all stuck txs)"),
+            nonces: z
+                .array(z.number().int().nonnegative())
+                .optional()
+                .describe("Specific missing nonces for gap-fill (omit to fill all detected gaps)"),
+        },
+    }, async ({ action = "both", txids, nonces }) => {
+        try {
+            // Resolve API key from wallet (if unlocked) to align with sponsor-builder auth flow
+            const walletAccount = getWalletManager().getAccount();
+            const walletApiKey = walletAccount?.sponsorApiKey;
+            const results = { action };
+            if (action === "rbf" || action === "both") {
+                const rbfResult = await attemptRbf(NETWORK, txids, walletApiKey);
+                results.rbf = rbfResult;
+            }
+            if (action === "fill-gaps" || action === "both") {
+                const fillResult = await attemptFillGaps(NETWORK, nonces, walletApiKey);
+                results.fillGaps = fillResult;
+            }
+            // Summarize outcome
+            const anyUnsupported = Object.values(results).some((r) => r && typeof r === "object" && "supported" in r && !r.supported);
+            const anySupported = Object.values(results).some((r) => r && typeof r === "object" && "supported" in r && r.supported);
+            results.summary = anySupported
+                ? "Recovery request submitted to relay. Run check_relay_health to verify nonce state improved."
+                : anyUnsupported
+                    ? "Relay does not yet support automated recovery. Run check_relay_health for txids and nonces to share with the AIBTC team."
+                    : "Recovery attempted.";
+            return createJsonResponse(results);
+        }
+        catch (error) {
+            return createErrorResponse(error);
         }
     });
 }

package/dist/tools/relay-diagnostic.tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"relay-diagnostic.tools.js","sourceRoot":"","sources":["../../src/tools/relay-diagnostic.tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACrF,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAEtD,MAAM,UAAU,4BAA4B,CAAC,MAAiB;IAC5D,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,WAAW,EAAE;;;;;;;;qFAQkE;QAC/E,WAAW,EAAE,EAAE;KAChB,EACD,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;YAE/C,OAAO,kBAAkB,CAAC;gBACxB,GAAG,MAAM;gBACT,SAAS,EAAE,uBAAuB,CAAC,MAAM,CAAC;aAC3C,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,mBAAmB,CACxB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"relay-diagnostic.tools.js","sourceRoot":"","sources":["../../src/tools/relay-diagnostic.tools.ts"],"names":[],"mappings":"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"}

package/dist/tools/skill-mappings.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Skill reference mappings for MCP tools.
+ *
+ * Maps each MCP tool name to its corresponding skill in the aibtcdev/skills repository.
+ * Skills are loaded via the /skill command in Claude Code and provide higher-level
+ * orchestration logic built on top of these MCP tools.
+ *
+ * Skill source: https://github.com/aibtcdev/skills
+ */
+export declare const TOOL_SKILL_MAP: Record<string, string>;
+/**
+ * Returns the skill name for a given MCP tool name, or undefined if no mapping exists.
+ */
+export declare function getSkillForTool(toolName: string): string | undefined;
+//# sourceMappingURL=skill-mappings.d.ts.map

package/dist/tools/skill-mappings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-mappings.d.ts","sourceRoot":"","sources":["../../src/tools/skill-mappings.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA0OjD,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEpE"}

package/dist/tools/skill-mappings.js

@@ -0,0 +1,229 @@
+/**
+ * Skill reference mappings for MCP tools.
+ *
+ * Maps each MCP tool name to its corresponding skill in the aibtcdev/skills repository.
+ * Skills are loaded via the /skill command in Claude Code and provide higher-level
+ * orchestration logic built on top of these MCP tools.
+ *
+ * Skill source: https://github.com/aibtcdev/skills
+ */
+export const TOOL_SKILL_MAP = {
+    // wallet skill — encrypted BIP39 wallet management
+    get_wallet_info: "wallet",
+    wallet_create: "wallet",
+    wallet_import: "wallet",
+    wallet_unlock: "wallet",
+    wallet_lock: "wallet",
+    wallet_list: "wallet",
+    wallet_switch: "wallet",
+    wallet_delete: "wallet",
+    wallet_export: "wallet",
+    wallet_rotate_password: "wallet",
+    wallet_set_timeout: "wallet",
+    wallet_status: "wallet",
+    // stx skill — STX transfers and Stacks contract operations
+    get_stx_balance: "stx",
+    transfer_stx: "stx",
+    broadcast_transaction: "stx",
+    call_contract: "stx",
+    deploy_contract: "stx",
+    get_transaction_status: "stx",
+    // btc skill — Bitcoin L1 operations
+    get_btc_balance: "btc",
+    get_btc_fees: "btc",
+    get_btc_utxos: "btc",
+    transfer_btc: "btc",
+    get_cardinal_utxos: "btc",
+    get_ordinal_utxos: "btc",
+    get_inscriptions_by_address: "btc",
+    // sbtc skill — sBTC token operations
+    sbtc_get_balance: "sbtc",
+    sbtc_transfer: "sbtc",
+    sbtc_get_deposit_info: "sbtc",
+    sbtc_get_peg_info: "sbtc",
+    sbtc_deposit: "sbtc",
+    sbtc_deposit_status: "sbtc",
+    sbtc_initiate_withdrawal: "sbtc",
+    sbtc_withdraw: "sbtc",
+    sbtc_withdrawal_status: "sbtc",
+    sbtc_withdraw_status: "sbtc",
+    // tokens skill — SIP-010 fungible token operations
+    get_token_balance: "tokens",
+    get_token_info: "tokens",
+    list_user_tokens: "tokens",
+    get_token_holders: "tokens",
+    transfer_token: "tokens",
+    // nft skill — SIP-009 NFT operations
+    get_nft_holdings: "nft",
+    get_nft_metadata: "nft",
+    transfer_nft: "nft",
+    get_nft_owner: "nft",
+    get_collection_info: "nft",
+    get_nft_history: "nft",
+    // stacking skill — STX stacking and PoX operations
+    get_pox_info: "stacking",
+    get_stacking_status: "stacking",
+    stack_stx: "stacking",
+    extend_stacking: "stacking",
+    // bns skill — Bitcoin Name System operations
+    lookup_bns_name: "bns",
+    reverse_bns_lookup: "bns",
+    get_bns_info: "bns",
+    check_bns_availability: "bns",
+    get_bns_price: "bns",
+    list_user_domains: "bns",
+    claim_bns_name_fast: "bns",
+    preorder_bns_name: "bns",
+    register_bns_name: "bns",
+    // query skill — Stacks network and blockchain queries
+    get_stx_fees: "query",
+    get_account_info: "query",
+    get_account_transactions: "query",
+    get_block_info: "query",
+    get_mempool_info: "query",
+    get_contract_info: "query",
+    get_contract_events: "query",
+    get_network_status: "query",
+    call_read_only_function: "query",
+    // x402 skill — x402 paid endpoints, inbox, scaffolding, OpenRouter
+    list_x402_endpoints: "x402",
+    execute_x402_endpoint: "x402",
+    probe_x402_endpoint: "x402",
+    scaffold_x402_endpoint: "x402",
+    scaffold_x402_ai_endpoint: "x402",
+    openrouter_integration_guide: "x402",
+    openrouter_models: "x402",
+    send_inbox_message: "x402",
+    // defi skill — ALEX DEX and Zest Protocol
+    alex_list_pools: "defi",
+    alex_get_swap_quote: "defi",
+    alex_swap: "defi",
+    alex_get_pool_info: "defi",
+    zest_list_assets: "defi",
+    zest_get_position: "defi",
+    zest_supply: "defi",
+    zest_withdraw: "defi",
+    zest_borrow: "defi",
+    zest_repay: "defi",
+    // styx skill — BTC→sBTC conversion via Styx protocol
+    styx_pool_status: "styx",
+    styx_pools: "styx",
+    styx_fees: "styx",
+    styx_price: "styx",
+    styx_deposit: "styx",
+    styx_status: "styx",
+    styx_history: "styx",
+    // yield-hunter skill — autonomous sBTC yield farming daemon
+    yield_hunter_start: "yield-hunter",
+    yield_hunter_stop: "yield-hunter",
+    yield_hunter_status: "yield-hunter",
+    yield_hunter_configure: "yield-hunter",
+    // pillar skill — Pillar smart wallet (browser-handoff + agent-signed direct modes)
+    pillar_connect: "pillar",
+    pillar_disconnect: "pillar",
+    pillar_status: "pillar",
+    pillar_send: "pillar",
+    pillar_fund: "pillar",
+    pillar_add_admin: "pillar",
+    pillar_supply: "pillar",
+    pillar_auto_compound: "pillar",
+    pillar_unwind: "pillar",
+    pillar_boost: "pillar",
+    pillar_position: "pillar",
+    pillar_create_wallet: "pillar",
+    pillar_invite: "pillar",
+    pillar_dca_invite: "pillar",
+    pillar_dca_partners: "pillar",
+    pillar_dca_leaderboard: "pillar",
+    pillar_dca_status: "pillar",
+    pillar_key_generate: "pillar",
+    pillar_key_unlock: "pillar",
+    pillar_key_lock: "pillar",
+    pillar_key_info: "pillar",
+    pillar_direct_boost: "pillar",
+    pillar_direct_unwind: "pillar",
+    pillar_direct_supply: "pillar",
+    pillar_direct_send: "pillar",
+    pillar_direct_auto_compound: "pillar",
+    pillar_direct_position: "pillar",
+    pillar_direct_withdraw_collateral: "pillar",
+    pillar_direct_add_admin: "pillar",
+    pillar_direct_create_wallet: "pillar",
+    pillar_direct_dca_invite: "pillar",
+    pillar_direct_dca_partners: "pillar",
+    pillar_direct_dca_leaderboard: "pillar",
+    pillar_direct_dca_status: "pillar",
+    pillar_direct_quote: "pillar",
+    pillar_direct_resolve_recipient: "pillar",
+    pillar_direct_stack_stx: "pillar",
+    pillar_direct_revoke_fast_pool: "pillar",
+    pillar_direct_stacking_status: "pillar",
+    // settings skill — MCP server configuration and relay health
+    set_hiro_api_key: "settings",
+    get_hiro_api_key: "settings",
+    delete_hiro_api_key: "settings",
+    set_stacks_api_url: "settings",
+    get_stacks_api_url: "settings",
+    delete_stacks_api_url: "settings",
+    get_server_version: "settings",
+    check_relay_health: "settings",
+    recover_sponsor_nonce: "settings",
+    // signing skill — message signing and verification
+    stacks_sign_message: "signing",
+    stacks_verify_message: "signing",
+    btc_sign_message: "signing",
+    btc_verify_message: "signing",
+    schnorr_sign_digest: "signing",
+    schnorr_verify_digest: "signing",
+    nostr_sign_event: "signing",
+    // ordinals skill — Bitcoin ordinals inscription operations
+    get_taproot_address: "ordinals",
+    estimate_inscription_fee: "ordinals",
+    inscribe: "ordinals",
+    inscribe_reveal: "ordinals",
+    get_inscription: "ordinals",
+    inscribe_child: "ordinals",
+    inscribe_child_reveal: "ordinals",
+    estimate_child_inscription_fee: "ordinals",
+    // ordinals-p2p skill — peer-to-peer ordinals trading via PSBT
+    psbt_decode: "ordinals-p2p",
+    psbt_sign: "ordinals-p2p",
+    psbt_broadcast: "ordinals-p2p",
+    psbt_create_ordinal_buy: "ordinals-p2p",
+    // identity skill — ERC-8004 on-chain agent identity
+    register_identity: "identity",
+    get_identity: "identity",
+    // reputation skill — ERC-8004 on-chain agent reputation
+    give_feedback: "reputation",
+    get_reputation: "reputation",
+    // validation skill — ERC-8004 on-chain agent validation
+    request_validation: "validation",
+    get_validation_status: "validation",
+    get_validation_summary: "validation",
+    // stackspot skill — stacking lottery pots
+    stackspot_list_pots: "stackspot",
+    stackspot_get_pot_state: "stackspot",
+    stackspot_join_pot: "stackspot",
+    stackspot_start_pot: "stackspot",
+    stackspot_claim_rewards: "stackspot",
+    stackspot_cancel_pot: "stackspot",
+    // bitflow skill — Bitflow DEX aggregator
+    bitflow_get_ticker: "bitflow",
+    bitflow_get_tokens: "bitflow",
+    bitflow_get_swap_targets: "bitflow",
+    bitflow_get_quote: "bitflow",
+    bitflow_get_routes: "bitflow",
+    bitflow_swap: "bitflow",
+    bitflow_get_keeper_contract: "bitflow",
+    bitflow_create_order: "bitflow",
+    bitflow_get_order: "bitflow",
+    bitflow_cancel_order: "bitflow",
+    bitflow_get_keeper_user: "bitflow",
+};
+/**
+ * Returns the skill name for a given MCP tool name, or undefined if no mapping exists.
+ */
+export function getSkillForTool(toolName) {
+    return TOOL_SKILL_MAP[toolName];
+}
+//# sourceMappingURL=skill-mappings.js.map

package/dist/tools/skill-mappings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-mappings.js","sourceRoot":"","sources":["../../src/tools/skill-mappings.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,cAAc,GAA2B;IACpD,mDAAmD;IACnD,eAAe,EAAE,QAAQ;IACzB,aAAa,EAAE,QAAQ;IACvB,aAAa,EAAE,QAAQ;IACvB,aAAa,EAAE,QAAQ;IACvB,WAAW,EAAE,QAAQ;IACrB,WAAW,EAAE,QAAQ;IACrB,aAAa,EAAE,QAAQ;IACvB,aAAa,EAAE,QAAQ;IACvB,aAAa,EAAE,QAAQ;IACvB,sBAAsB,EAAE,QAAQ;IAChC,kBAAkB,EAAE,QAAQ;IAC5B,aAAa,EAAE,QAAQ;IAEvB,2DAA2D;IAC3D,eAAe,EAAE,KAAK;IACtB,YAAY,EAAE,KAAK;IACnB,qBAAqB,EAAE,KAAK;IAC5B,aAAa,EAAE,KAAK;IACpB,eAAe,EAAE,KAAK;IACtB,sBAAsB,EAAE,KAAK;IAE7B,oCAAoC;IACpC,eAAe,EAAE,KAAK;IACtB,YAAY,EAAE,KAAK;IACnB,aAAa,EAAE,KAAK;IACpB,YAAY,EAAE,KAAK;IACnB,kBAAkB,EAAE,KAAK;IACzB,iBAAiB,EAAE,KAAK;IACxB,2BAA2B,EAAE,KAAK;IAElC,qCAAqC;IACrC,gBAAgB,EAAE,MAAM;IACxB,aAAa,EAAE,MAAM;IACrB,qBAAqB,EAAE,MAAM;IAC7B,iBAAiB,EAAE,MAAM;IACzB,YAAY,EAAE,MAAM;IACpB,mBAAmB,EAAE,MAAM;IAC3B,wBAAwB,EAAE,MAAM;IAChC,aAAa,EAAE,MAAM;IACrB,sBAAsB,EAAE,MAAM;IAC9B,oBAAoB,EAAE,MAAM;IAE5B,mDAAmD;IACnD,iBAAiB,EAAE,QAAQ;IAC3B,cAAc,EAAE,QAAQ;IACxB,gBAAgB,EAAE,QAAQ;IAC1B,iBAAiB,EAAE,QAAQ;IAC3B,cAAc,EAAE,QAAQ;IAExB,qCAAqC;IACrC,gBAAgB,EAAE,KAAK;IACvB,gBAAgB,EAAE,KAAK;IACvB,YAAY,EAAE,KAAK;IACnB,aAAa,EAAE,KAAK;IACpB,mBAAmB,EAAE,KAAK;IAC1B,eAAe,EAAE,KAAK;IAEtB,mDAAmD;IACnD,YAAY,EAAE,UAAU;IACxB,mBAAmB,EAAE,UAAU;IAC/B,SAAS,EAAE,UAAU;IACrB,eAAe,EAAE,UAAU;IAE3B,6CAA6C;IAC7C,eAAe,EAAE,KAAK;IACtB,kBAAkB,EAAE,KAAK;IACzB,YAAY,EAAE,KAAK;IACnB,sBAAsB,EAAE,KAAK;IAC7B,aAAa,EAAE,KAAK;IACpB,iBAAiB,EAAE,KAAK;IACxB,mBAAmB,EAAE,KAAK;IAC1B,iBAAiB,EAAE,KAAK;IACxB,iBAAiB,EAAE,KAAK;IAExB,sDAAsD;IACtD,YAAY,EAAE,OAAO;IACrB,gBAAgB,EAAE,OAAO;IACzB,wBAAwB,EAAE,OAAO;IACjC,cAAc,EAAE,OAAO;IACvB,gBAAgB,EAAE,OAAO;IACzB,iBAAiB,EAAE,OAAO;IAC1B,mBAAmB,EAAE,OAAO;IAC5B,kBAAkB,EAAE,OAAO;IAC3B,uBAAuB,EAAE,OAAO;IAEhC,mEAAmE;IACnE,mBAAmB,EAAE,MAAM;IAC3B,qBAAqB,EAAE,MAAM;IAC7B,mBAAmB,EAAE,MAAM;IAC3B,sBAAsB,EAAE,MAAM;IAC9B,yBAAyB,EAAE,MAAM;IACjC,4BAA4B,EAAE,MAAM;IACpC,iBAAiB,EAAE,MAAM;IACzB,kBAAkB,EAAE,MAAM;IAE1B,0CAA0C;IAC1C,eAAe,EAAE,MAAM;IACvB,mBAAmB,EAAE,MAAM;IAC3B,SAAS,EAAE,MAAM;IACjB,kBAAkB,EAAE,MAAM;IAC1B,gBAAgB,EAAE,MAAM;IACxB,iBAAiB,EAAE,MAAM;IACzB,WAAW,EAAE,MAAM;IACnB,aAAa,EAAE,MAAM;IACrB,WAAW,EAAE,MAAM;IACnB,UAAU,EAAE,MAAM;IAElB,qDAAqD;IACrD,gBAAgB,EAAE,MAAM;IACxB,UAAU,EAAE,MAAM;IAClB,SAAS,EAAE,MAAM;IACjB,UAAU,EAAE,MAAM;IAClB,YAAY,EAAE,MAAM;IACpB,WAAW,EAAE,MAAM;IACnB,YAAY,EAAE,MAAM;IAEpB,4DAA4D;IAC5D,kBAAkB,EAAE,cAAc;IAClC,iBAAiB,EAAE,cAAc;IACjC,mBAAmB,EAAE,cAAc;IACnC,sBAAsB,EAAE,cAAc;IAEtC,mFAAmF;IACnF,cAAc,EAAE,QAAQ;IACxB,iBAAiB,EAAE,QAAQ;IAC3B,aAAa,EAAE,QAAQ;IACvB,WAAW,EAAE,QAAQ;IACrB,WAAW,EAAE,QAAQ;IACrB,gBAAgB,EAAE,QAAQ;IAC1B,aAAa,EAAE,QAAQ;IACvB,oBAAoB,EAAE,QAAQ;IAC9B,aAAa,EAAE,QAAQ;IACvB,YAAY,EAAE,QAAQ;IACtB,eAAe,EAAE,QAAQ;IACzB,oBAAoB,EAAE,QAAQ;IAC9B,aAAa,EAAE,QAAQ;IACvB,iBAAiB,EAAE,QAAQ;IAC3B,mBAAmB,EAAE,QAAQ;IAC7B,sBAAsB,EAAE,QAAQ;IAChC,iBAAiB,EAAE,QAAQ;IAC3B,mBAAmB,EAAE,QAAQ;IAC7B,iBAAiB,EAAE,QAAQ;IAC3B,eAAe,EAAE,QAAQ;IACzB,eAAe,EAAE,QAAQ;IACzB,mBAAmB,EAAE,QAAQ;IAC7B,oBAAoB,EAAE,QAAQ;IAC9B,oBAAoB,EAAE,QAAQ;IAC9B,kBAAkB,EAAE,QAAQ;IAC5B,2BAA2B,EAAE,QAAQ;IACrC,sBAAsB,EAAE,QAAQ;IAChC,iCAAiC,EAAE,QAAQ;IAC3C,uBAAuB,EAAE,QAAQ;IACjC,2BAA2B,EAAE,QAAQ;IACrC,wBAAwB,EAAE,QAAQ;IAClC,0BAA0B,EAAE,QAAQ;IACpC,6BAA6B,EAAE,QAAQ;IACvC,wBAAwB,EAAE,QAAQ;IAClC,mBAAmB,EAAE,QAAQ;IAC7B,+BAA+B,EAAE,QAAQ;IACzC,uBAAuB,EAAE,QAAQ;IACjC,8BAA8B,EAAE,QAAQ;IACxC,6BAA6B,EAAE,QAAQ;IAEvC,6DAA6D;IAC7D,gBAAgB,EAAE,UAAU;IAC5B,gBAAgB,EAAE,UAAU;IAC5B,mBAAmB,EAAE,UAAU;IAC/B,kBAAkB,EAAE,UAAU;IAC9B,kBAAkB,EAAE,UAAU;IAC9B,qBAAqB,EAAE,UAAU;IACjC,kBAAkB,EAAE,UAAU;IAC9B,kBAAkB,EAAE,UAAU;IAC9B,qBAAqB,EAAE,UAAU;IAEjC,mDAAmD;IACnD,mBAAmB,EAAE,SAAS;IAC9B,qBAAqB,EAAE,SAAS;IAChC,gBAAgB,EAAE,SAAS;IAC3B,kBAAkB,EAAE,SAAS;IAC7B,mBAAmB,EAAE,SAAS;IAC9B,qBAAqB,EAAE,SAAS;IAChC,gBAAgB,EAAE,SAAS;IAE3B,2DAA2D;IAC3D,mBAAmB,EAAE,UAAU;IAC/B,wBAAwB,EAAE,UAAU;IACpC,QAAQ,EAAE,UAAU;IACpB,eAAe,EAAE,UAAU;IAC3B,eAAe,EAAE,UAAU;IAC3B,cAAc,EAAE,UAAU;IAC1B,qBAAqB,EAAE,UAAU;IACjC,8BAA8B,EAAE,UAAU;IAE1C,8DAA8D;IAC9D,WAAW,EAAE,cAAc;IAC3B,SAAS,EAAE,cAAc;IACzB,cAAc,EAAE,cAAc;IAC9B,uBAAuB,EAAE,cAAc;IAEvC,oDAAoD;IACpD,iBAAiB,EAAE,UAAU;IAC7B,YAAY,EAAE,UAAU;IAExB,wDAAwD;IACxD,aAAa,EAAE,YAAY;IAC3B,cAAc,EAAE,YAAY;IAE5B,wDAAwD;IACxD,kBAAkB,EAAE,YAAY;IAChC,qBAAqB,EAAE,YAAY;IACnC,sBAAsB,EAAE,YAAY;IAEpC,0CAA0C;IAC1C,mBAAmB,EAAE,WAAW;IAChC,uBAAuB,EAAE,WAAW;IACpC,kBAAkB,EAAE,WAAW;IAC/B,mBAAmB,EAAE,WAAW;IAChC,uBAAuB,EAAE,WAAW;IACpC,oBAAoB,EAAE,WAAW;IAEjC,yCAAyC;IACzC,kBAAkB,EAAE,SAAS;IAC7B,kBAAkB,EAAE,SAAS;IAC7B,wBAAwB,EAAE,SAAS;IACnC,iBAAiB,EAAE,SAAS;IAC5B,kBAAkB,EAAE,SAAS;IAC7B,YAAY,EAAE,SAAS;IACvB,2BAA2B,EAAE,SAAS;IACtC,oBAAoB,EAAE,SAAS;IAC/B,iBAAiB,EAAE,SAAS;IAC5B,oBAAoB,EAAE,SAAS;IAC/B,uBAAuB,EAAE,SAAS;CACnC,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,cAAc,CAAC,QAAQ,CAAC,CAAC;AAClC,CAAC"}

package/dist/tools/styx.tools.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Styx BTC→sBTC conversion tools
+ *
+ * Headless BTC→sBTC conversion via the Styx protocol (btc2sbtc.com).
+ * Uses @faktoryfun/styx-sdk for deposit reservation and tracking,
+ * @scure/btc-signer for local PSBT construction and signing,
+ * mempool.space for broadcast.
+ *
+ * Tools:
+ * - styx_pool_status: Pool liquidity info
+ * - styx_pools: All available pools
+ * - styx_fees: Bitcoin fee estimates
+ * - styx_price: BTC price in USD
+ * - styx_deposit: Full headless deposit flow
+ * - styx_status: Deposit status by ID or txid
+ * - styx_history: Deposit history for a Stacks address
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerStyxTools(server: McpServer): void;
+//# sourceMappingURL=styx.tools.d.ts.map

package/dist/tools/styx.tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styx.tools.d.ts","sourceRoot":"","sources":["../../src/tools/styx.tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA2BpE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0bzD"}

package/dist/tools/styx.tools.js

@@ -0,0 +1,401 @@
+/**
+ * Styx BTC→sBTC conversion tools
+ *
+ * Headless BTC→sBTC conversion via the Styx protocol (btc2sbtc.com).
+ * Uses @faktoryfun/styx-sdk for deposit reservation and tracking,
+ * @scure/btc-signer for local PSBT construction and signing,
+ * mempool.space for broadcast.
+ *
+ * Tools:
+ * - styx_pool_status: Pool liquidity info
+ * - styx_pools: All available pools
+ * - styx_fees: Bitcoin fee estimates
+ * - styx_price: BTC price in USD
+ * - styx_deposit: Full headless deposit flow
+ * - styx_status: Deposit status by ID or txid
+ * - styx_history: Deposit history for a Stacks address
+ */
+import { z } from "zod";
+import * as btc from "@scure/btc-signer";
+import { hex } from "@scure/base";
+import { styxSDK, MIN_DEPOSIT_SATS, } from "@faktoryfun/styx-sdk";
+import { NETWORK } from "../config/networks.js";
+import { createJsonResponse, createErrorResponse } from "../utils/index.js";
+import { getWalletManager } from "../services/wallet-manager.js";
+import { MempoolApi, getMempoolTxUrl } from "../services/mempool-api.js";
+import { OrdinalIndexer } from "../services/ordinal-indexer.js";
+const FEE_PRIORITIES = ["low", "medium", "high"];
+function getBtcNetwork() {
+    return NETWORK === "testnet" ? btc.TEST_NETWORK : btc.NETWORK;
+}
+export function registerStyxTools(server) {
+    // ---------------------------------------------------------------------------
+    // styx_pool_status
+    // ---------------------------------------------------------------------------
+    server.registerTool("styx_pool_status", {
+        description: "Get current Styx pool liquidity and status. " +
+            "Shows realAvailable and estimatedAvailable BTC in the pool.",
+        inputSchema: {
+            pool: z
+                .string()
+                .optional()
+                .describe('Pool ID: "main" (300k sat max) or "aibtc" (1M sat max). Defaults to "main".'),
+        },
+    }, async ({ pool = "main" }) => {
+        try {
+            const status = await styxSDK.getPoolStatus(pool);
+            return createJsonResponse({
+                pool,
+                realAvailable: status.realAvailable,
+                estimatedAvailable: status.estimatedAvailable,
+                estimatedAvailableSats: Math.round(status.estimatedAvailable * 1e8),
+                lastUpdated: status.lastUpdated,
+                network: NETWORK,
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // styx_pools
+    // ---------------------------------------------------------------------------
+    server.registerTool("styx_pools", {
+        description: "List all available Styx pools with their configurations. " +
+            "Pools: main (up to 300k sats, sbtc/usda/pepe), aibtc (up to 1M sats, sbtc/aibtc). " +
+            "Minimum deposit: 10,000 sats for both pools.",
+        inputSchema: {},
+    }, async () => {
+        try {
+            const pools = await styxSDK.getAvailablePools();
+            return createJsonResponse({ pools, network: NETWORK });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // styx_fees
+    // ---------------------------------------------------------------------------
+    server.registerTool("styx_fees", {
+        description: "Get current Bitcoin network fee estimates (sat/vB) from Styx: low, medium, high.",
+        inputSchema: {},
+    }, async () => {
+        try {
+            const fees = await styxSDK.getFeeEstimates();
+            return createJsonResponse({ ...fees, network: NETWORK });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // styx_price
+    // ---------------------------------------------------------------------------
+    server.registerTool("styx_price", {
+        description: "Get current BTC price in USD from Styx.",
+        inputSchema: {},
+    }, async () => {
+        try {
+            const price = await styxSDK.getBTCPrice();
+            return createJsonResponse({ priceUsd: price, network: NETWORK });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // styx_deposit
+    // ---------------------------------------------------------------------------
+    server.registerTool("styx_deposit", {
+        description: "Full headless BTC→sBTC deposit via the Styx protocol. " +
+            "Flow: reserve pool liquidity → build PSBT locally → sign with wallet keys → " +
+            "broadcast to mempool.space → update deposit status. " +
+            "Requires an unlocked wallet with sufficient BTC balance. " +
+            "On mainnet, ordinal UTXOs are automatically filtered out to protect inscriptions. " +
+            "Minimum deposit: 10,000 sats. Pool limits: main=300k sats, aibtc=1M sats.",
+        inputSchema: {
+            amount: z
+                .coerce
+                .number()
+                .int()
+                .min(MIN_DEPOSIT_SATS)
+                .describe(`Amount to deposit in satoshis (min ${MIN_DEPOSIT_SATS}). Example: 50000`),
+            stxReceiver: z
+                .string()
+                .optional()
+                .describe("Stacks address to receive sBTC. Uses active wallet address if omitted."),
+            btcSender: z
+                .string()
+                .optional()
+                .describe("BTC address sending funds. Must match the active wallet's BTC address. " +
+                "Uses active wallet if omitted."),
+            pool: z
+                .string()
+                .optional()
+                .describe('Pool ID: "main" or "aibtc". Defaults to "main".'),
+            fee: z
+                .enum(["low", "medium", "high"])
+                .optional()
+                .describe('Fee priority: "low", "medium", or "high". Defaults to "medium".'),
+        },
+    }, async ({ amount, stxReceiver, btcSender, pool = "main", fee = "medium" }) => {
+        let depositId;
+        let broadcastTxid;
+        try {
+            // amount is validated by z.coerce.number().int().min(MIN_DEPOSIT_SATS) — no manual checks needed
+            const amountSats = amount;
+            // Validate fee priority (belt-and-suspenders since zod enum already validates)
+            const feePriority = fee;
+            if (!FEE_PRIORITIES.includes(feePriority)) {
+                throw new Error(`Invalid fee value "${fee}". Must be one of: ${FEE_PRIORITIES.join(", ")}`);
+            }
+            // Get wallet
+            const walletManager = getWalletManager();
+            const account = walletManager.getActiveAccount();
+            if (!account) {
+                throw new Error("Wallet is not unlocked. Unlock your wallet first.");
+            }
+            if (!account.btcAddress || !account.btcPrivateKey || !account.btcPublicKey) {
+                throw new Error("Bitcoin keys not available. Unlock your wallet again.");
+            }
+            // Validate btcSender if provided — must match the active wallet
+            if (btcSender && btcSender !== account.btcAddress) {
+                throw new Error(`btcSender "${btcSender}" must match the active wallet BTC address ` +
+                    `(${account.btcAddress}). This tool signs with the active wallet's keys.`);
+            }
+            const resolvedBtcSender = account.btcAddress;
+            const resolvedStxReceiver = stxReceiver || account.address;
+            // Check pool liquidity
+            const poolStatus = await styxSDK.getPoolStatus(pool);
+            const availableSats = Math.round(poolStatus.estimatedAvailable * 1e8);
+            if (amountSats > availableSats) {
+                throw new Error(`Insufficient pool liquidity: need ${amountSats} sats, pool has ~${availableSats} sats`);
+            }
+            // Step 1: Reserve pool liquidity
+            const btcAmount = (amountSats / 1e8).toFixed(8);
+            depositId = await styxSDK.createDeposit({
+                btcAmount: parseFloat(btcAmount),
+                stxReceiver: resolvedStxReceiver,
+                btcSender: resolvedBtcSender,
+                poolId: pool,
+            });
+            // Step 2: Prepare transaction (UTXOs, deposit address, OP_RETURN)
+            const prepared = await styxSDK.prepareTransaction({
+                amount: btcAmount,
+                userAddress: resolvedStxReceiver,
+                btcAddress: resolvedBtcSender,
+                feePriority,
+                walletProvider: null,
+                poolId: pool,
+            });
+            // Step 3: Filter ordinal UTXOs on mainnet to protect inscriptions
+            let safeUtxos = prepared.utxos;
+            let ordinalsFiltered = false;
+            if (NETWORK === "mainnet") {
+                const indexer = new OrdinalIndexer(NETWORK);
+                const cardinalUtxos = await indexer.getCardinalUtxos(resolvedBtcSender);
+                const cardinalSet = new Set(cardinalUtxos.map((u) => `${u.txid}:${u.vout}`));
+                const filtered = prepared.utxos.filter((u) => cardinalSet.has(`${u.txid}:${u.vout}`));
+                if (filtered.length < prepared.utxos.length) {
+                    const removed = prepared.utxos.length - filtered.length;
+                    if (filtered.length === 0) {
+                        throw new Error(`All ${removed} UTXO(s) selected by Styx contain inscriptions. ` +
+                            "Cannot deposit without risking inscription loss.");
+                    }
+                    // Recompute change after removing ordinal inputs
+                    const originalTotal = prepared.utxos.reduce((sum, u) => sum + u.value, 0);
+                    const filteredTotal = filtered.reduce((sum, u) => sum + u.value, 0);
+                    const originalFee = originalTotal - prepared.amountInSatoshis - prepared.changeAmount;
+                    if (originalFee < 0) {
+                        throw new Error("Invalid Styx transaction preparation: negative implied fee.");
+                    }
+                    const requiredTotal = prepared.amountInSatoshis + originalFee;
+                    if (filteredTotal < requiredTotal) {
+                        throw new Error(`After removing ${removed} ordinal UTXO(s), remaining cardinal balance ` +
+                            `(${filteredTotal} sats) is insufficient for deposit (${amountSats} sats) ` +
+                            `and fee (${originalFee} sats).`);
+                    }
+                    prepared.changeAmount =
+                        filteredTotal - prepared.amountInSatoshis - originalFee;
+                    ordinalsFiltered = true;
+                }
+                safeUtxos = filtered;
+            }
+            // Step 4: Build PSBT locally with @scure/btc-signer
+            const btcNetwork = getBtcNetwork();
+            const tx = new btc.Transaction({ allowUnknownOutputs: true });
+            const senderP2wpkh = btc.p2wpkh(account.btcPublicKey, btcNetwork);
+            for (const utxo of safeUtxos) {
+                tx.addInput({
+                    txid: utxo.txid,
+                    index: utxo.vout,
+                    witnessUtxo: {
+                        script: senderP2wpkh.script,
+                        amount: BigInt(utxo.value),
+                    },
+                });
+            }
+            // OP_RETURN output FIRST (output index 0) — Styx contract requires OP_RETURN at index 0
+            // Styx SDK provides a full script hex (starts with 6a = OP_RETURN opcode)
+            if (prepared.opReturnData) {
+                tx.addOutput({
+                    script: hex.decode(prepared.opReturnData),
+                    amount: BigInt(0),
+                });
+            }
+            // Deposit output to Styx address (output index 1)
+            tx.addOutputAddress(prepared.depositAddress, BigInt(prepared.amountInSatoshis), btcNetwork);
+            // Change output
+            if (prepared.changeAmount > 0) {
+                tx.addOutputAddress(resolvedBtcSender, BigInt(prepared.changeAmount), btcNetwork);
+            }
+            // Step 5: Sign and finalize
+            tx.sign(account.btcPrivateKey);
+            tx.finalize();
+            // Step 6: Broadcast
+            const mempoolApi = new MempoolApi(NETWORK);
+            broadcastTxid = await mempoolApi.broadcastTransaction(tx.hex);
+            // Step 7: Update deposit status (retry once on failure)
+            let statusUpdateWarning;
+            const statusPayload = {
+                id: depositId,
+                data: { btcTxId: broadcastTxid, status: "broadcast" },
+            };
+            try {
+                await styxSDK.updateDepositStatus(statusPayload);
+            }
+            catch (statusError) {
+                try {
+                    await styxSDK.updateDepositStatus(statusPayload);
+                }
+                catch {
+                    statusUpdateWarning =
+                        "Deposit broadcast succeeded but status update failed after retry. " +
+                            "Save depositId and txid for manual recovery. " +
+                            (statusError instanceof Error
+                                ? statusError.message
+                                : String(statusError));
+                }
+            }
+            return createJsonResponse({
+                success: true,
+                depositId,
+                txid: broadcastTxid,
+                explorerUrl: getMempoolTxUrl(broadcastTxid, NETWORK),
+                amount: { sats: amountSats, btc: btcAmount },
+                pool,
+                depositAddress: prepared.depositAddress,
+                // fee/feeRate are omitted when ordinal filtering occurred — those values were
+                // computed against the original UTXO set and no longer reflect the actual tx
+                ...(ordinalsFiltered
+                    ? { feeNote: "fee metadata omitted — UTXO set was filtered for ordinals" }
+                    : { fee: prepared.fee, feeRate: prepared.feeRate }),
+                status: "broadcast",
+                network: NETWORK,
+                note: "sBTC will be credited to your Stacks address after Bitcoin confirmation.",
+                ...(statusUpdateWarning ? { warning: statusUpdateWarning } : {}),
+            });
+        }
+        catch (error) {
+            // Best-effort: cancel reservation if we never broadcast
+            if (depositId && !broadcastTxid) {
+                try {
+                    await styxSDK.updateDepositStatus({
+                        id: depositId,
+                        data: { status: "canceled" },
+                    });
+                }
+                catch {
+                    // Reservation will expire server-side; don't mask the original error
+                }
+            }
+            return createErrorResponse(error);
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // styx_status
+    // ---------------------------------------------------------------------------
+    server.registerTool("styx_status", {
+        description: "Check the status of a Styx BTC→sBTC deposit by deposit ID or Bitcoin transaction ID.",
+        inputSchema: {
+            id: z.string().optional().describe("Styx deposit ID"),
+            txid: z.string().optional().describe("Bitcoin transaction ID"),
+        },
+    }, async ({ id, txid }) => {
+        try {
+            if (!id && !txid) {
+                throw new Error("Provide either id (deposit ID) or txid (Bitcoin transaction ID).");
+            }
+            let deposit;
+            if (id) {
+                deposit = await styxSDK.getDepositStatus(id);
+            }
+            else {
+                deposit = await styxSDK.getDepositStatusByTxId(txid);
+            }
+            return createJsonResponse({
+                id: deposit.id,
+                status: deposit.status,
+                btcAmount: deposit.btcAmount,
+                sbtcAmount: deposit.sbtcAmount,
+                stxReceiver: deposit.stxReceiver,
+                btcSender: deposit.btcSender,
+                btcTxId: deposit.btcTxId,
+                stxTxId: deposit.stxTxId,
+                createdAt: deposit.createdAt,
+                updatedAt: deposit.updatedAt,
+                network: NETWORK,
+                explorerUrl: deposit.btcTxId
+                    ? getMempoolTxUrl(deposit.btcTxId, NETWORK)
+                    : null,
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // ---------------------------------------------------------------------------
+    // styx_history
+    // ---------------------------------------------------------------------------
+    server.registerTool("styx_history", {
+        description: "Get BTC→sBTC deposit history for a Stacks address via Styx. " +
+            "Uses the active wallet's Stacks address if no address is provided.",
+        inputSchema: {
+            address: z
+                .string()
+                .optional()
+                .describe("Stacks address to query. Uses active wallet if omitted."),
+        },
+    }, async ({ address }) => {
+        try {
+            let resolvedAddress = address;
+            if (!resolvedAddress) {
+                const walletManager = getWalletManager();
+                const account = walletManager.getActiveAccount();
+                if (!account) {
+                    throw new Error("No address provided and wallet is not unlocked.");
+                }
+                resolvedAddress = account.address;
+            }
+            const deposits = await styxSDK.getDepositHistory(resolvedAddress);
+            return createJsonResponse({
+                address: resolvedAddress,
+                count: deposits.length,
+                network: NETWORK,
+                deposits: deposits.map((d) => ({
+                    id: d.id,
+                    status: d.status,
+                    btcAmount: d.btcAmount,
+                    sbtcAmount: d.sbtcAmount,
+                    btcTxId: d.btcTxId,
+                    createdAt: d.createdAt,
+                })),
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=styx.tools.js.map

package/dist/tools/styx.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styx.tools.js","sourceRoot":"","sources":["../../src/tools/styx.tools.ts"],"names":[],"mappings":"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"}

package/dist/utils/relay-health.d.ts

@@ -5,6 +5,11 @@
  * diagnostic information when send failures occur.
  */
 import type { Network } from "../config/networks.js";
+export interface StuckTransaction {
+    txid: string;
+    nonce: number;
+    pendingSeconds: number;
+}
 export interface RelayHealthStatus {
     healthy: boolean;
     network: Network;
@@ -18,7 +23,10 @@ export interface RelayHealthStatus {
         mempoolNonces: number[];
         hasGaps: boolean;
         gapCount: number;
+        mempoolDesync: boolean;
+        desyncGap: number;
     };
+    stuckTransactions?: StuckTransaction[];
     issues?: string[];
 }
 /**
@@ -29,6 +37,26 @@ export declare function checkRelayHealth(network: Network): Promise<RelayHealthS
  * Format relay health status as a human-readable string
  */
 export declare function formatRelayHealthStatus(status: RelayHealthStatus): string;
+export interface RelayRecoveryResult {
+    supported: boolean;
+    message?: string;
+    result?: unknown;
+}
+/**
+ * Attempt RBF (replace-by-fee) on stuck transactions via the relay API.
+ * If txids is provided, only those transactions are bumped; otherwise the relay
+ * bumps all stuck transactions it knows about.
+ *
+ * Gracefully returns { supported: false } if the relay returns 404 or 501.
+ */
+export declare function attemptRbf(network: Network, txids?: string[], apiKey?: string): Promise<RelayRecoveryResult>;
+/**
+ * Attempt to fill nonce gaps on the relay by having it submit placeholder transactions.
+ * If nonces is provided, only those gaps are filled; otherwise the relay fills all detected gaps.
+ *
+ * Gracefully returns { supported: false } if the relay returns 404 or 501.
+ */
+export declare function attemptFillGaps(network: Network, nonces?: number[], apiKey?: string): Promise<RelayRecoveryResult>;
 /**
  * Wait with exponential backoff when relay nonce issues are detected
  * Returns recommended wait time in milliseconds

package/dist/utils/relay-health.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"relay-health.d.ts","sourceRoot":"","sources":["../../src/utils/relay-health.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAGrD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE;QACZ,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAUD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAmFnF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAwCzE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,MAAM,CASnF"}
+{"version":3,"file":"relay-health.d.ts","sourceRoot":"","sources":["../../src/utils/relay-health.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAGrD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE;QACZ,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE,OAAO,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,iBAAiB,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACvC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAUD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA4HnF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAuDzE;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAiDlH;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAiDxH;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,MAAM,CASnF"}

package/dist/utils/relay-health.js

@@ -4,7 +4,7 @@
  * Proactively checks the sponsor relay for nonce gaps and provides
  * diagnostic information when send failures occur.
  */
-import { getSponsorRelayUrl } from "../config/sponsor.js";
+import { getSponsorRelayUrl, getSponsorApiKey } from "../config/sponsor.js";
 import { getHiroApi } from "../services/hiro-api.js";
 /**
  * Known sponsor addresses for each network.
@@ -53,27 +53,65 @@ export async function checkRelayHealth(network) {
         const nonceInfo = await hiroApi.getNonceInfo(sponsorAddress);
         const hasGaps = nonceInfo.detected_missing_nonces.length > 0;
         const gapCount = nonceInfo.detected_missing_nonces.length;
+        // Mempool desync: sponsor has submitted far more txs than have been confirmed
+        const lastExecuted = nonceInfo.last_executed_tx_nonce || 0;
+        const lastMempool = nonceInfo.last_mempool_tx_nonce;
+        const desyncGap = lastMempool !== null ? lastMempool - lastExecuted : 0;
+        const mempoolDesync = desyncGap > 5;
         if (hasGaps) {
             issues.push(`Sponsor has ${gapCount} missing nonce(s): ${nonceInfo.detected_missing_nonces.slice(0, 5).join(", ")}${gapCount > 5 ? "..." : ""}`);
         }
-        if (nonceInfo.detected_mempool_nonces.length > 10) {
+        if (mempoolDesync) {
+            issues.push(`Mempool desync detected: sponsor nonce ${lastExecuted} (executed) vs ${lastMempool} (mempool), gap of ${desyncGap}`);
+        }
+        else if (nonceInfo.detected_mempool_nonces.length > 10) {
             issues.push(`Sponsor has ${nonceInfo.detected_mempool_nonces.length} transactions stuck in mempool`);
         }
         const nonceStatus = {
-            lastExecuted: nonceInfo.last_executed_tx_nonce || 0,
-            lastMempool: nonceInfo.last_mempool_tx_nonce,
+            lastExecuted,
+            lastMempool,
             possibleNext: nonceInfo.possible_next_nonce,
             missingNonces: nonceInfo.detected_missing_nonces,
             mempoolNonces: nonceInfo.detected_mempool_nonces,
             hasGaps,
             gapCount,
+            mempoolDesync,
+            desyncGap,
         };
+        // Fetch stuck transactions from mempool for actionable diagnostics
+        let stuckTransactions;
+        try {
+            const mempoolRes = await hiroApi.getMempoolTransactions({
+                sender_address: sponsorAddress,
+                limit: 50,
+            });
+            const nowSeconds = Math.floor(Date.now() / 1000);
+            const stuck = mempoolRes.results
+                .filter((tx) => {
+                const pendingSeconds = nowSeconds - tx.receipt_time;
+                return pendingSeconds > 60;
+            })
+                .map((tx) => ({
+                txid: tx.tx_id,
+                nonce: tx.nonce,
+                pendingSeconds: nowSeconds - tx.receipt_time,
+            }))
+                .sort((a, b) => b.pendingSeconds - a.pendingSeconds)
+                .slice(0, 10);
+            if (stuck.length > 0) {
+                stuckTransactions = stuck;
+            }
+        }
+        catch {
+            // Non-fatal: stuck-tx fetch is best-effort
+        }
         return {
             healthy: issues.length === 0,
             network,
             version,
             sponsorAddress,
             nonceStatus,
+            stuckTransactions,
             issues: issues.length > 0 ? issues : undefined,
         };
     }
@@ -107,15 +145,28 @@ export function formatRelayHealthStatus(status) {
         lines.push(`  Last mempool: ${ns.lastMempool ?? "none"}`);
         lines.push(`  Next nonce: ${ns.possibleNext}`);
         if (ns.hasGaps) {
-            lines.push(`  ❌ Missing nonces (${ns.gapCount}): ${ns.missingNonces.slice(0, 10).join(", ")}${ns.gapCount > 10 ? "..." : ""}`);
+            lines.push(`  GAPS Missing nonces (${ns.gapCount}): ${ns.missingNonces.slice(0, 10).join(", ")}${ns.gapCount > 10 ? "..." : ""}`);
         }
         else {
-            lines.push("  ✅ No nonce gaps");
+            lines.push("  OK No nonce gaps");
+        }
+        if (ns.mempoolDesync) {
+            lines.push(`  DESYNC Mempool desync: executed=${ns.lastExecuted}, mempool=${ns.lastMempool ?? "none"}, gap=${ns.desyncGap}`);
         }
         if (ns.mempoolNonces.length > 0) {
-            lines.push(`  ⚠️  Mempool nonces (${ns.mempoolNonces.length}): ${ns.mempoolNonces.slice(0, 10).join(", ")}${ns.mempoolNonces.length > 10 ? "..." : ""}`);
+            lines.push(`  WARN Mempool nonces (${ns.mempoolNonces.length}): ${ns.mempoolNonces.slice(0, 10).join(", ")}${ns.mempoolNonces.length > 10 ? "..." : ""}`);
         }
     }
+    if (status.stuckTransactions && status.stuckTransactions.length > 0) {
+        lines.push("");
+        lines.push("Stuck Transactions:");
+        status.stuckTransactions.forEach((tx) => {
+            const minutes = Math.floor(tx.pendingSeconds / 60);
+            const seconds = tx.pendingSeconds % 60;
+            const duration = minutes > 0 ? `${minutes}m ${seconds}s` : `${seconds}s`;
+            lines.push(`  nonce=${tx.nonce} pending=${duration} txid=${tx.txid}`);
+        });
+    }
     if (status.issues && status.issues.length > 0) {
         lines.push("");
         lines.push("Issues:");
@@ -123,6 +174,105 @@ export function formatRelayHealthStatus(status) {
     }
     return lines.join("\n");
 }
+/**
+ * Attempt RBF (replace-by-fee) on stuck transactions via the relay API.
+ * If txids is provided, only those transactions are bumped; otherwise the relay
+ * bumps all stuck transactions it knows about.
+ *
+ * Gracefully returns { supported: false } if the relay returns 404 or 501.
+ */
+export async function attemptRbf(network, txids, apiKey) {
+    const relayUrl = getSponsorRelayUrl(network);
+    const resolvedKey = apiKey || getSponsorApiKey();
+    if (!resolvedKey) {
+        return {
+            supported: true,
+            message: "No sponsor API key available. Set SPONSOR_API_KEY env var or use a wallet with sponsorApiKey configured.",
+        };
+    }
+    const headers = {
+        "Content-Type": "application/json",
+        "Authorization": `Bearer ${resolvedKey}`,
+    };
+    const body = {};
+    if (txids && txids.length > 0) {
+        body.txids = txids;
+    }
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 30000);
+    try {
+        const res = await fetch(`${relayUrl}/recovery/rbf`, {
+            method: "POST",
+            headers,
+            body: JSON.stringify(body),
+            signal: controller.signal,
+        });
+        if (res.status === 404 || res.status === 501) {
+            return {
+                supported: false,
+                message: "Relay does not support RBF recovery yet. Share stuck txids with the AIBTC team for manual recovery.",
+            };
+        }
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`Relay RBF failed: HTTP ${res.status} — ${text}`);
+        }
+        const result = await res.json();
+        return { supported: true, result };
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+/**
+ * Attempt to fill nonce gaps on the relay by having it submit placeholder transactions.
+ * If nonces is provided, only those gaps are filled; otherwise the relay fills all detected gaps.
+ *
+ * Gracefully returns { supported: false } if the relay returns 404 or 501.
+ */
+export async function attemptFillGaps(network, nonces, apiKey) {
+    const relayUrl = getSponsorRelayUrl(network);
+    const resolvedKey = apiKey || getSponsorApiKey();
+    if (!resolvedKey) {
+        return {
+            supported: true,
+            message: "No sponsor API key available. Set SPONSOR_API_KEY env var or use a wallet with sponsorApiKey configured.",
+        };
+    }
+    const headers = {
+        "Content-Type": "application/json",
+        "Authorization": `Bearer ${resolvedKey}`,
+    };
+    const body = {};
+    if (nonces && nonces.length > 0) {
+        body.nonces = nonces;
+    }
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 30000);
+    try {
+        const res = await fetch(`${relayUrl}/recovery/fill-gaps`, {
+            method: "POST",
+            headers,
+            body: JSON.stringify(body),
+            signal: controller.signal,
+        });
+        if (res.status === 404 || res.status === 501) {
+            return {
+                supported: false,
+                message: "Relay does not support nonce gap-fill recovery yet. Share missing nonces with the AIBTC team for manual recovery.",
+            };
+        }
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`Relay gap-fill failed: HTTP ${res.status} — ${text}`);
+        }
+        const result = await res.json();
+        return { supported: true, result };
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
 /**
  * Wait with exponential backoff when relay nonce issues are detected
  * Returns recommended wait time in milliseconds

package/dist/utils/relay-health.js.map

@@ -1 +1 @@
-{"version":3,"file":"relay-health.js","sourceRoot":"","sources":["../../src/utils/relay-health.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"relay-health.js","sourceRoot":"","sources":["../../src/utils/relay-health.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aibtc/mcp-server",
-  "version": "1.33.4",
+  "version": "1.35.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",
@@ -44,6 +44,7 @@
   "license": "MIT",
   "dependencies": {
     "@bitflowlabs/core-sdk": "^3.0.0",
+    "@faktoryfun/styx-sdk": "^1.3.5",
     "@modelcontextprotocol/sdk": "^1.27.1",
     "@noble/curves": "^2.0.1",
     "@scure/base": "^2.0.0",

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