Bithumb MCP Server

Instructions

Implementation Reference

• src/bitThumb/index.ts:113-133 (handler)

  Core implementation of GetCandlestick: fetches raw candlestick data from Bithumb public API endpoint and maps it to structured IGetCandlestickData array.
  public async GetCandlestick( orderCurrency: string, paymentCurrency: currencyType, chartIntervals: Time, ): Promise<IGetCandlestickData[]> { const endpoint = `/candlestick/${orderCurrency}_${paymentCurrency}`; const res = <IGetCandlestick>( await this.requestPublic(endpoint, chartIntervals) ); const candleData: IGetCandlestickData[] = res.data.map((candle) => ({ timestamp: candle[0], opening_price: candle[1], closing_price: candle[2], max_price: candle[3], min_price: candle[4], volume: candle[5], })); return candleData; }
• src/index.ts:312-318 (handler)

  MCP server tool handler for 'get_candlestick': extracts arguments and calls bithumbApi.GetCandlestick.
  case 'get_candlestick': result = await this.bithumbApi.GetCandlestick( args.orderCurrency as string, args.paymentCurrency as currencyType, // Cast to expected type args.chartIntervals as Time // Cast to expected type ); break;
• src/index.ts:113-124 (registration)

  Tool registration in MCP server: defines name, description, and input schema for 'get_candlestick'.
  name: 'get_candlestick', description: 'Get Candlestick data (Public)', inputSchema: { type: 'object', properties: { orderCurrency: { type: 'string', description: 'Cryptocurrency symbol (e.g. BTC, ETH)' }, paymentCurrency: { type: 'string', enum: ['KRW', 'BTC'], description: 'Payment currency (KRW or BTC)' }, // Assuming KRW/BTC based on standard usage chartIntervals: { type: 'string', enum: ['1m', '3m', '5m', '10m', '30m', '1h', '6h', '12h', '24h'], description: 'Chart interval' } // Assuming standard intervals }, required: ['orderCurrency', 'paymentCurrency', 'chartIntervals'] } },
• src/bitThumb/types/get-candlestick-data.interface.ts:1-8 (schema)

  TypeScript interface defining the structure of processed candlestick data returned by the tool.
  export interface IGetCandlestickData { timestamp: number; opening_price: string; closing_price: string; max_price: string; min_price: string; volume: string; }
• src/bitThumb/types/get-candlestick.interface.ts:3-7 (schema)

  TypeScript interface for raw Bithumb API candlestick response.
  export interface IGetCandlestick extends IBithumbResponse { /** [timestamp, opening amount, closing amount, max price, min price, volume] */ data: [number, string, string, string, string, string][]; }