Binance MCP Server

Instructions

Implementation Reference

• src/connectors/binance-rest.ts:151-167 (handler)

  Core implementation of the get_futures_funding_rate tool. Fetches the current funding rate from the Binance Futures /premiumIndex API endpoint using axios with exponential backoff retry logic.

  public async getFuturesFundingRate(symbol: string): Promise<any> {
    try {
      logger.info(`Getting futures funding rate for ${symbol}`);
      const response = await this.executeWithRetry(() =>
        this.axiosInstance.get(`${config.FUTURES_REST_URL}/premiumIndex`, {
          params: {
            symbol: symbol.toUpperCase()
          }
        })
      );
      logger.info('Successfully fetched funding rate data');
      return response.data;
    } catch (error) {
      logger.error('Error fetching funding rate:', error);
      throw new APIError('Failed to fetch funding rate data', error as Error);
    }
  }

• src/index.ts:94-107 (registration)

  Tool registration in the ListTools handler, defining the tool name, description, and input schema.

  {
    name: "get_futures_funding_rate",
    description: "Get current funding rate for a futures trading pair",
    inputSchema: {
      type: "object",
      properties: {
        symbol: { 
          type: "string", 
          description: "Trading pair symbol (e.g., BTCUSDT)" 
        }
      },
      required: ["symbol"]
    }
  },

• src/index.ts:223-235 (handler)

  MCP server handler for the get_futures_funding_rate tool call. Validates input, delegates to BinanceRestConnector, and formats response.

  case "get_futures_funding_rate": {
    if (!isFuturesDataParams(request.params.arguments)) {
      throw new Error('Invalid futures data parameters');
    }
    const { symbol } = request.params.arguments;
    const data = await restConnector.getFuturesFundingRate(symbol);
    return {
      content: [{
        type: "text",
        text: JSON.stringify(data, null, 2)
      }]
    };
  }

• src/types/api-types.ts:19-21 (schema)

  TypeScript interface defining the input parameters for futures tools like get_futures_funding_rate.

  export interface FuturesDataParams {
    symbol: string;
  }

• src/types/api-types.ts:58-63 (schema)

  Type guard function used to validate input parameters for the get_futures_funding_rate tool.

  export function isFuturesDataParams(params: any): params is FuturesDataParams {
    return (
      typeof params === 'object' &&
      typeof params.symbol === 'string'
    );
  }