Upbit MCP Server

Instructions

Implementation Reference

• src/tools/get-orders.ts:19-35 (handler)

  The main handler function that executes the tool: authenticates, builds query for Upbit orders API, fetches and returns JSON data.

  execute: async ({ market, state, page, limit }: Params) => {
  	ensurePrivateEnabled();
  	const baseURL = `${config.upbit.baseUrl}${config.upbit.apiBasePath}`;
  	const client = createHttpClient(baseURL);
  	const query: Record<string, string> = {
  		state,
  		page: String(page),
  		limit: String(limit),
  	};
  	if (market) query.market = market;
  	const token = signJwtToken(query);
  	const data = await fetchJson<unknown>(client, "/orders", {
  		params: query,
  		headers: { Authorization: `Bearer ${token}` },
  	});
  	return JSON.stringify(data, null, 2);
  },

• src/tools/get-orders.ts:6-11 (schema)

  Zod schema defining input parameters for the tool: market (optional), state (wait/done/cancel), page, limit.

  const paramsSchema = z.object({
  	market: z.string().optional(),
  	state: z.enum(["wait", "done", "cancel"]).default("wait"),
  	page: z.number().int().min(1).default(1),
  	limit: z.number().int().min(1).max(100).default(100),
  });

• src/index.ts:36-36 (registration)

  Registers the getOrdersTool (named GET_ORDERS) with the FastMCP server.

  server.addTool(getOrdersTool);