@aibtc/mcp-server 1.0.0

package/dist/tools/index.js

@@ -0,0 +1,52 @@
+import { registerWalletTools } from "./wallet.tools.js";
+import { registerWalletManagementTools } from "./wallet-management.tools.js";
+import { registerTransferTools } from "./transfer.tools.js";
+import { registerContractTools } from "./contract.tools.js";
+import { registerSbtcTools } from "./sbtc.tools.js";
+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 { registerQueryTools } from "./query.tools.js";
+import { registerEndpointTools } from "./endpoint.tools.js";
+import { registerDefiTools } from "./defi.tools.js";
+// TODO: Re-enable when Bitflow API key integration is complete
+// import { registerBitflowTools } from "./bitflow.tools.js";
+import { registerScaffoldTools } from "./scaffold.tools.js";
+import { registerOpenRouterTools } from "./openrouter.tools.js";
+/**
+ * Register all tools with the MCP server
+ */
+export function registerAllTools(server) {
+    // Wallet & Balance
+    registerWalletTools(server);
+    // Wallet Management (create, import, unlock, lock, etc.)
+    registerWalletManagementTools(server);
+    // Transfers
+    registerTransferTools(server);
+    // Smart Contracts
+    registerContractTools(server);
+    // sBTC
+    registerSbtcTools(server);
+    // Tokens (SIP-010)
+    registerTokenTools(server);
+    // NFTs (SIP-009)
+    registerNftTools(server);
+    // Stacking / PoX
+    registerStackingTools(server);
+    // BNS Domains
+    registerBnsTools(server);
+    // Blockchain Queries
+    registerQueryTools(server);
+    // x402 Endpoints
+    registerEndpointTools(server);
+    // DeFi (ALEX DEX, Zest Protocol)
+    registerDefiTools(server);
+    // Bitflow DEX (disabled until API key integration is complete)
+    // registerBitflowTools(server);
+    // Scaffolding (generate x402 endpoint projects)
+    registerScaffoldTools(server);
+    // OpenRouter AI (call AI models directly)
+    registerOpenRouterTools(server);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +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;AAEhE;;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;AAClC,CAAC"}

package/dist/tools/nft.tools.d.ts

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

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

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

package/dist/tools/nft.tools.js

@@ -0,0 +1,154 @@
+import { z } from "zod";
+import { getAccount, getWalletAddress, NETWORK } from "../services/x402.service.js";
+import { getNftService } from "../services/nft.service.js";
+import { getExplorerTxUrl } from "../config/networks.js";
+import { createJsonResponse, createErrorResponse } from "../utils/index.js";
+export function registerNftTools(server) {
+    // Get NFT holdings
+    server.registerTool("get_nft_holdings", {
+        description: "List all NFTs owned by an address.",
+        inputSchema: {
+            address: z
+                .string()
+                .optional()
+                .describe("Wallet address to check. Uses configured wallet if not provided."),
+            contractId: z.string().optional().describe("Filter by specific NFT collection contract"),
+            limit: z.number().optional().default(20).describe("Maximum number of results"),
+            offset: z.number().optional().default(0).describe("Offset for pagination"),
+        },
+    }, async ({ address, contractId, limit, offset }) => {
+        try {
+            const nftService = getNftService(NETWORK);
+            const walletAddress = address || (await getWalletAddress());
+            const result = await nftService.getHoldings(walletAddress, { limit, offset, contractId });
+            return createJsonResponse({
+                address: walletAddress,
+                network: NETWORK,
+                total: result.total,
+                nfts: result.nfts.map((nft) => ({
+                    collection: nft.asset_identifier,
+                    tokenId: nft.value.repr,
+                })),
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // Get NFT metadata
+    server.registerTool("get_nft_metadata", {
+        description: "Get metadata for a specific NFT (SIP-016).",
+        inputSchema: {
+            contractId: z.string().describe("NFT collection contract ID"),
+            tokenId: z.number().describe("Token ID of the NFT"),
+        },
+    }, async ({ contractId, tokenId }) => {
+        try {
+            const nftService = getNftService(NETWORK);
+            const metadata = await nftService.getMetadata(contractId, tokenId);
+            return createJsonResponse({
+                contractId,
+                tokenId,
+                network: NETWORK,
+                metadata,
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // Transfer NFT
+    server.registerTool("transfer_nft", {
+        description: "Transfer an NFT (SIP-009) to a recipient address.",
+        inputSchema: {
+            contractId: z.string().describe("NFT collection contract ID"),
+            tokenId: z.number().describe("Token ID of the NFT to transfer"),
+            recipient: z.string().describe("The recipient's Stacks address"),
+        },
+    }, async ({ contractId, tokenId, recipient }) => {
+        try {
+            const nftService = getNftService(NETWORK);
+            const account = await getAccount();
+            const result = await nftService.transfer(account, contractId, tokenId, recipient);
+            return createJsonResponse({
+                success: true,
+                txid: result.txid,
+                from: account.address,
+                recipient,
+                contractId,
+                tokenId,
+                network: NETWORK,
+                explorerUrl: getExplorerTxUrl(result.txid, NETWORK),
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // Get NFT owner
+    server.registerTool("get_nft_owner", {
+        description: "Get the current owner of a specific NFT.",
+        inputSchema: {
+            contractId: z.string().describe("NFT collection contract ID"),
+            tokenId: z.number().describe("Token ID of the NFT"),
+        },
+    }, async ({ contractId, tokenId }) => {
+        try {
+            const nftService = getNftService(NETWORK);
+            const walletAddress = await getWalletAddress();
+            const owner = await nftService.getOwner(contractId, tokenId, walletAddress);
+            return createJsonResponse({
+                contractId,
+                tokenId,
+                network: NETWORK,
+                owner: owner || "Unknown",
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // Get collection info
+    server.registerTool("get_collection_info", {
+        description: "Get information about an NFT collection.",
+        inputSchema: {
+            contractId: z.string().describe("NFT collection contract ID"),
+        },
+    }, async ({ contractId }) => {
+        try {
+            const nftService = getNftService(NETWORK);
+            const info = await nftService.getCollectionInfo(contractId);
+            return createJsonResponse({
+                network: NETWORK,
+                ...info,
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // Get NFT history
+    server.registerTool("get_nft_history", {
+        description: "Get the transfer history of NFTs in a collection.",
+        inputSchema: {
+            contractId: z.string().describe("NFT collection contract ID"),
+            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 nftService = getNftService(NETWORK);
+            const result = await nftService.getHistory(contractId, { limit, offset });
+            return createJsonResponse({
+                contractId,
+                network: NETWORK,
+                total: result.total,
+                events: result.events,
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=nft.tools.js.map

package/dist/tools/nft.tools.js.map

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

package/dist/tools/openrouter.tools.d.ts

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

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

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