Bybit MCP Server

Instructions

Implementation Reference

• src/client.ts:85-95 (handler)

  The core handler function that executes the tool logic by calling the Bybit API's getWalletBalance method.

  async getWalletBalance(accountType: string, coin?: string) {
    try {
      const response = await this.client.getWalletBalance({
        accountType: accountType as any,
        coin: coin
      });
      return response;
    } catch (error) {
      throw new Error(`Failed to get wallet balance: ${error instanceof Error ? error.message : JSON.stringify(error)}`);
    }
  }

• src/server.ts:85-90 (handler)

  MCP server dispatch handler that maps the tool name to the client method call.

  case 'get_wallet_balance':
    result = await this.client.getWalletBalance(
      args.accountType as string,
      args.coin as string
    );
    break;

• src/tools.ts:60-68 (registration)

  Tool registration in the tools array exported for MCP server list tools request.

  {
    name: 'get_wallet_balance',
    description: 'Get wallet balance for a specific account type',
    inputSchema: {
      type: 'object',
      properties: WalletBalanceSchema.shape,
      required: ['accountType']
    }
  },

• src/types.ts:74-77 (schema)

  Zod schema defining the input parameters for the get_wallet_balance tool.

  export const WalletBalanceSchema = z.object({
    accountType: z.enum(['UNIFIED', 'CONTRACT', 'SPOT', 'INVESTMENT', 'OPTION', 'FUND']).describe('Account type'),
    coin: z.string().optional().describe('Coin name (if not provided, returns all coins)')
  });