Bybit MCP Server

Instructions

Implementation Reference

• src/client.ts:123-150 (handler)

  The core handler function in BybitClient that executes the place_order tool by calling Bybit's submitOrder API endpoint.

  async placeOrder(params: {
    category: string;
    symbol: string;
    side: string;
    orderType: string;
    qty: string;
    price?: string;
    timeInForce?: string;
  }) {
    try {
      if (this.config.environment === 'mainnet') {
        console.error('⚠️  WARNING: Placing order on MAINNET with real funds!');
      }
  
      const response = await this.client.submitOrder({
        category: params.category as any,
        symbol: params.symbol,
        side: params.side as any,
        orderType: params.orderType as any,
        qty: params.qty,
        price: params.price,
        timeInForce: params.timeInForce as any
      });
      return response;
    } catch (error) {
      throw new Error(`Failed to place order: ${error instanceof Error ? error.message : JSON.stringify(error)}`);
    }
  }

• src/types.ts:45-53 (schema)

  Zod schema defining the input parameters for the place_order tool.

  export const PlaceOrderSchema = z.object({
    category: z.enum(['spot', 'linear', 'inverse', 'option']).describe('Product type'),
    symbol: z.string().describe('Trading symbol'),
    side: z.enum(['Buy', 'Sell']).describe('Order side'),
    orderType: z.enum(['Market', 'Limit']).describe('Order type'),
    qty: z.string().describe('Order quantity'),
    price: z.string().optional().describe('Order price (required for limit orders)'),
    timeInForce: z.enum(['GTC', 'IOC', 'FOK']).optional().describe('Time in force (default: GTC)')
  });

• src/tools.ts:88-95 (registration)

  Tool registration metadata including name, description, and input schema reference, included in the exported tools array used by the MCP server.

    name: 'place_order',
    description: 'Place a new order (⚠️ WARNING: Can use real funds on mainnet)',
    inputSchema: {
      type: 'object',
      properties: PlaceOrderSchema.shape,
      required: ['category', 'symbol', 'side', 'orderType', 'qty']
    }
  },

• src/server.ts:108-118 (handler)

  Dispatch handler in MCP server that routes 'place_order' tool calls to the BybitClient.placeOrder method.

  case 'place_order':
    result = await this.client.placeOrder({
      category: args.category as string,
      symbol: args.symbol as string,
      side: args.side as string,
      orderType: args.orderType as string,
      qty: args.qty as string,
      price: args.price as string,
      timeInForce: args.timeInForce as string,
    });
    break;