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; }