Bybit MCP Server

Instructions

Implementation Reference

• src/bybit-service.ts:383-395 (handler)

  Core handler function that executes the set_leverage tool logic by making an authenticated POST request to Bybit API endpoint /v5/position/set-leverage.

  async setLeverage(
    category: string,
    symbol: string,
    buyLeverage: string,
    sellLeverage: string
  ): Promise<BybitResponse<any> | { error: string }> {
    return this.makeBybitRequest('/v5/position/set-leverage', 'POST', {
      category,
      symbol,
      buyLeverage,
      sellLeverage
    });
  }

• src/index.ts:527-552 (registration)

  Tool registration including name, description, and input schema definition for the MCP server.

  {
    name: 'set_leverage',
    description: 'Set leverage for a specific symbol',
    inputSchema: {
      type: 'object',
      properties: {
        category: {
          type: 'string',
          description: 'Category (linear, inverse)',
        },
        symbol: {
          type: 'string',
          description: 'Symbol (e.g., ETHUSDT)',
        },
        buyLeverage: {
          type: 'string',
          description: 'Buy leverage (e.g., "10" for 10x)',
        },
        sellLeverage: {
          type: 'string',
          description: 'Sell leverage (e.g., "10" for 10x)',
        },
      },
      required: ['category', 'symbol', 'buyLeverage', 'sellLeverage'],
    },
  },

• src/index.ts:987-1002 (handler)

  Dispatch handler in the main tool request switch statement that extracts arguments and delegates to BybitService.setLeverage, formats and returns the result.

  case 'set_leverage': {
    const result = await this.bybitService.setLeverage(
      typedArgs.category,
      typedArgs.symbol,
      typedArgs.buyLeverage,
      typedArgs.sellLeverage
    );
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(result, null, 2),
        },
      ],
    };
  }

• src/index.ts:530-551 (schema)

  Input schema defining parameters for the set_leverage tool: category, symbol, buyLeverage, sellLeverage.

  inputSchema: {
    type: 'object',
    properties: {
      category: {
        type: 'string',
        description: 'Category (linear, inverse)',
      },
      symbol: {
        type: 'string',
        description: 'Symbol (e.g., ETHUSDT)',
      },
      buyLeverage: {
        type: 'string',
        description: 'Buy leverage (e.g., "10" for 10x)',
      },
      sellLeverage: {
        type: 'string',
        description: 'Sell leverage (e.g., "10" for 10x)',
      },
    },
    required: ['category', 'symbol', 'buyLeverage', 'sellLeverage'],
  },