Bithumb MCP Server

Instructions

Implementation Reference

• src/bitThumb/index.ts:77-85 (handler)

  Core handler function implementing the get_transaction_history tool by calling Bithumb's public transaction_history endpoint.

  public async getTransactionHistory(
    coinCode: string,
  ): Promise<IGetTransactionHistory> {
    const param = `${coinCode}_${this.paymentCurrency}`;
    const res = <IGetTransactionHistory>(
      await this.requestPublic('transaction_history', param)
    );
    return res;
  }

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

  Tool registration in the MCP server, defining name, description, and input schema.

  {
    name: 'get_transaction_history',
    description: 'Get recent transaction history (Public)',
    inputSchema: {
      type: 'object',
      properties: {
        coinCode: { type: 'string', description: 'Cryptocurrency symbol (e.g. BTC, ETH)' }
      },
      required: ['coinCode']
    }

• src/index.ts:303-304 (handler)

  MCP CallToolRequestHandler dispatch case that invokes the specific tool handler.

  case 'get_transaction_history':
    result = await this.bithumbApi.getTransactionHistory(args.coinCode as string);

• src/bitThumb/types/transaction-history.interface.ts:11-13 (schema)

  TypeScript interface defining the output structure for getTransactionHistory response.

  export interface IGetTransactionHistory extends IBithumbResponse {
    data: ITransactionHistory[];
  }

• src/index.ts:88-93 (schema)

  JSON schema defining the input parameters for the tool (coinCode required).

  inputSchema: {
    type: 'object',
    properties: {
      coinCode: { type: 'string', description: 'Cryptocurrency symbol (e.g. BTC, ETH)' }
    },
    required: ['coinCode']