Bithumb MCP Server

Instructions

Implementation Reference

• src/bitThumb/index.ts:298-309 (handler)

  Core handler function that executes the market sell order by constructing parameters and invoking the Bithumb trade API via requestTrade('market_sell').

  public async postMarketSell(
    units: number,
    orderCurrency: string,
  ): Promise<IPostMarketSell> {
    const param = {
      units,
      order_currency: orderCurrency,
    };
  
    const res = <IPostMarketSell>await this.requestTrade('market_sell', param);
    return res;
  }

• src/index.ts:251-258 (schema)

  Input schema for the post_market_sell tool, specifying units (number, quantity to sell) and orderCurrency (string, e.g., BTC) as required fields.

  inputSchema: {
    type: 'object',
    properties: {
      units: { type: 'number', description: 'Quantity to sell' },
      orderCurrency: { type: 'string', description: 'Cryptocurrency symbol (e.g. BTC, ETH)' }
    },
    required: ['units', 'orderCurrency']
  }

• src/index.ts:248-259 (registration)

  Registration of the 'post_market_sell' tool in the MCP server's tools list, including name, description, and input schema.

  {
    name: 'post_market_sell',
    description: 'Place a market sell order (Private)',
    inputSchema: {
      type: 'object',
      properties: {
        units: { type: 'number', description: 'Quantity to sell' },
        orderCurrency: { type: 'string', description: 'Cryptocurrency symbol (e.g. BTC, ETH)' }
      },
      required: ['units', 'orderCurrency']
    }
  },

• src/index.ts:381-383 (handler)

  Top-level MCP tool handler switch case that invokes the Bithumb API client's postMarketSell method with parsed arguments.

  case 'post_market_sell':
    result = await this.bithumbApi.postMarketSell(args.units as number, args.orderCurrency as string);
    break;

• src/bitThumb/types/market-sell.interface.ts:3-6 (schema)

  TypeScript interface for the response of post market sell, extending IBithumbResponse and adding order_id field.

  export interface IPostMarketSell extends IBithumbResponse {
    order_id: string;
  }