@aibtc/mcp-server 1.70.1 → 1.72.0

package/dist/tools/profiles.js

@@ -0,0 +1,111 @@
+/**
+ * Tool profiles: which tools the server exposes.
+ *
+ * Every tool definition is sent to the client's model on each session, so
+ * `--install` writes `AIBTC_TOOLS=core`: a lean set covering wallet, balances,
+ * transfers, x402 and earning. Other groups are added with
+ * `AIBTC_TOOLS=core,defi,ordinals` (the core set is always included).
+ *
+ * An unset AIBTC_TOOLS loads every tool: configs written before profiles
+ * existed have no AIBTC_TOOLS, and their users keep the tools they had.
+ */
+/** Tools exposed by default, whatever groups are enabled. */
+export const CORE_TOOLS = new Set([
+    // Wallet
+    "get_wallet_info",
+    "wallet_status",
+    "wallet_create",
+    "wallet_import",
+    "wallet_unlock",
+    "wallet_lock",
+    "wallet_export",
+    "wallet_rotate_password",
+    // Balances
+    "get_stx_balance",
+    "get_btc_balance",
+    "sbtc_get_balance",
+    "get_token_balance",
+    // Move funds
+    "transfer_stx",
+    "transfer_btc",
+    "sbtc_transfer",
+    "get_transaction_status",
+    "get_btc_fees",
+    // x402
+    "list_x402_endpoints",
+    "probe_x402_endpoint",
+    "execute_x402_endpoint",
+    // Earn (bounty_submit requires a registered identity)
+    "earning_opportunities",
+    "bounty_list",
+    "bounty_get",
+    "bounty_submit",
+    "identity_register",
+]);
+export const TOOL_GROUPS = {
+    wallet: "Wallet management extras, encrypted credential store",
+    stacks: "Stacks transactions, contracts, tokens, NFTs, chain queries, nonce tools",
+    sbtc: "sBTC deposit/withdraw, Styx BTC→sBTC",
+    bitcoin: "Bitcoin L1 UTXOs, mempool watch",
+    lightning: "Lightning (Spark) wallet and L402 payments",
+    stacking: "PoX stacking, dual stacking, StackSpot",
+    defi: "ALEX, Zest, Bitflow, Jingswap, yield hunter/dashboard, Tenero analytics",
+    pillar: "Pillar smart wallet",
+    ordinals: "Inscriptions, runes, PSBT, ordinals marketplace/P2P, taproot multisig",
+    bns: "BNS names",
+    identity: "ERC-8004 identity and reputation, message signing",
+    social: "Nostr, AIBTC inbox",
+    earn: "Bounty board (create, accept, pay, my views)",
+    legion: "AIBTC News Legion",
+    markets: "Stacks prediction market, At Stake",
+    dev: "Scaffolding, OpenRouter, settings, inference marketplace, arXiv",
+};
+export const ALL_TOOLS = { all: true };
+export function isToolGroup(name) {
+    return Object.prototype.hasOwnProperty.call(TOOL_GROUPS, name);
+}
+export function isToolSelected(selection, name, group) {
+    return selection.all || CORE_TOOLS.has(name) || selection.groups.has(group);
+}
+/**
+ * Resolve the selection from `--profile <lean|full>` and `AIBTC_TOOLS`
+ * (`all`, or `core` and/or comma-separated group names; unset means `all`).
+ * Unknown values throw so a typo doesn't silently hide tools.
+ */
+export function resolveToolSelection(argv = process.argv, env = process.env) {
+    const flag = argv.indexOf("--profile");
+    const profile = flag === -1 ? undefined : argv[flag + 1];
+    if (profile !== undefined && profile !== "lean" && profile !== "full") {
+        throw new Error(`Unknown --profile "${profile}". Use "lean" or "full".`);
+    }
+    if (profile === "full")
+        return ALL_TOOLS;
+    if (profile === "lean")
+        return { all: false, groups: new Set() };
+    const names = (env.AIBTC_TOOLS ?? "all")
+        .split(",")
+        .map((s) => s.trim().toLowerCase())
+        .filter((n) => n && n !== "core");
+    if (names.includes("all"))
+        return ALL_TOOLS;
+    const unknown = names.filter((n) => !isToolGroup(n));
+    if (unknown.length > 0) {
+        throw new Error(`Unknown AIBTC_TOOLS group(s): ${unknown.join(", ")}. ` +
+            `Valid: all, core, ${Object.keys(TOOL_GROUPS).join(", ")}.`);
+    }
+    return { all: false, groups: new Set(names) };
+}
+/** Server-instructions paragraph telling the agent what is off and how to turn it on. */
+export function describeSelection(selection) {
+    if (selection.all)
+        return "All tool groups are enabled.";
+    const off = Object.keys(TOOL_GROUPS).filter((g) => !selection.groups.has(g));
+    const on = [...selection.groups];
+    return [
+        `Tool profile: lean core${on.length > 0 ? ` + ${on.join(", ")}` : ""}.`,
+        "These groups are not loaded; if the user needs one, tell them to set",
+        "AIBTC_TOOLS=core,<group,...> (or all) in this server's config and restart:",
+        ...off.map((g) => `- ${g}: ${TOOL_GROUPS[g]}`),
+    ].join("\n");
+}
+//# sourceMappingURL=profiles.js.map

package/dist/tools/psbt.tools.d.ts

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

package/dist/tools/psbt.tools.js

@@ -71,7 +71,7 @@ export function registerPsbtTools(server) {
     server.registerTool("psbt_create_ordinal_buy", {
         description: "Create a PSBT for buying an ordinal: buyer pays seller in BTC, seller's inscription UTXO is transferred to buyer. " +
             "This prepares the PSBT for both parties to sign.",
-        inputSchema: {
+        inputSchema: z.object({
             inscriptionUtxo: z
                 .string()
                 .describe("Seller inscription outpoint in txid:vout format"),
@@ -89,7 +89,7 @@ export function registerPsbtTools(server) {
                 .optional()
                 .default("medium")
                 .describe("Fee rate: 'fast' (~10 min), 'medium' (~30 min), 'slow' (~1 hr), or explicit sat/vB"),
-        },
+        }),
     }, async ({ inscriptionUtxo, sellerAddress, priceSats, buyerReceiveAddress, feeRate }) => {
         try {
             const walletManager = getWalletManager();
@@ -214,7 +214,7 @@ export function registerPsbtTools(server) {
     });
     server.registerTool("psbt_sign", {
         description: "Sign one or more PSBT inputs with the active wallet. Supports buyer (P2WPKH) and taproot keys.",
-        inputSchema: {
+        inputSchema: z.object({
             psbtBase64: z.string().describe("PSBT in base64 format"),
             signInputs: z
                 .array(z.number().int().nonnegative())
@@ -225,7 +225,7 @@ export function registerPsbtTools(server) {
                 .optional()
                 .default(false)
                 .describe("Finalize only the inputs signed in this call"),
-        },
+        }),
     }, async ({ psbtBase64, signInputs, finalizeSignedInputs }) => {
         try {
             const walletManager = getWalletManager();
@@ -299,9 +299,9 @@ export function registerPsbtTools(server) {
     });
     server.registerTool("psbt_broadcast", {
         description: "Finalize a fully signed PSBT and broadcast it to the Bitcoin network via mempool.space.",
-        inputSchema: {
+        inputSchema: z.object({
             psbtBase64: z.string().describe("Fully signed PSBT in base64 format"),
-        },
+        }),
     }, async ({ psbtBase64 }) => {
         try {
             const tx = decodePsbtBase64(psbtBase64);
@@ -324,9 +324,9 @@ export function registerPsbtTools(server) {
     });
     server.registerTool("psbt_decode", {
         description: "Decode a PSBT to inspect inputs, outputs, signatures, and signing status before broadcast.",
-        inputSchema: {
+        inputSchema: z.object({
             psbtBase64: z.string().describe("PSBT in base64 format"),
-        },
+        }),
     }, async ({ psbtBase64 }) => {
         try {
             const tx = decodePsbtBase64(psbtBase64);

package/dist/tools/query.tools.d.ts

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

package/dist/tools/query.tools.js

@@ -78,12 +78,12 @@ export function registerQueryTools(server) {
     // Get account info
     server.registerTool("get_account_info", {
         description: "Get detailed account information including nonce and balance.",
-        inputSchema: {
+        inputSchema: z.object({
             address: z
                 .string()
                 .optional()
                 .describe("Stacks address. Uses configured wallet if not provided."),
-        },
+        }),
     }, async ({ address }) => {
         try {
             const hiro = getHiroApi(NETWORK);
@@ -104,14 +104,14 @@ export function registerQueryTools(server) {
     // Get account transactions
     server.registerTool("get_account_transactions", {
         description: "Get transaction history for an account.",
-        inputSchema: {
+        inputSchema: z.object({
             address: z
                 .string()
                 .optional()
                 .describe("Stacks address. Uses configured wallet if not provided."),
             limit: z.number().optional().default(20).describe("Maximum number of results"),
             offset: z.number().optional().default(0).describe("Offset for pagination"),
-        },
+        }),
     }, async ({ address, limit, offset }) => {
         try {
             const hiro = getHiroApi(NETWORK);
@@ -140,9 +140,9 @@ export function registerQueryTools(server) {
     // Get block info
     server.registerTool("get_block_info", {
         description: "Get information about a specific block.",
-        inputSchema: {
+        inputSchema: z.object({
             heightOrHash: z.string().describe("Block height (number) or block hash"),
-        },
+        }),
     }, async ({ heightOrHash }) => {
         try {
             const hiro = getHiroApi(NETWORK);
@@ -167,11 +167,11 @@ export function registerQueryTools(server) {
     // Get mempool info
     server.registerTool("get_mempool_info", {
         description: "Get pending transactions in the mempool.",
-        inputSchema: {
+        inputSchema: z.object({
             senderAddress: z.string().optional().describe("Filter by sender address"),
             limit: z.number().optional().default(20).describe("Maximum number of results"),
             offset: z.number().optional().default(0).describe("Offset for pagination"),
-        },
+        }),
     }, async ({ senderAddress, limit, offset }) => {
         try {
             const hiro = getHiroApi(NETWORK);
@@ -200,9 +200,9 @@ export function registerQueryTools(server) {
     // Get contract info
     server.registerTool("get_contract_info", {
         description: "Get information about a smart contract including its ABI.",
-        inputSchema: {
+        inputSchema: z.object({
             contractId: z.string().describe("Contract ID in format: address.contract-name"),
-        },
+        }),
     }, async ({ contractId }) => {
         try {
             const hiro = getHiroApi(NETWORK);
@@ -232,11 +232,11 @@ export function registerQueryTools(server) {
     // Get contract events
     server.registerTool("get_contract_events", {
         description: "Get events emitted by a smart contract.",
-        inputSchema: {
+        inputSchema: z.object({
             contractId: z.string().describe("Contract ID in format: address.contract-name"),
             limit: z.number().optional().default(20).describe("Maximum number of results"),
             offset: z.number().optional().default(0).describe("Offset for pagination"),
-        },
+        }),
     }, async ({ contractId, limit, offset }) => {
         try {
             const hiro = getHiroApi(NETWORK);

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

@@ -3,6 +3,6 @@
  *
  * Tools for checking sponsor relay health and diagnosing nonce issues
  */
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { McpServer } from "@modelcontextprotocol/server";
 export declare function registerRelayDiagnosticTools(server: McpServer): void;
 //# sourceMappingURL=relay-diagnostic.tools.d.ts.map

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

@@ -23,7 +23,7 @@ Use this tool for operator diagnostics around relay-owned sponsor state. It will
 
 This tool does not redefine caller-facing x402 payment states. Use paymentId
 polling for payment lifecycle truth; use this output only as backup diagnostics.`,
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         try {
             const status = await checkRelayHealth(NETWORK);
@@ -57,7 +57,7 @@ Recovery modes:
 If the relay does not yet support relay 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: {
+        inputSchema: z.object({
             action: z
                 .enum(["rbf", "fill-gaps", "both", "resync-local-nonce"])
                 .default("both")
@@ -70,7 +70,7 @@ share the txids and nonces from check_relay_health with the AIBTC team.`,
                 .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

package/dist/tools/reputation.tools.d.ts

@@ -19,6 +19,6 @@
  * - reputation_append_response   - Append a response to received feedback
  * - reputation_approve_client    - Approve a client with index limit
  */
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { McpServer } from "@modelcontextprotocol/server";
 export declare function registerReputationTools(server: McpServer): void;
 //# sourceMappingURL=reputation.tools.d.ts.map

package/dist/tools/reputation.tools.js

@@ -42,9 +42,9 @@ export function registerReputationTools(server) {
         description: "Get aggregated reputation summary for an agent from the ERC-8004 reputation registry. " +
             "Returns average rating as a WAD string (18 decimals) and total feedback count. " +
             "No wallet required.",
-        inputSchema: {
+        inputSchema: z.object({
             agentId: z.number().int().min(0).describe("Agent ID to get reputation summary for"),
-        },
+        }),
     }, async ({ agentId }) => {
         try {
             const callerAddress = getCallerAddress();
@@ -78,10 +78,10 @@ export function registerReputationTools(server) {
         description: "Read a specific feedback entry for an agent by index from the ERC-8004 reputation registry. " +
             "Returns client address, value, decimals, tags, and timestamp. " +
             "No wallet required.",
-        inputSchema: {
+        inputSchema: z.object({
             agentId: z.number().int().min(0).describe("Agent ID to read feedback for"),
             index: z.number().int().min(0).describe("Feedback index to read"),
-        },
+        }),
     }, async ({ agentId, index }) => {
         try {
             const callerAddress = getCallerAddress();
@@ -120,7 +120,7 @@ export function registerReputationTools(server) {
             "WARNING: Uses one RPC call per entry (N+1 pattern) — avoid calling for agents with " +
             "large feedback sets without using cursor-based pagination. " +
             "No wallet required.",
-        inputSchema: {
+        inputSchema: z.object({
             agentId: z.number().int().min(0).describe("Agent ID to read all feedback for"),
             tag1: z.string().optional().describe("Filter by tag1 (exact match). Optional."),
             tag2: z.string().optional().describe("Filter by tag2 (exact match). Optional."),
@@ -136,7 +136,7 @@ export function registerReputationTools(server) {
                 .optional()
                 .default(0)
                 .describe("Pagination cursor (index to start from). Default 0."),
-        },
+        }),
     }, async ({ agentId, tag1, tag2, includeRevoked, cursor }) => {
         try {
             const callerAddress = getCallerAddress();
@@ -160,7 +160,7 @@ export function registerReputationTools(server) {
         description: "Get a paginated list of clients who gave feedback to an agent. " +
             "Returns client addresses and a nextCursor for pagination. " +
             "No wallet required.",
-        inputSchema: {
+        inputSchema: z.object({
             agentId: z.number().int().min(0).describe("Agent ID to get clients for"),
             cursor: z
                 .number()
@@ -169,7 +169,7 @@ export function registerReputationTools(server) {
                 .optional()
                 .default(0)
                 .describe("Pagination cursor. Default 0."),
-        },
+        }),
     }, async ({ agentId, cursor }) => {
         try {
             const callerAddress = getCallerAddress();
@@ -192,9 +192,9 @@ export function registerReputationTools(server) {
     server.registerTool("reputation_get_feedback_count", {
         description: "Get the total number of feedback entries for an agent from the ERC-8004 reputation registry. " +
             "No wallet required.",
-        inputSchema: {
+        inputSchema: z.object({
             agentId: z.number().int().min(0).describe("Agent ID to get feedback count for"),
-        },
+        }),
     }, async ({ agentId }) => {
         try {
             const callerAddress = getCallerAddress();
@@ -215,10 +215,10 @@ export function registerReputationTools(server) {
         description: "Get the approved feedback index limit for a specific client of an agent. " +
             "Returns the maximum index up to which the client is approved to submit feedback. " +
             "No wallet required.",
-        inputSchema: {
+        inputSchema: z.object({
             agentId: z.number().int().min(0).describe("Agent ID"),
             client: stacksAddressSchema,
-        },
+        }),
     }, async ({ agentId, client }) => {
         try {
             const callerAddress = getCallerAddress();
@@ -240,10 +240,10 @@ export function registerReputationTools(server) {
     server.registerTool("reputation_get_last_index", {
         description: "Get the last feedback index submitted by a specific client for an agent. " +
             "No wallet required.",
-        inputSchema: {
+        inputSchema: z.object({
             agentId: z.number().int().min(0).describe("Agent ID"),
             client: stacksAddressSchema,
-        },
+        }),
     }, async ({ agentId, client }) => {
         try {
             const callerAddress = getCallerAddress();
@@ -269,7 +269,7 @@ export function registerReputationTools(server) {
         description: "Submit feedback for an agent using the ERC-8004 reputation registry. " +
             "Value is normalized to 18 decimals (WAD) internally for aggregation. " +
             "Requires an unlocked wallet.",
-        inputSchema: {
+        inputSchema: z.object({
             agentId: z.number().int().min(0).describe("Agent ID to give feedback for"),
             value: z
                 .number()
@@ -295,7 +295,7 @@ export function registerReputationTools(server) {
                 .optional()
                 .describe('Fee preset ("low", "medium", "high") or micro-STX amount. Optional.'),
             sponsored: sponsoredSchema,
-        },
+        }),
     }, async ({ agentId, value, valueDecimals, tag1, tag2, endpoint, feedbackUri, feedbackHash, fee, sponsored }) => {
         try {
             const walletManager = getWalletManager();
@@ -328,7 +328,7 @@ export function registerReputationTools(server) {
         description: "Revoke a previously submitted feedback entry by index. " +
             "Only the original submitter can revoke their feedback. " +
             "Requires an unlocked wallet.",
-        inputSchema: {
+        inputSchema: z.object({
             agentId: z.number().int().min(0).describe("Agent ID the feedback was given for"),
             index: z.number().int().min(0).describe("Feedback index to revoke"),
             fee: z
@@ -336,7 +336,7 @@ export function registerReputationTools(server) {
                 .optional()
                 .describe('Fee preset ("low", "medium", "high") or micro-STX amount. Optional.'),
             sponsored: sponsoredSchema,
-        },
+        }),
     }, async ({ agentId, index, fee, sponsored }) => {
         try {
             const walletManager = getWalletManager();
@@ -365,7 +365,7 @@ export function registerReputationTools(server) {
         description: "Append a response to feedback received from a client. " +
             "Must be called by the agent that received the feedback. " +
             "Requires an unlocked wallet.",
-        inputSchema: {
+        inputSchema: z.object({
             agentId: z.number().int().min(0).describe("Agent ID that received the feedback"),
             client: stacksAddressSchema,
             index: z.number().int().min(0).describe("Feedback index to respond to"),
@@ -376,7 +376,7 @@ export function registerReputationTools(server) {
                 .optional()
                 .describe('Fee preset ("low", "medium", "high") or micro-STX amount. Optional.'),
             sponsored: sponsoredSchema,
-        },
+        }),
     }, async ({ agentId, client, index, responseUri, responseHash, fee, sponsored }) => {
         try {
             const walletManager = getWalletManager();
@@ -407,7 +407,7 @@ export function registerReputationTools(server) {
         description: "Approve a client to submit feedback up to a specified index limit. " +
             "Must be called by the agent owner. " +
             "Requires an unlocked wallet.",
-        inputSchema: {
+        inputSchema: z.object({
             agentId: z.number().int().min(0).describe("Agent ID to approve a client for"),
             client: stacksAddressSchema,
             indexLimit: z
@@ -420,7 +420,7 @@ export function registerReputationTools(server) {
                 .optional()
                 .describe('Fee preset ("low", "medium", "high") or micro-STX amount. Optional.'),
             sponsored: sponsoredSchema,
-        },
+        }),
     }, async ({ agentId, client, indexLimit, fee, sponsored }) => {
         try {
             const walletManager = getWalletManager();

package/dist/tools/runes.tools.d.ts

@@ -20,6 +20,6 @@
  * Set HIRO_API_KEY to increase Hiro rate limits.
  * Set UNISAT_API_KEY for Unisat indexer access (5 req/s free tier).
  */
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { McpServer } from "@modelcontextprotocol/server";
 export declare function registerRunesTools(server: McpServer): void;
 //# sourceMappingURL=runes.tools.d.ts.map

package/dist/tools/runes.tools.js

@@ -71,7 +71,7 @@ export function registerRunesTools(server) {
             "Returns rune names, IDs, supply, divisibility, symbol, etching transaction, " +
             "and other metadata for each rune.\n\n" +
             "Use runes_get_etching to get full details on a specific rune.",
-        inputSchema: {
+        inputSchema: z.object({
             limit: z
                 .number()
                 .int()
@@ -85,7 +85,7 @@ export function registerRunesTools(server) {
                 .min(0)
                 .optional()
                 .describe("Number of results to skip for pagination (default: 0)"),
-        },
+        }),
     }, async ({ limit = 20, offset = 0 }) => {
         try {
             const data = await runesApiFetch(`/runes/v1/etchings?limit=${limit}&offset=${offset}`);
@@ -103,11 +103,11 @@ export function registerRunesTools(server) {
             "Returns name, ID, supply info, divisibility, symbol, etching transaction, " +
             "cenotaph status, terms (mint conditions), and turbo flag.\n\n" +
             "Rune names use spacers (e.g., 'UNCOMMONGOODS' or 'UNCOMMON•GOODS').",
-        inputSchema: {
+        inputSchema: z.object({
             rune: z
                 .string()
                 .describe("Rune name (e.g., 'UNCOMMONGOODS' or 'UNCOMMON•GOODS') or numeric rune ID"),
-        },
+        }),
     }, async ({ rune }) => {
         try {
             const encoded = encodeURIComponent(rune);
@@ -125,7 +125,7 @@ export function registerRunesTools(server) {
         description: "Get the list of holders for a specific Bitcoin Rune.\n\n" +
             "Returns Bitcoin addresses and their rune balances, sorted by balance descending.\n\n" +
             "Supports pagination for runes with many holders.",
-        inputSchema: {
+        inputSchema: z.object({
             rune: z
                 .string()
                 .describe("Rune name (e.g., 'UNCOMMONGOODS' or 'UNCOMMON•GOODS') or numeric rune ID"),
@@ -142,7 +142,7 @@ export function registerRunesTools(server) {
                 .min(0)
                 .optional()
                 .describe("Number of results to skip for pagination (default: 0)"),
-        },
+        }),
     }, async ({ rune, limit = 20, offset = 0 }) => {
         try {
             const encoded = encodeURIComponent(rune);
@@ -160,7 +160,7 @@ export function registerRunesTools(server) {
         description: "Get recent on-chain activity (mints, transfers, burns) for a specific Bitcoin Rune.\n\n" +
             "Returns transaction events with amounts, addresses, block heights, and timestamps.\n\n" +
             "Useful for monitoring rune distribution and trading activity.",
-        inputSchema: {
+        inputSchema: z.object({
             rune: z
                 .string()
                 .describe("Rune name (e.g., 'UNCOMMONGOODS' or 'UNCOMMON•GOODS') or numeric rune ID"),
@@ -177,7 +177,7 @@ export function registerRunesTools(server) {
                 .min(0)
                 .optional()
                 .describe("Number of results to skip for pagination (default: 0)"),
-        },
+        }),
     }, async ({ rune, limit = 20, offset = 0 }) => {
         try {
             const encoded = encodeURIComponent(rune);
@@ -196,11 +196,11 @@ export function registerRunesTools(server) {
             "Returns each rune the address holds along with its balance, divisibility, " +
             "and symbol. Useful for checking which runes a wallet owns.\n\n" +
             "Address can be any Bitcoin address format (P2WPKH bc1q..., P2TR bc1p..., legacy 1..., etc.)",
-        inputSchema: {
+        inputSchema: z.object({
             address: z
                 .string()
                 .describe("Bitcoin address to check rune balances for"),
-        },
+        }),
     }, async ({ address }) => {
         try {
             const encoded = encodeURIComponent(address);
@@ -219,7 +219,7 @@ export function registerRunesTools(server) {
             "Returns mints received, transfers sent/received, and burns associated with " +
             "this address across all runes.\n\n" +
             "Address can be any Bitcoin address format (P2WPKH bc1q..., P2TR bc1p..., legacy 1..., etc.)",
-        inputSchema: {
+        inputSchema: z.object({
             address: z
                 .string()
                 .describe("Bitcoin address to query rune activity for"),
@@ -236,7 +236,7 @@ export function registerRunesTools(server) {
                 .min(0)
                 .optional()
                 .describe("Number of results to skip for pagination (default: 0)"),
-        },
+        }),
     }, async ({ address, limit = 20, offset = 0 }) => {
         try {
             const encoded = encodeURIComponent(address);
@@ -255,12 +255,12 @@ export function registerRunesTools(server) {
             "Returns rune IDs, amounts, symbols, and divisibility for all runes at the address.\n\n" +
             "If no address is provided, uses the active wallet's Taproot address.\n" +
             "Set UNISAT_API_KEY for higher rate limits (5 req/s on free tier).",
-        inputSchema: {
+        inputSchema: z.object({
             address: z
                 .string()
                 .optional()
                 .describe("Bitcoin address to check (uses active wallet's Taproot address if omitted)"),
-        },
+        }),
     }, async ({ address }) => {
         try {
             let resolvedAddress = address;
@@ -303,7 +303,7 @@ export function registerRunesTools(server) {
         description: "List UTXOs containing a specific rune at a Bitcoin address via the Unisat indexer.\n\n" +
             "Rune ID format: 'block:tx' (e.g., '840000:1' for UNCOMMONGOODS).\n\n" +
             "If no address is provided, uses the active wallet's Taproot address.",
-        inputSchema: {
+        inputSchema: z.object({
             runeId: z
                 .string()
                 .describe("Rune ID in 'block:tx' format (e.g., '840000:1')"),
@@ -311,7 +311,7 @@ export function registerRunesTools(server) {
                 .string()
                 .optional()
                 .describe("Bitcoin address to check (uses active wallet's Taproot address if omitted)"),
-        },
+        }),
     }, async ({ runeId, address }) => {
         try {
             let resolvedAddress = address;
@@ -365,7 +365,7 @@ export function registerRunesTools(server) {
             "and returns remaining runes to the sender Taproot address.\n\n" +
             "Requires wallet to be unlocked. Amount is in smallest rune units (raw integer).\n" +
             "Uses Unisat indexer to fetch rune UTXOs (UNISAT_API_KEY recommended).",
-        inputSchema: {
+        inputSchema: z.object({
             runeId: z
                 .string()
                 .describe("Rune ID in 'block:tx' format (e.g., '840000:1')"),
@@ -379,7 +379,7 @@ export function registerRunesTools(server) {
                 .union([z.enum(["fast", "medium", "slow"]), z.number().positive()])
                 .optional()
                 .describe("Fee rate: 'fast' (~10 min), 'medium' (~30 min), 'slow' (~1 hr), or sat/vB number (default: medium)"),
-        },
+        }),
     }, async ({ runeId, amount, toAddress, feeRate }) => {
         try {
             const walletManager = getWalletManager();

package/dist/tools/sbtc.tools.d.ts

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