Trading Simulator MCP Server

Instructions

Implementation Reference

• src/index.ts:212-250 (registration)

  Registers the 'get_price_history' tool in the TRADING_SIM_TOOLS array used by the MCP server, including name, description, and detailed JSON input schema.

  {
    name: "get_price_history",
    description: "Get historical price data for a token",
    inputSchema: {
      type: "object",
      properties: {
        token: {
          type: "string",
          description: "Token address"
        },
        startTime: {
          type: "string",
          description: "Start time as ISO timestamp"
        },
        endTime: {
          type: "string",
          description: "End time as ISO timestamp"
        },
        interval: {
          type: "string",
          enum: ["1m", "5m", "15m", "1h", "4h", "1d"],
          description: "Time interval for price points"
        },
        chain: {
          type: "string",
          enum: ["svm", "evm"],
          description: "Optional blockchain type"
        },
        specificChain: {
          type: "string",
          enum: ["eth", "polygon", "bsc", "arbitrum", "base", "optimism", "avalanche", "linea", "svm"],
          description: "Optional specific chain for EVM tokens"
        }
      },
      required: ["token"],
      additionalProperties: false,
      $schema: "http://json-schema.org/draft-07/schema#"
    }
  },

• src/index.ts:527-547 (handler)

  The main handler logic for the 'get_price_history' tool call within the MCP server's CallToolRequestSchema handler. Validates arguments, builds PriceHistoryParams, calls the tradingClient helper, and formats the response.

  case "get_price_history": {
    if (!args || typeof args !== "object" || !("token" in args)) {
      throw new Error("Invalid arguments for get_price_history");
    }
    
    const historyParams: PriceHistoryParams = {
      token: args.token as string
    };
    
    if ("startTime" in args) historyParams.startTime = args.startTime as string;
    if ("endTime" in args) historyParams.endTime = args.endTime as string;
    if ("interval" in args) historyParams.interval = args.interval as PriceHistoryParams['interval'];
    if ("chain" in args) historyParams.chain = args.chain as BlockchainType;
    if ("specificChain" in args) historyParams.specificChain = args.specificChain as SpecificChain;
    
    const response = await tradingClient.getPriceHistory(historyParams);
    return {
      content: [{ type: "text", text: JSON.stringify(response, null, 2) }],
      isError: false
    };
  }

• src/api-client.ts:384-422 (helper)

  Helper method in TradingSimulatorClient that implements the actual API call for price history. Constructs query parameters and performs GET request to the backend /api/price/history endpoint.

  async getPriceHistory(
    tokenOrParams: string | PriceHistoryParams,
    interval?: string,
    chain?: BlockchainType,
    specificChain?: SpecificChain,
    startTime?: string,
    endTime?: string
  ): Promise<PriceHistoryResponse | ErrorResponse> {
    const urlParams = new URLSearchParams();
    
    // Handle both object-based and individual parameter calls
    if (typeof tokenOrParams === 'object') {
      // Object parameter version
      const params = tokenOrParams;
      urlParams.append('token', params.token);
      
      if (params.startTime) urlParams.append('startTime', params.startTime);
      if (params.endTime) urlParams.append('endTime', params.endTime);
      if (params.interval) urlParams.append('interval', params.interval);
      if (params.chain) urlParams.append('chain', params.chain);
      if (params.specificChain) urlParams.append('specificChain', params.specificChain);
    } else {
      // Individual parameters version
      urlParams.append('token', tokenOrParams);
      
      if (interval) urlParams.append('interval', interval);
      if (chain) urlParams.append('chain', chain);
      if (specificChain) urlParams.append('specificChain', specificChain);
      if (startTime) urlParams.append('startTime', startTime);
      if (endTime) urlParams.append('endTime', endTime);
    }
  
    return this.request<PriceHistoryResponse>(
      'GET', 
      `/api/price/history?${urlParams.toString()}`,
      null,
      'get price history'
    );
  }

• src/types.ts:92-99 (schema)

  TypeScript interface definition for PriceHistoryParams used in the tool handler and API client for input validation and typing.

  export interface PriceHistoryParams {
    token: string;
    startTime?: string;
    endTime?: string;
    interval?: '1m' | '5m' | '15m' | '1h' | '4h' | '1d';
    chain?: BlockchainType;
    specificChain?: SpecificChain;
  }