@aibtc/mcp-server 1.71.0 → 1.72.1

package/dist/tools/pillar-direct.tools.js

@@ -114,13 +114,13 @@ export function registerPillarDirectTools(server) {
         description: "Generate a new secp256k1 signing keypair for Pillar smart wallet direct operations. " +
             "Returns the compressed public key (33 bytes hex). " +
             "After generation, propose this pubkey on your smart wallet contract (admin must do this).",
-        inputSchema: {
+        inputSchema: z.object({
             smartWallet: z
                 .string()
                 .default("pending")
                 .describe("Smart wallet contract ID this key is for (e.g. SPV9K21TBFAK4KNRJXF5DFP8N7W46G4V9RCJDC22.my-wallet). " +
                 "Use 'pending' if creating a new wallet — pillar_direct_create_wallet will update it automatically."),
-        },
+        }),
     }, async ({ smartWallet }) => {
         try {
             const keyService = getSigningKeyService();
@@ -141,12 +141,12 @@ export function registerPillarDirectTools(server) {
     server.registerTool("pillar_key_unlock", {
         description: "Unlock a signing key for Pillar direct operations. " +
             "Uses auto-derived password. Usually not needed — tools auto-unlock on first use.",
-        inputSchema: {
+        inputSchema: z.object({
             keyId: z
                 .string()
                 .optional()
                 .describe("The signing key ID to unlock. If omitted, unlocks the first stored key."),
-        },
+        }),
     }, async ({ keyId }) => {
         try {
             const keyService = getSigningKeyService();
@@ -175,7 +175,7 @@ export function registerPillarDirectTools(server) {
     });
     server.registerTool("pillar_key_lock", {
         description: "Lock the signing key, clearing sensitive data from memory.",
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         try {
             const keyService = getSigningKeyService();
@@ -191,7 +191,7 @@ export function registerPillarDirectTools(server) {
     });
     server.registerTool("pillar_key_info", {
         description: "Show signing key info: pubkey, smart wallet, lock status, and all stored keys.",
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         try {
             const keyService = getSigningKeyService();
@@ -230,7 +230,7 @@ export function registerPillarDirectTools(server) {
             "Agent-signed, no browser needed. Your sBTC is supplied to Zest, borrowed against, " +
             "and re-supplied for amplified Bitcoin exposure. Backend sponsors gas. " +
             "For simple yield without leverage, use pillar_direct_supply instead.",
-        inputSchema: {
+        inputSchema: z.object({
             sbtcAmount: z
                 .number()
                 .positive()
@@ -243,7 +243,7 @@ export function registerPillarDirectTools(server) {
                 .number()
                 .positive()
                 .describe("Min sBTC from swap in sats (slippage protection)"),
-        },
+        }),
     }, async ({ sbtcAmount, aeUsdcToBorrow, minSbtcFromSwap }) => {
         try {
             const { keyService, session } = await requireActiveKey();
@@ -280,7 +280,7 @@ export function registerPillarDirectTools(server) {
     server.registerTool("pillar_direct_unwind", {
         description: "Close or reduce your leveraged sBTC position. Agent-signed, no browser needed. " +
             "Swaps sBTC to aeUSDC to repay debt, then withdraws remaining sBTC collateral. Backend sponsors gas.",
-        inputSchema: {
+        inputSchema: z.object({
             sbtcToSwap: z
                 .number()
                 .positive()
@@ -293,7 +293,7 @@ export function registerPillarDirectTools(server) {
                 .number()
                 .positive()
                 .describe("Min aeUSDC from swap (slippage protection, 6 decimals)"),
-        },
+        }),
     }, async ({ sbtcToSwap, sbtcToWithdraw, minAeUsdcFromSwap }) => {
         try {
             const { keyService, session } = await requireActiveKey();
@@ -332,12 +332,12 @@ export function registerPillarDirectTools(server) {
         description: "Earn yield on your Bitcoin. Supply sBTC from your Pillar smart wallet to Zest Protocol. " +
             "No leverage, no liquidation risk. Agent-signed, no browser needed. Backend sponsors gas. " +
             "For leveraged exposure (1.5x), use pillar_direct_boost instead.",
-        inputSchema: {
+        inputSchema: z.object({
             sbtcAmount: z
                 .number()
                 .positive()
                 .describe("sBTC amount in sats to supply"),
-        },
+        }),
     }, async ({ sbtcAmount }) => {
         try {
             const { keyService, session } = await requireActiveKey();
@@ -372,7 +372,7 @@ export function registerPillarDirectTools(server) {
         description: "Send sBTC from your Pillar smart wallet to a recipient. " +
             "Agent-signed, no browser needed. Supports BNS names, wallet names, or Stacks addresses. " +
             "Backend sponsors gas.",
-        inputSchema: {
+        inputSchema: z.object({
             to: z
                 .string()
                 .describe("Recipient: BNS name (muneeb.btc), Pillar wallet name, or Stacks address (SP...)"),
@@ -384,7 +384,7 @@ export function registerPillarDirectTools(server) {
                 .enum(["bns", "wallet", "address"])
                 .default("bns")
                 .describe("Type of recipient: 'bns' (default), 'wallet', or 'address'"),
-        },
+        }),
     }, async ({ to, amount, recipientType }) => {
         try {
             const { keyService, session } = await requireActiveKey();
@@ -450,7 +450,7 @@ export function registerPillarDirectTools(server) {
         description: "Configure auto-compound for your Pillar wallet. " +
             "When enabled, a keeper automatically boosts when sBTC accumulates above the trigger. " +
             "Agent-signed, no browser needed. Backend sponsors gas.",
-        inputSchema: {
+        inputSchema: z.object({
             enabled: z.boolean().describe("Enable or disable auto-compound"),
             minSbtc: z
                 .number()
@@ -460,7 +460,7 @@ export function registerPillarDirectTools(server) {
                 .number()
                 .positive()
                 .describe("sBTC amount above minimum that triggers auto-compound (in sats)"),
-        },
+        }),
     }, async ({ enabled, minSbtc, trigger }) => {
         try {
             const { keyService, session } = await requireActiveKey();
@@ -498,7 +498,7 @@ export function registerPillarDirectTools(server) {
     server.registerTool("pillar_direct_position", {
         description: "View your Pillar smart wallet balances (STX, sBTC, aeUSDC) and Zest position. " +
             "No signing needed — reads on-chain data.",
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         try {
             const { session } = await requireActiveKey();
@@ -599,12 +599,12 @@ export function registerPillarDirectTools(server) {
     server.registerTool("pillar_direct_withdraw_collateral", {
         description: "Withdraw sBTC collateral from Zest on the Pillar smart wallet. " +
             "Agent-signed, no browser needed. Backend sponsors gas.",
-        inputSchema: {
+        inputSchema: z.object({
             sbtcAmount: z
                 .number()
                 .positive()
                 .describe("sBTC amount in sats to withdraw"),
-        },
+        }),
     }, async ({ sbtcAmount }) => {
         try {
             const { keyService, session } = await requireActiveKey();
@@ -638,11 +638,11 @@ export function registerPillarDirectTools(server) {
         description: "Add a backup admin address to your Pillar smart wallet for recovery purposes. " +
             "Agent-signed, no browser needed. The admin can help recover funds if you lose access to your passkey. " +
             "Backend sponsors gas.",
-        inputSchema: {
+        inputSchema: z.object({
             newAdmin: z
                 .string()
                 .describe("Stacks address (SP...) to add as backup admin"),
-        },
+        }),
     }, async ({ newAdmin }) => {
         try {
             const { keyService, session } = await requireActiveKey();
@@ -681,7 +681,7 @@ export function registerPillarDirectTools(server) {
             "and deploys a new smart wallet with the pubkey registered. " +
             "Backend deploys the contract and calls onboard() in background. " +
             "After ~20-30 seconds the wallet is ready for pillar_direct_* operations.",
-        inputSchema: {
+        inputSchema: z.object({
             walletName: z
                 .string()
                 .min(3)
@@ -693,7 +693,7 @@ export function registerPillarDirectTools(server) {
                 .default("SPV9K21TBFAK4KNRJXF5DFP8N7W46G4V9RCJDC22.beta-v2-wallet")
                 .describe("Contract address of the referring wallet. " +
                 "Defaults to the Pillar team wallet if not provided."),
-        },
+        }),
     }, async ({ walletName, referredBy }) => {
         try {
             const api = getPillarApi();
@@ -759,11 +759,11 @@ export function registerPillarDirectTools(server) {
     server.registerTool("pillar_direct_dca_invite", {
         description: "Invite a DCA partner by email or wallet address. " +
             "DCA partners hold each other accountable — both must boost each week to keep the streak alive.",
-        inputSchema: {
+        inputSchema: z.object({
             partner: z
                 .string()
                 .describe("Partner's email address or Stacks wallet address (SP...)"),
-        },
+        }),
     }, async ({ partner }) => {
         try {
             const { session } = await requireActiveKey();
@@ -793,7 +793,7 @@ export function registerPillarDirectTools(server) {
     server.registerTool("pillar_direct_dca_partners", {
         description: "View your DCA partners and weekly status. " +
             "Shows active partnerships with streak, PnL, and weekly status badges, plus any pending invites.",
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         try {
             const { session } = await requireActiveKey();
@@ -831,7 +831,7 @@ export function registerPillarDirectTools(server) {
     // --- pillar_direct_dca_leaderboard (twin of pillar_dca_leaderboard) ---
     server.registerTool("pillar_direct_dca_leaderboard", {
         description: "View the DCA streak leaderboard. Shows top partnerships by streak length, and highlights your entry if you have one.",
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         try {
             const { session } = await requireActiveKey();
@@ -869,7 +869,7 @@ export function registerPillarDirectTools(server) {
     server.registerTool("pillar_direct_dca_status", {
         description: "Check your DCA schedule status. Shows all active DCA schedules (up to 10) with chunk progress " +
             "(completed, pending, failed) and next execution time.",
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         try {
             const { session } = await requireActiveKey();
@@ -960,12 +960,12 @@ export function registerPillarDirectTools(server) {
     server.registerTool("pillar_direct_quote", {
         description: "Get a boost quote showing projected leverage, LTV, and swap details. " +
             "No signing needed. Use this to determine aeUsdcToBorrow and minSbtcFromSwap before calling pillar_direct_boost.",
-        inputSchema: {
+        inputSchema: z.object({
             sbtcAmount: z
                 .number()
                 .positive()
                 .describe("sBTC amount in sats to boost"),
-        },
+        }),
     }, async ({ sbtcAmount }) => {
         try {
             const api = getPillarApi();
@@ -985,7 +985,7 @@ export function registerPillarDirectTools(server) {
         description: "Resolve a recipient before sending. Resolves BNS names (.btc) via backend, " +
             "Pillar wallet names via backend, or validates a Stacks address. " +
             "Use this BEFORE pillar_direct_send to confirm the resolved address with the user.",
-        inputSchema: {
+        inputSchema: z.object({
             to: z
                 .string()
                 .describe("Recipient: BNS name (muneeb.btc), Pillar wallet name, or Stacks address (SP...)"),
@@ -993,7 +993,7 @@ export function registerPillarDirectTools(server) {
                 .enum(["bns", "wallet", "address"])
                 .default("bns")
                 .describe("Type of recipient: 'bns' (default), 'wallet', or 'address'"),
-        },
+        }),
     }, async ({ to, recipientType }) => {
         try {
             const api = getPillarApi();
@@ -1060,7 +1060,7 @@ export function registerPillarDirectTools(server) {
             "pox-4 is not the active PoX contract (PoX-5 is live; use stack_stx for PoX-5 staking). " +
             "Stacking DAO deposits STX into Stacking DAO core for stSTX yield. " +
             "Your wallet must be enrolled in dual stacking first (automatic for v2 wallets with sBTC).",
-        inputSchema: {
+        inputSchema: z.object({
             stxAmount: z
                 .number()
                 .positive()
@@ -1069,7 +1069,7 @@ export function registerPillarDirectTools(server) {
                 .enum(["fast-pool", "stacking-dao"])
                 .describe("Stacking pool to use: 'fast-pool' (delegates to pox4-fast-pool-v3) " +
                 "or 'stacking-dao' (deposits into Stacking DAO for stSTX)"),
-        },
+        }),
     }, async ({ stxAmount, pool }) => {
         try {
             if (pool === "fast-pool") {
@@ -1122,7 +1122,7 @@ export function registerPillarDirectTools(server) {
             "refused while pox-4 is not the active PoX contract). " +
             "Agent-signed, no browser needed. Backend sponsors gas. " +
             "After revoking, STX stays locked until the current PoX cycle ends, then returns to liquid.",
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         try {
             await assertFastPoolPoxActive("Revoking Fast Pool");
@@ -1159,7 +1159,7 @@ export function registerPillarDirectTools(server) {
             "No signing needed — reads on-chain data. " +
             "Shows STX balance (locked vs liquid), current PoX cycle info, " +
             "and dual stacking enrollment status.",
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         try {
             const { session } = await requireActiveKey();

package/dist/tools/pillar.tools.d.ts

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

package/dist/tools/pillar.tools.js

@@ -1,3 +1,5 @@
+// Pillar MCP Tools - Handoff model
+// MCP creates intent → Opens frontend → Frontend handles signing → MCP polls for result
 import { z } from "zod";
 import { getPillarApi } from "../services/pillar-api.service.js";
 import { createJsonResponse, createErrorResponse } from "../utils/index.js";
@@ -89,7 +91,7 @@ export function registerPillarTools(server) {
     server.registerTool("pillar_connect", {
         description: "Connect to your Pillar smart wallet. Opens the Pillar website - if you're logged in, " +
             "it will automatically connect and return your wallet address. Use this first before other Pillar actions.",
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         try {
             const api = getPillarApi();
@@ -143,7 +145,7 @@ export function registerPillarTools(server) {
     // Tool 2: Disconnect from Pillar
     server.registerTool("pillar_disconnect", {
         description: "Disconnect from Pillar. Clears locally stored wallet address.",
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         const session = await loadSession();
         await clearSession();
@@ -157,7 +159,7 @@ export function registerPillarTools(server) {
     // Tool 3: Get Pillar connection status
     server.registerTool("pillar_status", {
         description: "Check if you're connected to Pillar and get your wallet address.",
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         const session = await loadSession();
         if (session) {
@@ -178,11 +180,11 @@ export function registerPillarTools(server) {
         description: "Send sBTC from your Pillar smart wallet. Requires being connected first (use pillar_connect). " +
             "Opens the frontend for signing, then waits for confirmation. " +
             "Supports three recipient types: 'bns' for BNS names (muneeb.btc), 'wallet' for Pillar wallet names (iphone), 'address' for Stacks addresses (SP...).",
-        inputSchema: {
+        inputSchema: z.object({
             to: z.string().describe("Recipient: BNS name (muneeb.btc), Pillar wallet name (iphone), or Stacks address (SP...)"),
             amount: z.number().positive().describe("Amount in satoshis"),
             recipientType: z.enum(["bns", "wallet", "address"]).optional().describe("Type of recipient: 'bns' (default), 'wallet' for Pillar smart wallets, or 'address' for raw Stacks addresses"),
-        },
+        }),
     }, async ({ to, amount, recipientType }) => {
         try {
             // Get wallet address from session
@@ -249,10 +251,10 @@ export function registerPillarTools(server) {
             "- 'btc': Deposit BTC from your Leather/Xverse wallet - auto-converts to sBTC\n" +
             "- 'sbtc': Deposit sBTC directly from your Leather/Xverse wallet\n" +
             "Opens the frontend with the appropriate deposit flow.",
-        inputSchema: {
+        inputSchema: z.object({
             method: z.enum(["exchange", "btc", "sbtc"]).describe("Funding method: 'exchange' (deposit from Coinbase/Binance), 'btc' (from Leather/Xverse BTC), 'sbtc' (from Leather/Xverse sBTC)"),
             amount: z.number().positive().optional().describe("Amount in satoshis to deposit (optional, can be set in UI)"),
-        },
+        }),
     }, async ({ method, amount }) => {
         try {
             const session = await loadSession();
@@ -300,9 +302,9 @@ export function registerPillarTools(server) {
     server.registerTool("pillar_add_admin", {
         description: "Add a backup admin address to your Pillar smart wallet for recovery purposes. " +
             "The admin can help recover funds if you lose access to your passkey.",
-        inputSchema: {
+        inputSchema: z.object({
             adminAddress: z.string().optional().describe("Stacks address (SP...) to add as backup admin (can be set in UI)"),
-        },
+        }),
     }, async ({ adminAddress }) => {
         try {
             const session = await loadSession();
@@ -346,9 +348,9 @@ export function registerPillarTools(server) {
         description: "Earn yield on your Bitcoin. Supply sBTC from your Pillar smart wallet to Zest Protocol. " +
             "Your sBTC earns interest with no leverage and no liquidation risk. " +
             "This is the simplest way to earn on Pillar (Earn tab). For leveraged exposure, use pillar_boost instead.",
-        inputSchema: {
+        inputSchema: z.object({
             amount: z.number().positive().optional().describe("Amount in satoshis to supply (optional, can be set in UI)"),
-        },
+        }),
     }, async ({ amount }) => {
         try {
             const session = await loadSession();
@@ -391,10 +393,10 @@ export function registerPillarTools(server) {
     server.registerTool("pillar_auto_compound", {
         description: "Configure auto-compound for your Pillar wallet. " +
             "When enabled, a keeper will automatically boost your position when sBTC accumulates in your wallet.",
-        inputSchema: {
+        inputSchema: z.object({
             minSbtc: z.number().nonnegative().optional().describe("Minimum sBTC to keep in wallet (in sats)"),
             trigger: z.number().positive().optional().describe("Amount above minimum that triggers auto-compound (in sats)"),
-        },
+        }),
     }, async ({ minSbtc, trigger }) => {
         try {
             const session = await loadSession();
@@ -435,9 +437,9 @@ export function registerPillarTools(server) {
     server.registerTool("pillar_unwind", {
         description: "Close or reduce your leveraged sBTC position. " +
             "Opens a modal to repay borrowed sBTC and withdraw collateral back to your wallet.",
-        inputSchema: {
+        inputSchema: z.object({
             percentage: z.number().min(1).max(100).optional().describe("Percentage of position to unwind (1-100, optional, can be set in UI)"),
-        },
+        }),
     }, async ({ percentage }) => {
         try {
             const session = await loadSession();
@@ -484,9 +486,9 @@ export function registerPillarTools(server) {
             "For simple yield without leverage, use pillar_supply (Earn) instead. " +
             "Amounts over 100,000 sats automatically enter DCA mode -- split into daily 100k-sat chunks " +
             "(max 700k sats per schedule). The first chunk executes immediately, the rest follow daily.",
-        inputSchema: {
+        inputSchema: z.object({
             amount: z.number().positive().optional().describe("Amount in satoshis to boost (optional, shown as suggestion)"),
-        },
+        }),
     }, async ({ amount }) => {
         try {
             const session = await loadSession();
@@ -529,7 +531,7 @@ export function registerPillarTools(server) {
     server.registerTool("pillar_position", {
         description: "View your Pillar wallet balance and Zest position. " +
             "Opens the Position page in the browser AND returns the data (sBTC balance, collateral, borrowed, LTV, liquidation price).",
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         try {
             const session = await loadSession();
@@ -606,9 +608,9 @@ export function registerPillarTools(server) {
         description: "Create a new Pillar smart wallet. Opens the Pillar website to complete registration. " +
             "You'll need to enter your email to receive updates. " +
             "If the user doesn't have a referral link, tell them they can DM @pillar_btc on X (https://x.com/pillar_btc) to request one before signing up.",
-        inputSchema: {
+        inputSchema: z.object({
             referral: z.string().optional().describe("Referral wallet address (optional, defaults to MCP referral)"),
-        },
+        }),
     }, async ({ referral }) => {
         try {
             // Check if already connected
@@ -662,7 +664,7 @@ export function registerPillarTools(server) {
     // Tool 13: Get referral/invite link
     server.registerTool("pillar_invite", {
         description: "Get your Pillar referral link to invite friends. Share this link and earn rewards when friends sign up.",
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         try {
             const session = await loadSession();
@@ -688,9 +690,9 @@ export function registerPillarTools(server) {
     server.registerTool("pillar_dca_invite", {
         description: "Invite a DCA partner by email or wallet address. " +
             "DCA partners hold each other accountable — both must boost each week to keep the streak alive.",
-        inputSchema: {
+        inputSchema: z.object({
             partner: z.string().describe("Partner's email address or Stacks wallet address (SP...)"),
-        },
+        }),
     }, async ({ partner }) => {
         try {
             const session = await loadSession();
@@ -724,7 +726,7 @@ export function registerPillarTools(server) {
     server.registerTool("pillar_dca_partners", {
         description: "View your DCA partners and weekly status. " +
             "Shows active partnerships with streak, PnL, and weekly status badges, plus any pending invites.",
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         try {
             const session = await loadSession();
@@ -766,7 +768,7 @@ export function registerPillarTools(server) {
     // Tool 16: DCA streak leaderboard (direct API)
     server.registerTool("pillar_dca_leaderboard", {
         description: "View the DCA streak leaderboard. Shows top partnerships by streak length, and highlights your entry if you have one.",
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         try {
             const session = await loadSession();
@@ -806,7 +808,7 @@ export function registerPillarTools(server) {
     server.registerTool("pillar_dca_status", {
         description: "Check your DCA schedule status. Shows all active DCA schedules (up to 10) with chunk progress " +
             "(completed, pending, failed) and next execution time.",
-        inputSchema: {},
+        inputSchema: z.object({}),
     }, async () => {
         try {
             const session = await loadSession();

package/dist/tools/profiles.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 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 declare const CORE_TOOLS: ReadonlySet<string>;
+export declare const TOOL_GROUPS: {
+    readonly wallet: "Wallet management extras, encrypted credential store";
+    readonly stacks: "Stacks transactions, contracts, tokens, NFTs, chain queries, nonce tools";
+    readonly sbtc: "sBTC deposit/withdraw, Styx BTC→sBTC";
+    readonly bitcoin: "Bitcoin L1 UTXOs, mempool watch";
+    readonly lightning: "Lightning (Spark) wallet and L402 payments";
+    readonly stacking: "PoX stacking, dual stacking, StackSpot";
+    readonly defi: "ALEX, Zest, Bitflow, Jingswap, yield hunter/dashboard, Tenero analytics";
+    readonly pillar: "Pillar smart wallet";
+    readonly ordinals: "Inscriptions, runes, PSBT, ordinals marketplace/P2P, taproot multisig";
+    readonly bns: "BNS names";
+    readonly identity: "ERC-8004 identity and reputation, message signing";
+    readonly social: "Nostr, AIBTC inbox";
+    readonly earn: "Bounty board (create, accept, pay, my views)";
+    readonly legion: "AIBTC News Legion";
+    readonly markets: "Stacks prediction market, At Stake";
+    readonly dev: "Scaffolding, OpenRouter, settings, inference marketplace, arXiv";
+};
+export type ToolGroup = keyof typeof TOOL_GROUPS;
+/** Which tools to expose: every tool, or the core set plus the named groups. */
+export type ToolSelection = {
+    all: true;
+} | {
+    all: false;
+    groups: ReadonlySet<ToolGroup>;
+};
+export declare const ALL_TOOLS: ToolSelection;
+export declare function isToolGroup(name: string): name is ToolGroup;
+export declare function isToolSelected(selection: ToolSelection, name: string, group: ToolGroup): boolean;
+/**
+ * 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 declare function resolveToolSelection(argv?: readonly string[], env?: NodeJS.ProcessEnv): ToolSelection;
+/** Server-instructions paragraph telling the agent what is off and how to turn it on. */
+export declare function describeSelection(selection: ToolSelection): string;
+//# sourceMappingURL=profiles.d.ts.map

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