@aibtc/mcp-server 1.0.0

package/dist/tools/stacking.tools.js

@@ -0,0 +1,112 @@
+import { z } from "zod";
+import { getAccount, getWalletAddress, NETWORK } from "../services/x402.service.js";
+import { getStackingService } from "../services/stacking.service.js";
+import { getExplorerTxUrl } from "../config/networks.js";
+import { createJsonResponse, createErrorResponse } from "../utils/index.js";
+export function registerStackingTools(server) {
+    // Get PoX info
+    server.registerTool("get_pox_info", {
+        description: "Get current Proof of Transfer (PoX) cycle information.",
+    }, async () => {
+        try {
+            const stackingService = getStackingService(NETWORK);
+            const poxInfo = await stackingService.getPoxInfo();
+            return createJsonResponse({
+                network: NETWORK,
+                currentCycle: poxInfo.current_cycle,
+                nextCycle: poxInfo.next_cycle,
+                minAmountUstx: poxInfo.min_amount_ustx,
+                rewardCycleLength: poxInfo.reward_cycle_length,
+                prepareCycleLength: poxInfo.prepare_cycle_length,
+                currentBurnchainBlockHeight: poxInfo.current_burnchain_block_height,
+                totalLiquidSupplyUstx: poxInfo.total_liquid_supply_ustx,
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // Get stacking status
+    server.registerTool("get_stacking_status", {
+        description: "Check if an address is currently stacking STX.",
+        inputSchema: {
+            address: z
+                .string()
+                .optional()
+                .describe("Wallet address to check. Uses configured wallet if not provided."),
+        },
+    }, async ({ address }) => {
+        try {
+            const stackingService = getStackingService(NETWORK);
+            const walletAddress = address || (await getWalletAddress());
+            const status = await stackingService.getStackingStatus(walletAddress);
+            return createJsonResponse({
+                address: walletAddress,
+                network: NETWORK,
+                ...status,
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // Stack STX
+    server.registerTool("stack_stx", {
+        description: `Lock STX for stacking to earn BTC rewards.
+
+Requires a Bitcoin address (hash) for receiving rewards.`,
+        inputSchema: {
+            amount: z.string().describe("Amount of STX to stack (in micro-STX)"),
+            poxAddressVersion: z.number().describe("Bitcoin address version (0 for P2PKH, 1 for P2SH, etc.)"),
+            poxAddressHashbytes: z.string().describe("Bitcoin address hash (hex string)"),
+            startBurnHeight: z.number().describe("Bitcoin block height to start stacking"),
+            lockPeriod: z.number().min(1).max(12).describe("Number of reward cycles to lock (1-12)"),
+        },
+    }, async ({ amount, poxAddressVersion, poxAddressHashbytes, startBurnHeight, lockPeriod }) => {
+        try {
+            const stackingService = getStackingService(NETWORK);
+            const account = await getAccount();
+            const result = await stackingService.stack(account, BigInt(amount), { version: poxAddressVersion, hashbytes: poxAddressHashbytes }, startBurnHeight, lockPeriod);
+            return createJsonResponse({
+                success: true,
+                txid: result.txid,
+                stacker: account.address,
+                amount,
+                lockPeriod,
+                startBurnHeight,
+                network: NETWORK,
+                explorerUrl: getExplorerTxUrl(result.txid, NETWORK),
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // Extend stacking
+    server.registerTool("extend_stacking", {
+        description: "Extend an existing stacking lock period.",
+        inputSchema: {
+            extendCount: z.number().min(1).max(12).describe("Number of additional cycles to lock"),
+            poxAddressVersion: z.number().describe("Bitcoin address version"),
+            poxAddressHashbytes: z.string().describe("Bitcoin address hash (hex string)"),
+        },
+    }, async ({ extendCount, poxAddressVersion, poxAddressHashbytes }) => {
+        try {
+            const stackingService = getStackingService(NETWORK);
+            const account = await getAccount();
+            const result = await stackingService.extendStacking(account, extendCount, { version: poxAddressVersion, hashbytes: poxAddressHashbytes });
+            return createJsonResponse({
+                success: true,
+                txid: result.txid,
+                stacker: account.address,
+                extendCount,
+                network: NETWORK,
+                explorerUrl: getExplorerTxUrl(result.txid, NETWORK),
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=stacking.tools.js.map

package/dist/tools/stacking.tools.js.map

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

package/dist/tools/tokens.tools.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.tools.d.ts","sourceRoot":"","sources":["../../src/tools/tokens.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOpE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA4K1D"}

package/dist/tools/tokens.tools.js

@@ -0,0 +1,154 @@
+import { z } from "zod";
+import { getAccount, getWalletAddress, NETWORK } from "../services/x402.service.js";
+import { getTokensService } from "../services/tokens.service.js";
+import { getExplorerTxUrl } from "../config/networks.js";
+import { createJsonResponse, createErrorResponse } from "../utils/index.js";
+export function registerTokenTools(server) {
+    // Get token balance
+    server.registerTool("get_token_balance", {
+        description: `Get the balance of any SIP-010 token for a wallet address.
+
+Supports well-known tokens by symbol: sBTC, USDCx, ALEX, DIKO
+Or use the full contract ID: address.contract-name`,
+        inputSchema: {
+            token: z.string().describe("Token symbol (e.g., 'USDCx', 'sBTC') or contract ID"),
+            address: z
+                .string()
+                .optional()
+                .describe("Wallet address to check. Uses configured wallet if not provided."),
+        },
+    }, async ({ token, address }) => {
+        try {
+            const tokensService = getTokensService(NETWORK);
+            const walletAddress = address || (await getWalletAddress());
+            const balance = await tokensService.getBalance(token, walletAddress);
+            return createJsonResponse({
+                address: walletAddress,
+                network: NETWORK,
+                token: {
+                    contractId: balance.contractId,
+                    symbol: balance.symbol,
+                    name: balance.name,
+                    decimals: balance.decimals,
+                },
+                balance: {
+                    raw: balance.balance,
+                    formatted: balance.formattedBalance,
+                },
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // Transfer token
+    server.registerTool("transfer_token", {
+        description: `Transfer any SIP-010 token to a recipient address.
+
+Supports well-known tokens by symbol: sBTC, USDCx, ALEX, DIKO
+Or use the full contract ID.`,
+        inputSchema: {
+            token: z.string().describe("Token symbol (e.g., 'USDCx') or contract ID"),
+            recipient: z.string().describe("The recipient's Stacks address"),
+            amount: z.string().describe("Amount in smallest unit (depends on token decimals)"),
+            memo: z.string().optional().describe("Optional memo message (max 34 bytes)"),
+        },
+    }, async ({ token, recipient, amount, memo }) => {
+        try {
+            const tokensService = getTokensService(NETWORK);
+            const account = await getAccount();
+            const result = await tokensService.transfer(account, token, recipient, BigInt(amount), memo);
+            return createJsonResponse({
+                success: true,
+                txid: result.txid,
+                from: account.address,
+                recipient,
+                token,
+                amount,
+                memo: memo || null,
+                network: NETWORK,
+                explorerUrl: getExplorerTxUrl(result.txid, NETWORK),
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // Get token info
+    server.registerTool("get_token_info", {
+        description: "Get metadata for a SIP-010 token (name, symbol, decimals, supply).",
+        inputSchema: {
+            token: z.string().describe("Token symbol or contract ID"),
+        },
+    }, async ({ token }) => {
+        try {
+            const tokensService = getTokensService(NETWORK);
+            const info = await tokensService.getTokenInfo(token);
+            if (!info) {
+                return createJsonResponse({
+                    error: "Token metadata not found",
+                    token,
+                });
+            }
+            return createJsonResponse({
+                network: NETWORK,
+                ...info,
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // List user tokens
+    server.registerTool("list_user_tokens", {
+        description: "List all fungible tokens owned by an address.",
+        inputSchema: {
+            address: z
+                .string()
+                .optional()
+                .describe("Wallet address to check. Uses configured wallet if not provided."),
+        },
+    }, async ({ address }) => {
+        try {
+            const tokensService = getTokensService(NETWORK);
+            const walletAddress = address || (await getWalletAddress());
+            const tokens = await tokensService.getUserTokens(walletAddress);
+            return createJsonResponse({
+                address: walletAddress,
+                network: NETWORK,
+                tokenCount: tokens.length,
+                tokens: tokens.map((t) => ({
+                    contractId: t.asset_identifier,
+                    balance: t.balance,
+                })),
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // Get token holders
+    server.registerTool("get_token_holders", {
+        description: "Get the top holders of a SIP-010 token.",
+        inputSchema: {
+            token: z.string().describe("Token symbol or contract ID"),
+            limit: z.number().optional().default(20).describe("Maximum number of holders to return"),
+            offset: z.number().optional().default(0).describe("Offset for pagination"),
+        },
+    }, async ({ token, limit, offset }) => {
+        try {
+            const tokensService = getTokensService(NETWORK);
+            const result = await tokensService.getTokenHolders(token, { limit, offset });
+            return createJsonResponse({
+                token,
+                network: NETWORK,
+                total: result.total,
+                holders: result.results,
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=tokens.tools.js.map

package/dist/tools/tokens.tools.js.map

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

package/dist/tools/transfer.tools.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"transfer.tools.d.ts","sourceRoot":"","sources":["../../src/tools/transfer.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOpE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiE7D"}

package/dist/tools/transfer.tools.js

@@ -0,0 +1,62 @@
+import { z } from "zod";
+import { getAccount, NETWORK } from "../services/x402.service.js";
+import { transferStx, broadcastSignedTransaction } from "../transactions/builder.js";
+import { getExplorerTxUrl } from "../config/networks.js";
+import { createJsonResponse, createErrorResponse } from "../utils/index.js";
+export function registerTransferTools(server) {
+    // Transfer STX
+    server.registerTool("transfer_stx", {
+        description: `Transfer STX tokens to a recipient address. Signs and broadcasts the transaction.
+
+Example: To send 2 STX, use amount "2000000" (micro-STX).
+1 STX = 1,000,000 micro-STX`,
+        inputSchema: {
+            recipient: z.string().describe("The recipient's Stacks address (starts with SP or ST)"),
+            amount: z
+                .string()
+                .describe("Amount in micro-STX (1 STX = 1,000,000 micro-STX). Example: '2000000' for 2 STX"),
+            memo: z.string().optional().describe("Optional memo message to include with the transfer"),
+        },
+    }, async ({ recipient, amount, memo }) => {
+        try {
+            const account = await getAccount();
+            const result = await transferStx(account, recipient, BigInt(amount), memo);
+            const stxAmount = (BigInt(amount) / BigInt(1000000)).toString();
+            return createJsonResponse({
+                success: true,
+                txid: result.txid,
+                from: account.address,
+                recipient,
+                amount: stxAmount + " STX",
+                amountMicroStx: amount,
+                memo: memo || null,
+                network: NETWORK,
+                explorerUrl: getExplorerTxUrl(result.txid, NETWORK),
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // Broadcast pre-signed transaction
+    server.registerTool("broadcast_transaction", {
+        description: "Broadcast a pre-signed Stacks transaction to the network.",
+        inputSchema: {
+            signedTx: z.string().describe("The signed transaction as a hex string"),
+        },
+    }, async ({ signedTx }) => {
+        try {
+            const result = await broadcastSignedTransaction(signedTx, NETWORK);
+            return createJsonResponse({
+                success: true,
+                txid: result.txid,
+                network: NETWORK,
+                explorerUrl: getExplorerTxUrl(result.txid, NETWORK),
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=transfer.tools.js.map

package/dist/tools/transfer.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfer.tools.js","sourceRoot":"","sources":["../../src/tools/transfer.tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE5E,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,eAAe;IACf,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,WAAW,EAAE;;;4BAGS;QACtB,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;YACvF,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,CAAC,iFAAiF,CAAC;YAC9F,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;SAC3F;KACF,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE;QACpC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,UAAU,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;YAE3E,MAAM,SAAS,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;YAEhE,OAAO,kBAAkB,CAAC;gBACxB,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,IAAI,EAAE,OAAO,CAAC,OAAO;gBACrB,SAAS;gBACT,MAAM,EAAE,SAAS,GAAG,MAAM;gBAC1B,cAAc,EAAE,MAAM;gBACtB,IAAI,EAAE,IAAI,IAAI,IAAI;gBAClB,OAAO,EAAE,OAAO;gBAChB,WAAW,EAAE,gBAAgB,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC;aACpD,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;IACH,CAAC,CACF,CAAC;IAEF,mCAAmC;IACnC,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,WAAW,EAAE,2DAA2D;QACxE,WAAW,EAAE;YACX,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;SACxE;KACF,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;QACrB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,0BAA0B,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAEnE,OAAO,kBAAkB,CAAC;gBACxB,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,OAAO,EAAE,OAAO;gBAChB,WAAW,EAAE,gBAAgB,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC;aACpD,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/wallet-management.tools.d.ts

@@ -0,0 +1,6 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register wallet management tools
+ */
+export declare function registerWalletManagementTools(server: McpServer): void;
+//# sourceMappingURL=wallet-management.tools.d.ts.map

package/dist/tools/wallet-management.tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-management.tools.d.ts","sourceRoot":"","sources":["../../src/tools/wallet-management.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAudrE"}