BotWallet MCP Server

Instructions

Implementation Reference

• src/tools/wallet.ts:199-226 (handler)

  The handler implementation for the 'botwallet_wallet_list' tool, which lists locally configured wallets by calling 'listWallets' and formatting the results.

  const walletList: ToolDefinition = {
    name: 'botwallet_wallet_list',
    description:
      'List all locally configured wallets. Shows which wallet is the default. ' +
      'This reads from ~/.botwallet/config.json — the wallet registry shared with the CLI.',
    inputSchema: z.object({}),
    async handler(_args, ctx) {
      if (!ctx.config.hasConfig) {
        return noConfigError('list wallets');
      }
      try {
        const wallets = listWallets();
        return formatResult({
          wallets: wallets.map(w => ({
            name: w.name,
            username: w.wallet.username,
            display_name: w.wallet.display_name,
            is_default: w.isDefault,
            has_seed: seedExists(w.name),
            created_at: w.wallet.created_at,
          })),
          count: wallets.length,
        });
      } catch (e) {
        return formatToolError(e);
      }
    },
  };

• src/tools/wallet.ts:266-275 (registration)

  Registration of the tool in the export array for the wallet module.

  export const walletTools: ToolDefinition[] = [
    ping,
    register,
    info,
    balance,
    updateOwner,
    rename,
    walletList,
    walletUse,
  ];