Bithumb MCP Server

Instructions

Implementation Reference

• src/bitThumb/index.ts:244-258 (handler)

  Core handler function for the 'post_place' tool. Prepares parameters and calls the Bithumb trade API's 'place' endpoint to submit a limit order.

  public async postPlace(
    orderCurrency: string,
    units: number,
    price: number,
    type: tradeType,
  ): Promise<IPostPlace> {
    const param = {
      order_currency: orderCurrency,
      units,
      price,
      type,
    };
    const res = <IPostPlace>await this.requestTrade('place', param);
    return res;
  }

• src/index.ts:209-222 (registration)

  Tool registration in the MCP server's tools list, defining the name, description, and input schema for 'post_place'.

  {
    name: 'post_place',
    description: 'Place a limit order (buy/sell) (Private)',
    inputSchema: {
      type: 'object',
      properties: {
        orderCurrency: { type: 'string', description: 'Cryptocurrency symbol (e.g. BTC, ETH)' },
        units: { type: 'number', description: 'Order quantity' },
        price: { type: 'number', description: 'Order price' },
        type: { type: 'string', enum: ['bid', 'ask'], description: 'Order type (bid or ask)' }
      },
      required: ['orderCurrency', 'units', 'price', 'type']
    }
  },

• src/index.ts:363-370 (registration)

  Dispatch logic in the CallToolRequest handler that maps the tool call to the bithumbApi.postPlace method.

  case 'post_place':
    result = await this.bithumbApi.postPlace(
      args.orderCurrency as string,
      args.units as number,
      args.price as number,
      args.type as tradeType // Cast to expected type
    );
    break;

• src/bitThumb/types/place.interface.ts:3-5 (schema)

  TypeScript interface defining the response structure for the postPlace API call, including the order_id.

  export interface IPostPlace extends IBithumbResponse {
    order_id: string;
  }