Bithumb MCP Server

Instructions

Implementation Reference

• src/bitThumb/index.ts:222-238 (handler)

  Core handler function implementing the logic to fetch user transaction history via Bithumb's private API.

  public async postUserTransactions(
    searchGb: number,
    orderCurrency: string,
    offset?: number,
    count?: number,
  ): Promise<IPostUserTransactions> {
    const param = {
      searchGb,
      order_currency: orderCurrency,
      offset,
      count,
    };
    const res = <IPostUserTransactions>(
      await this.requestInfo('user_transactions', param)
    );
    return res;
  }

• src/index.ts:195-207 (registration)

  MCP tool registration defining the name, description, and input schema.

  {
    name: 'post_user_transactions',
    description: 'Get member\'s transaction completion history (Private)',
    inputSchema: {
      type: 'object',
      properties: {
        searchGb: { type: 'number', enum: [0, 1, 2, 3, 4, 5, 9], description: 'Search type (0: all, 1: buy complete, 2: sell complete, 3: withdrawal processing, 4: deposit, 5: withdrawal complete, 9: KRW deposit)' },
        orderCurrency: { type: 'string', description: 'Cryptocurrency symbol (e.g. BTC, ETH)' },
        offset: { type: 'number', description: 'Start index for retrieval (optional)' },
        count: { type: 'number', description: 'Number of transactions to retrieve (optional, default: 20)' }
      },
      required: ['searchGb', 'orderCurrency']
    }

• src/index.ts:355-361 (handler)

  MCP server handler that routes the tool call to the BithumbApi instance.

  case 'post_user_transactions':
    result = await this.bithumbApi.postUserTransactions(
      args.searchGb as number,
      args.orderCurrency as string,
      args.offset as number | undefined,
      args.count as number | undefined
    );

• src/bitThumb/types/user-transactions.interface.ts:1-20 (schema)

  TypeScript interfaces defining the structure of the response data for the tool.

  import { IBithumbResponse } from './bithumb-response.interface.js';
  
  interface IUserTransactions {
    search: string;
    transfer_date: number;
    order_currenecy: string;
    payment_currency: string;
    units: string;
    price: string;
    amount: string;
    fee_currency: string;
    fee: string;
    order_balance: string;
    payment_balance: string;
  }
  
  export interface IPostUserTransactions extends IBithumbResponse {
    data: IUserTransactions[];
  }