Trading Simulator MCP Server

Instructions

Implementation Reference

• src/index.ts:186-211 (registration)

  Registers the 'get_token_info' tool with the MCP server by defining its name, description, and input schema in the TRADING_SIM_TOOLS array.
  { name: "get_token_info", description: "Get detailed information about a token", inputSchema: { type: "object", properties: { token: { type: "string", description: "Token address" }, 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:511-525 (handler)

  MCP server handler for the 'get_token_info' tool: validates input parameters and delegates execution to the tradingClient.getTokenInfo method.
  case "get_token_info": { if (!args || typeof args !== "object" || !("token" in args)) { throw new Error("Invalid arguments for get_token_info"); } const token = args.token as string; const chain = "chain" in args ? args.chain as BlockchainType : undefined; const specificChain = "specificChain" in args ? args.specificChain as SpecificChain : undefined; const response = await tradingClient.getTokenInfo(token, chain, specificChain); return { content: [{ type: "text", text: JSON.stringify(response, null, 2) }], isError: false }; }
• src/api-client.ts:359-376 (handler)

  Core implementation of getTokenInfo: constructs API request to /api/price/token-info endpoint with token, chain, and specificChain parameters, and handles the HTTP GET request via the client's request method.
  async getTokenInfo( token: string, chain?: BlockchainType, specificChain?: SpecificChain ): Promise<TokenInfoResponse | ErrorResponse> { const params = new URLSearchParams(); params.append('token', token); if (chain) params.append('chain', chain); if (specificChain) params.append('specificChain', specificChain); return this.request<TokenInfoResponse>( 'GET', `/api/price/token-info?${params.toString()}`, null, 'get token info' ); }