@2oolkit/kiwoom-cli 0.1.0

package/dist/mcp.js

@@ -0,0 +1,1097 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/mcp.ts
+var import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
+var import_stdio = require("@modelcontextprotocol/sdk/server/stdio.js");
+
+// src/mcp/tools/market.ts
+var import_zod = require("zod");
+
+// src/config/constants.ts
+var BASE_URLS = {
+  real: "https://api.kiwoom.com",
+  mock: "https://mockapi.kiwoom.com"
+};
+var ENV_ALIASES = {
+  real: "real",
+  prod: "real",
+  production: "real",
+  live: "real",
+  \uC2E4\uC804: "real",
+  \uC2E4\uC804\uD22C\uC790: "real",
+  mock: "mock",
+  test: "mock",
+  paper: "mock",
+  demo: "mock",
+  \uBAA8\uC758: "mock",
+  \uBAA8\uC758\uD22C\uC790: "mock"
+};
+var TOKEN_PATH = "/oauth2/token";
+var REVOKE_PATH = "/oauth2/revoke";
+var CONFIG_DIR_NAME = ".kiwoom-cli";
+var CONFIG_FILE_NAME = "config.json";
+var TOKEN_FILE_NAME = "token.json";
+var ENV_VARS = {
+  appkey: "KIWOOM_APPKEY",
+  secretkey: "KIWOOM_SECRETKEY",
+  env: "KIWOOM_ENV"
+};
+var TOKEN_REFRESH_BUFFER_MS = 6e4;
+var REQUEST_TIMEOUT_MS = 3e4;
+var SOFT_EMPTY_RETURN_CODES = /* @__PURE__ */ new Set([20]);
+var ORDER_EXCHANGE_TYPES = ["KRX", "NXT", "SOR"];
+var ORDER_TYPES = {
+  "0": "\uBCF4\uD1B5(\uC9C0\uC815\uAC00/limit)",
+  "3": "\uC2DC\uC7A5\uAC00(market)",
+  "5": "\uC870\uAC74\uBD80\uC9C0\uC815\uAC00",
+  "6": "\uCD5C\uC720\uB9AC\uC9C0\uC815\uAC00",
+  "7": "\uCD5C\uC6B0\uC120\uC9C0\uC815\uAC00",
+  "10": "\uBCF4\uD1B5(IOC)",
+  "13": "\uC2DC\uC7A5\uAC00(IOC)",
+  "16": "\uCD5C\uC720\uB9AC(IOC)",
+  "20": "\uBCF4\uD1B5(FOK)",
+  "23": "\uC2DC\uC7A5\uAC00(FOK)",
+  "26": "\uCD5C\uC720\uB9AC(FOK)",
+  "28": "\uC2A4\uD1B1\uC9C0\uC815\uAC00(stop-limit)",
+  "29": "\uC911\uAC04\uAC00",
+  "30": "\uC911\uAC04\uAC00(IOC)",
+  "31": "\uC911\uAC04\uAC00(FOK)",
+  "61": "\uC7A5\uC2DC\uC791\uC804\uC2DC\uAC04\uC678",
+  "62": "\uC2DC\uAC04\uC678\uB2E8\uC77C\uAC00",
+  "81": "\uC7A5\uB9C8\uAC10\uD6C4\uC2DC\uAC04\uC678"
+};
+var MARKET_ORDER_TYPES = /* @__PURE__ */ new Set(["3", "13", "23"]);
+
+// src/config/store.ts
+var fs = __toESM(require("fs"));
+var path = __toESM(require("path"));
+var os = __toESM(require("os"));
+var DEFAULT_CONFIG = { env: "real" };
+function getConfigDir() {
+  return path.join(os.homedir(), CONFIG_DIR_NAME);
+}
+function getConfigPath() {
+  return path.join(getConfigDir(), CONFIG_FILE_NAME);
+}
+function getTokenPath() {
+  return path.join(getConfigDir(), TOKEN_FILE_NAME);
+}
+function ensureConfigDir() {
+  const dir = getConfigDir();
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { mode: 448, recursive: true });
+  } else {
+    try {
+      fs.chmodSync(dir, 448);
+    } catch {
+    }
+  }
+}
+function writeSecure(filePath, data) {
+  fs.writeFileSync(filePath, data, { mode: 384 });
+  try {
+    fs.chmodSync(filePath, 384);
+  } catch {
+  }
+}
+function loadConfig() {
+  try {
+    const raw = fs.readFileSync(getConfigPath(), "utf-8");
+    return { ...DEFAULT_CONFIG, ...JSON.parse(raw) };
+  } catch {
+    return { ...DEFAULT_CONFIG };
+  }
+}
+function getEffectiveConfig() {
+  const disk = loadConfig();
+  const envVal = process.env[ENV_VARS.env];
+  const env = envVal && ENV_ALIASES[envVal.toLowerCase()] ? ENV_ALIASES[envVal.toLowerCase()] : disk.env;
+  return {
+    env,
+    appkey: disk.appkey ?? process.env[ENV_VARS.appkey],
+    secretkey: disk.secretkey ?? process.env[ENV_VARS.secretkey]
+  };
+}
+function loadTokenCache() {
+  try {
+    return JSON.parse(fs.readFileSync(getTokenPath(), "utf-8"));
+  } catch {
+    return {};
+  }
+}
+function getCachedToken(env) {
+  return loadTokenCache()[env];
+}
+function saveCachedToken(env, token) {
+  ensureConfigDir();
+  const cache = loadTokenCache();
+  cache[env] = token;
+  writeSecure(getTokenPath(), JSON.stringify(cache, null, 2));
+}
+function clearCachedToken(env) {
+  if (!env) {
+    try {
+      fs.rmSync(getTokenPath());
+    } catch {
+    }
+    return;
+  }
+  const cache = loadTokenCache();
+  delete cache[env];
+  try {
+    ensureConfigDir();
+    writeSecure(getTokenPath(), JSON.stringify(cache, null, 2));
+  } catch {
+  }
+}
+
+// src/output/error.ts
+var ActionableError = class extends Error {
+  suggestedCommand;
+  constructor(message, suggestedCommand) {
+    super(message);
+    this.name = "ActionableError";
+    this.suggestedCommand = suggestedCommand;
+  }
+};
+var KiwoomApiError = class extends Error {
+  returnCode;
+  returnMsg;
+  apiId;
+  constructor(returnCode, returnMsg, apiId) {
+    super(`[${returnCode}] ${returnMsg}`);
+    this.name = "KiwoomApiError";
+    this.returnCode = returnCode;
+    this.returnMsg = returnMsg;
+    this.apiId = apiId;
+  }
+};
+
+// src/utils/helpers.ts
+function normalizeStockCode(code) {
+  const trimmed = code.trim().toUpperCase();
+  const stripped = trimmed.replace(/^A(?=\d)/, "");
+  const base = stripped.split("_")[0];
+  if (!/^\d{6}$/.test(base)) {
+    throw new ActionableError(
+      `Invalid stock code "${code}". Expected a 6-digit code like 005930 (\uC0BC\uC131\uC804\uC790).`
+    );
+  }
+  return base;
+}
+function parseKiwoomExpiry(expiresDt) {
+  const m = expiresDt.match(/^(\d{4})(\d{2})(\d{2})(\d{2})(\d{2})(\d{2})$/);
+  if (!m) return NaN;
+  const [, y, mo, d, h, mi, s] = m;
+  return Date.parse(`${y}-${mo}-${d}T${h}:${mi}:${s}+09:00`);
+}
+function isTokenExpired(expiresDt, bufferMs = 0) {
+  const expiry = parseKiwoomExpiry(expiresDt);
+  if (Number.isNaN(expiry)) return true;
+  return Date.now() + bufferMs >= expiry;
+}
+function todayKst() {
+  const now = new Date(Date.now() + 9 * 3600 * 1e3);
+  return now.toISOString().slice(0, 10).replace(/-/g, "");
+}
+
+// src/client/api-client.ts
+function fetchWithTimeout(url, init) {
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+  return fetch(url, { ...init, signal: controller.signal }).finally(
+    () => clearTimeout(timeoutId)
+  );
+}
+var KiwoomClient = class {
+  env;
+  baseUrl;
+  appkey;
+  secretkey;
+  tokenOverride;
+  memoToken;
+  constructor(opts) {
+    this.env = opts.env;
+    this.baseUrl = BASE_URLS[opts.env];
+    if (!this.baseUrl) {
+      throw new Error(`Invalid environment: ${opts.env}. Use: real, mock`);
+    }
+    this.appkey = opts.appkey;
+    this.secretkey = opts.secretkey;
+    this.tokenOverride = opts.token;
+  }
+  getEnv() {
+    return this.env;
+  }
+  /** Ensure a valid token exists (issuing + caching as needed) and return it. */
+  async authenticate() {
+    return this.getToken();
+  }
+  // ─── OAuth2 ───────────────────────────────────────────────────────────────
+  /** Issue a fresh access token from the app key + secret key. */
+  async issueToken() {
+    if (!this.appkey || !this.secretkey) {
+      throw new ActionableError(
+        "App key and secret key are required to issue a token.",
+        "kiwoom-cli config init"
+      );
+    }
+    const res = await fetchWithTimeout(`${this.baseUrl}${TOKEN_PATH}`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json;charset=UTF-8" },
+      body: JSON.stringify({
+        grant_type: "client_credentials",
+        appkey: this.appkey,
+        secretkey: this.secretkey
+      })
+    });
+    const body = await res.json().catch(() => ({}));
+    if (!res.ok || body.return_code !== 0 || !body.token) {
+      throw new KiwoomApiError(
+        body.return_code ?? res.status,
+        body.return_msg ?? `Token request failed (HTTP ${res.status})`
+      );
+    }
+    return { token: body.token, expiresDt: body.expires_dt };
+  }
+  /** Revoke an access token (defaults to the cached/override token). */
+  async revokeToken(token) {
+    if (!this.appkey || !this.secretkey) {
+      throw new ActionableError(
+        "App key and secret key are required to revoke a token.",
+        "kiwoom-cli config init"
+      );
+    }
+    const target = token ?? this.tokenOverride ?? getCachedToken(this.env)?.token;
+    if (!target) {
+      throw new ActionableError("No token to revoke.");
+    }
+    const res = await fetchWithTimeout(`${this.baseUrl}${REVOKE_PATH}`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json;charset=UTF-8" },
+      body: JSON.stringify({
+        appkey: this.appkey,
+        secretkey: this.secretkey,
+        token: target
+      })
+    });
+    const body = await res.json().catch(() => ({}));
+    if (!res.ok || body.return_code !== 0) {
+      throw new KiwoomApiError(
+        body.return_code ?? res.status,
+        body.return_msg ?? `Token revoke failed (HTTP ${res.status})`
+      );
+    }
+    clearCachedToken(this.env);
+    return body;
+  }
+  /**
+   * Return a valid token, reusing the cache when possible and issuing+caching a
+   * new one when missing or near expiry.
+   */
+  async getToken() {
+    if (this.tokenOverride) return this.tokenOverride;
+    if (this.memoToken) return this.memoToken;
+    const cached = getCachedToken(this.env);
+    const hint = this.appkey?.slice(0, 6);
+    if (cached && cached.appkeyHint === hint && !isTokenExpired(cached.expiresDt, TOKEN_REFRESH_BUFFER_MS)) {
+      this.memoToken = cached.token;
+      return cached.token;
+    }
+    const { token, expiresDt } = await this.issueToken();
+    this.memoToken = token;
+    if (hint) {
+      saveCachedToken(this.env, { token, expiresDt, appkeyHint: hint });
+    }
+    return token;
+  }
+  // ─── Generic TR request ──────────────────────────────────────────────────
+  /**
+   * Execute a TR. `apiId` is sent in the api-id header; `path` is the category
+   * route (e.g. /api/dostk/stkinfo). Returns the parsed body plus pagination.
+   */
+  async request(apiId, path2, body = {}, options = {}) {
+    const send = async (token) => fetchWithTimeout(`${this.baseUrl}${path2}`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json;charset=UTF-8",
+        authorization: `Bearer ${token}`,
+        "api-id": options.apiId ?? apiId,
+        "cont-yn": options.contYn ?? "N",
+        "next-key": options.nextKey ?? ""
+      },
+      body: JSON.stringify(body)
+    });
+    let res = await send(await this.getToken());
+    if (res.status === 401 && !this.tokenOverride) {
+      clearCachedToken(this.env);
+      this.memoToken = void 0;
+      res = await send(await this.getToken());
+    }
+    const payload = await res.json().catch(() => ({}));
+    if (!res.ok) {
+      throw new KiwoomApiError(
+        payload.return_code ?? res.status,
+        payload.return_msg ?? `Request failed (HTTP ${res.status})`,
+        apiId
+      );
+    }
+    if (typeof payload.return_code === "number" && payload.return_code !== 0 && !SOFT_EMPTY_RETURN_CODES.has(payload.return_code)) {
+      throw new KiwoomApiError(payload.return_code, payload.return_msg ?? "Error", apiId);
+    }
+    return {
+      data: payload,
+      contYn: res.headers.get("cont-yn") === "Y",
+      nextKey: res.headers.get("next-key") ?? ""
+    };
+  }
+  /**
+   * Execute an endpoint from the registry. When `paginate` is set and the
+   * endpoint declares a listKey, all pages are fetched and concatenated.
+   */
+  async callEndpoint(def, body = {}, opts = {}) {
+    if (opts.paginate && def.listKey) {
+      const data = await this.requestAll(def.apiId, def.path, body, def.listKey);
+      return { data, contYn: false, nextKey: "" };
+    }
+    return this.request(def.apiId, def.path, body, {
+      contYn: opts.contYn,
+      nextKey: opts.nextKey
+    });
+  }
+  /**
+   * Fetch all pages of a TR, concatenating the array under `listKey`.
+   * Caps at `maxPages` to avoid runaway loops.
+   */
+  async requestAll(apiId, path2, body, listKey, maxPages = 20) {
+    let page = await this.request(apiId, path2, body);
+    const acc = Array.isArray(page.data[listKey]) ? [...page.data[listKey]] : [];
+    let pages = 1;
+    while (page.contYn && page.nextKey && pages < maxPages) {
+      page = await this.request(apiId, path2, body, {
+        contYn: "Y",
+        nextKey: page.nextKey
+      });
+      if (Array.isArray(page.data[listKey])) acc.push(...page.data[listKey]);
+      pages += 1;
+    }
+    return { ...page.data, [listKey]: acc };
+  }
+};
+
+// src/mcp/helpers.ts
+function mcpText(text) {
+  return { content: [{ type: "text", text }] };
+}
+function mcpJson(data) {
+  return mcpText(JSON.stringify(data, null, 2));
+}
+function mcpError(message) {
+  return {
+    content: [{ type: "text", text: `ERROR: ${message}` }],
+    isError: true
+  };
+}
+function clientOrThrow() {
+  const config = getEffectiveConfig();
+  if (!config.appkey || !config.secretkey) {
+    throw new Error("App key / secret key not configured. Run: kiwoom-cli config init");
+  }
+  return new KiwoomClient({
+    env: config.env,
+    appkey: config.appkey,
+    secretkey: config.secretkey
+  });
+}
+function currentEnv() {
+  return getEffectiveConfig().env;
+}
+function tool(server2, name, config, handler) {
+  server2.registerTool(name, config, handler);
+}
+async function withErrorHandling(fn) {
+  try {
+    return await fn();
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return mcpError(message.slice(0, 500));
+  }
+}
+
+// src/client/endpoints.ts
+var PATHS = {
+  stkinfo: "/api/dostk/stkinfo",
+  mrkcond: "/api/dostk/mrkcond",
+  chart: "/api/dostk/chart",
+  acnt: "/api/dostk/acnt",
+  ordr: "/api/dostk/ordr",
+  crdordr: "/api/dostk/crdordr",
+  rkinfo: "/api/dostk/rkinfo",
+  sect: "/api/dostk/sect"
+};
+var ENDPOINTS = {
+  // ── Stock info (종목정보) ──────────────────────────────────────────────────
+  stockInfo: { apiId: "ka10001", path: PATHS.stkinfo, korean: "\uC8FC\uC2DD\uAE30\uBCF8\uC815\uBCF4\uC694\uCCAD" },
+  tradingMembers: { apiId: "ka10002", path: PATHS.stkinfo, korean: "\uC8FC\uC2DD\uAC70\uB798\uC6D0\uC694\uCCAD" },
+  stockTrades: { apiId: "ka10003", path: PATHS.stkinfo, korean: "\uCCB4\uACB0\uC815\uBCF4\uC694\uCCAD", listKey: "cntr_infr" },
+  watchlist: { apiId: "ka10095", path: PATHS.stkinfo, korean: "\uAD00\uC2EC\uC885\uBAA9\uC815\uBCF4\uC694\uCCAD", listKey: "atn_stk_infr" },
+  stockList: { apiId: "ka10099", path: PATHS.stkinfo, korean: "\uC885\uBAA9\uC815\uBCF4 \uB9AC\uC2A4\uD2B8", listKey: "list" },
+  stockInfoSingle: { apiId: "ka10100", path: PATHS.stkinfo, korean: "\uC885\uBAA9\uC815\uBCF4 \uC870\uD68C" },
+  sectorCodeList: { apiId: "ka10101", path: PATHS.stkinfo, korean: "\uC5C5\uC885\uCF54\uB4DC \uB9AC\uC2A4\uD2B8", listKey: "list" },
+  creditTrend: { apiId: "ka10013", path: PATHS.stkinfo, korean: "\uC2E0\uC6A9\uB9E4\uB9E4\uB3D9\uD5A5\uC694\uCCAD", listKey: "crd_trde_trend" },
+  // ── Market quote (시세) ────────────────────────────────────────────────────
+  orderbook: { apiId: "ka10004", path: PATHS.mrkcond, korean: "\uC8FC\uC2DD\uD638\uAC00\uC694\uCCAD" },
+  quoteSnapshot: { apiId: "ka10006", path: PATHS.mrkcond, korean: "\uC8FC\uC2DD\uC2DC\uBD84\uC694\uCCAD" },
+  priceTableInfo: { apiId: "ka10007", path: PATHS.mrkcond, korean: "\uC2DC\uC138\uD45C\uC131\uC815\uBCF4\uC694\uCCAD" },
+  dailyPrice: { apiId: "ka10086", path: PATHS.mrkcond, korean: "\uC77C\uBCC4\uC8FC\uAC00\uC694\uCCAD", listKey: "daly_stkpc" },
+  instTradedStocks: { apiId: "ka10044", path: PATHS.mrkcond, korean: "\uC77C\uBCC4\uAE30\uAD00\uB9E4\uB9E4\uC885\uBAA9\uC694\uCCAD", listKey: "daly_orgn_trde_stk" },
+  instForeignTrend: { apiId: "ka10045", path: PATHS.mrkcond, korean: "\uC885\uBAA9\uBCC4\uAE30\uAD00\uB9E4\uB9E4\uCD94\uC774\uC694\uCCAD", listKey: "stk_orgn_trde_trnsn" },
+  strengthByTime: { apiId: "ka10046", path: PATHS.mrkcond, korean: "\uCCB4\uACB0\uAC15\uB3C4\uC2DC\uAC04\uBCC4\uC694\uCCAD", listKey: "cntr_str_tm" },
+  strengthByDay: { apiId: "ka10047", path: PATHS.mrkcond, korean: "\uCCB4\uACB0\uAC15\uB3C4\uC77C\uBCC4\uC694\uCCAD", listKey: "cntr_str_daly" },
+  afterHoursOrderbook: { apiId: "ka10087", path: PATHS.mrkcond, korean: "\uC2DC\uAC04\uC678\uB2E8\uC77C\uAC00\uC694\uCCAD" },
+  // ── Chart (차트) ───────────────────────────────────────────────────────────
+  tickChart: { apiId: "ka10079", path: PATHS.chart, korean: "\uC8FC\uC2DD\uD2F1\uCC28\uD2B8\uC870\uD68C", listKey: "stk_tic_chart_qry" },
+  minuteChart: { apiId: "ka10080", path: PATHS.chart, korean: "\uC8FC\uC2DD\uBD84\uBD09\uCC28\uD2B8\uC870\uD68C", listKey: "stk_min_pole_chart_qry" },
+  dailyChart: { apiId: "ka10081", path: PATHS.chart, korean: "\uC8FC\uC2DD\uC77C\uBD09\uCC28\uD2B8\uC870\uD68C", listKey: "stk_dt_pole_chart_qry" },
+  // NOTE: weekly list key is the doubled "stk_stk_..." — verified live, not a typo.
+  weeklyChart: { apiId: "ka10082", path: PATHS.chart, korean: "\uC8FC\uC2DD\uC8FC\uBD09\uCC28\uD2B8\uC870\uD68C", listKey: "stk_stk_pole_chart_qry" },
+  monthlyChart: { apiId: "ka10083", path: PATHS.chart, korean: "\uC8FC\uC2DD\uC6D4\uBD09\uCC28\uD2B8\uC870\uD68C", listKey: "stk_mth_pole_chart_qry" },
+  yearlyChart: { apiId: "ka10094", path: PATHS.chart, korean: "\uC8FC\uC2DD\uB144\uBD09\uCC28\uD2B8\uC870\uD68C", listKey: "stk_yr_pole_chart_qry" },
+  // ── Account (계좌) ─────────────────────────────────────────────────────────
+  balance: { apiId: "kt00018", path: PATHS.acnt, korean: "\uACC4\uC88C\uD3C9\uAC00\uC794\uACE0\uB0B4\uC5ED\uC694\uCCAD", listKey: "acnt_evlt_remn_indv_tot" },
+  deposit: { apiId: "kt00001", path: PATHS.acnt, korean: "\uC608\uC218\uAE08\uC0C1\uC138\uD604\uD669\uC694\uCCAD", listKey: "stk_entr_prst" },
+  evalStatus: { apiId: "kt00004", path: PATHS.acnt, korean: "\uACC4\uC88C\uD3C9\uAC00\uD604\uD669\uC694\uCCAD", listKey: "stk_acnt_evlt_prst" },
+  settledBalance: { apiId: "kt00005", path: PATHS.acnt, korean: "\uCCB4\uACB0\uC794\uACE0\uC694\uCCAD", listKey: "stk_cntr_remn" },
+  orderDetail: { apiId: "kt00007", path: PATHS.acnt, korean: "\uACC4\uC88C\uBCC4\uC8FC\uBB38\uCCB4\uACB0\uB0B4\uC5ED\uC0C1\uC138\uC694\uCCAD", listKey: "acnt_ord_cntr_prps_dtl" },
+  orderStatus: { apiId: "kt00009", path: PATHS.acnt, korean: "\uACC4\uC88C\uBCC4\uC8FC\uBB38\uCCB4\uACB0\uD604\uD669\uC694\uCCAD", listKey: "acnt_ord_cntr_prst" },
+  openOrders: { apiId: "ka10075", path: PATHS.acnt, korean: "\uBBF8\uCCB4\uACB0\uC694\uCCAD", listKey: "oso" },
+  executions: { apiId: "ka10076", path: PATHS.acnt, korean: "\uCCB4\uACB0\uC694\uCCAD", listKey: "cntr" },
+  realizedPlByDate: { apiId: "ka10072", path: PATHS.acnt, korean: "\uC77C\uC790\uBCC4\uC885\uBAA9\uBCC4\uC2E4\uD604\uC190\uC775\uC694\uCCAD_\uC77C\uC790", listKey: "dt_stk_div_rlzt_pl" },
+  realizedPlByPeriod: { apiId: "ka10073", path: PATHS.acnt, korean: "\uC77C\uC790\uBCC4\uC885\uBAA9\uBCC4\uC2E4\uD604\uC190\uC775\uC694\uCCAD_\uAE30\uAC04", listKey: "dt_stk_rlzt_pl" },
+  tradeJournal: { apiId: "ka10170", path: PATHS.acnt, korean: "\uB2F9\uC77C\uB9E4\uB9E4\uC77C\uC9C0\uC694\uCCAD", listKey: "tdy_trde_diary" },
+  dailyReturn: { apiId: "kt00016", path: PATHS.acnt, korean: "\uC77C\uBCC4\uACC4\uC88C\uC218\uC775\uB960\uC0C1\uC138\uD604\uD669\uC694\uCCAD" },
+  // ── Order (주문) — WRITE, real money ──────────────────────────────────────
+  buy: { apiId: "kt10000", path: PATHS.ordr, korean: "\uC8FC\uC2DD \uB9E4\uC218\uC8FC\uBB38", isWrite: true },
+  sell: { apiId: "kt10001", path: PATHS.ordr, korean: "\uC8FC\uC2DD \uB9E4\uB3C4\uC8FC\uBB38", isWrite: true },
+  modify: { apiId: "kt10002", path: PATHS.ordr, korean: "\uC8FC\uC2DD \uC815\uC815\uC8FC\uBB38", isWrite: true },
+  cancel: { apiId: "kt10003", path: PATHS.ordr, korean: "\uC8FC\uC2DD \uCDE8\uC18C\uC8FC\uBB38", isWrite: true },
+  creditBuy: { apiId: "kt10006", path: PATHS.crdordr, korean: "\uC2E0\uC6A9 \uB9E4\uC218\uC8FC\uBB38", isWrite: true },
+  creditSell: { apiId: "kt10007", path: PATHS.crdordr, korean: "\uC2E0\uC6A9 \uB9E4\uB3C4\uC8FC\uBB38", isWrite: true },
+  creditModify: { apiId: "kt10008", path: PATHS.crdordr, korean: "\uC2E0\uC6A9 \uC815\uC815\uC8FC\uBB38", isWrite: true },
+  creditCancel: { apiId: "kt10009", path: PATHS.crdordr, korean: "\uC2E0\uC6A9 \uCDE8\uC18C\uC8FC\uBB38", isWrite: true },
+  // ── Ranking (순위정보) ─────────────────────────────────────────────────────
+  rankFluctuation: { apiId: "ka10027", path: PATHS.rkinfo, korean: "\uC804\uC77C\uB300\uBE44\uB4F1\uB77D\uB960\uC21C\uC704\uC694\uCCAD", listKey: "pred_pre_flu_rt_upper" },
+  rankVolume: { apiId: "ka10030", path: PATHS.rkinfo, korean: "\uB2F9\uC77C\uAC70\uB798\uB7C9\uC0C1\uC704\uC694\uCCAD", listKey: "tdy_trde_qty_upper" },
+  rankTradeAmount: { apiId: "ka10032", path: PATHS.rkinfo, korean: "\uAC70\uB798\uB300\uAE08\uC0C1\uC704\uC694\uCCAD", listKey: "trde_prica_upper" },
+  rankVolumeSurge: { apiId: "ka10023", path: PATHS.rkinfo, korean: "\uAC70\uB798\uB7C9\uAE09\uC99D\uC694\uCCAD", listKey: "trde_qty_sdnin" },
+  rankPrevVolume: { apiId: "ka10031", path: PATHS.rkinfo, korean: "\uC804\uC77C\uAC70\uB798\uB7C9\uC0C1\uC704\uC694\uCCAD", listKey: "pred_trde_qty_upper" },
+  // ── Sector / industry (업종) ───────────────────────────────────────────────
+  sectorPrice: { apiId: "ka20001", path: PATHS.sect, korean: "\uC5C5\uC885\uD604\uC7AC\uAC00\uC694\uCCAD", listKey: "inds_cur_prc_tm" },
+  sectorStocks: { apiId: "ka20002", path: PATHS.sect, korean: "\uC5C5\uC885\uBCC4\uC8FC\uAC00\uC694\uCCAD", listKey: "inds_stkpc" },
+  sectorAllIndex: { apiId: "ka20003", path: PATHS.sect, korean: "\uC804\uC5C5\uC885\uC9C0\uC218\uC694\uCCAD", listKey: "all_inds_idex" },
+  sectorDaily: { apiId: "ka20009", path: PATHS.sect, korean: "\uC5C5\uC885\uD604\uC7AC\uAC00 \uC77C\uBCC4\uC694\uCCAD", listKey: "inds_cur_prc_daly_rept" }
+};
+
+// src/utils/format.ts
+var NUMERIC_RE = /^([+-]*)0*(\d+)(\.\d+)?$/;
+function unpad(value) {
+  if (value === null || value === void 0) return "";
+  const str = String(value).trim();
+  const m = str.match(NUMERIC_RE);
+  if (!m) return str;
+  const sign = m[1].includes("-") ? "-" : m[1].includes("+") ? "+" : "";
+  const intPart = m[2].replace(/^0+(?=\d)/, "");
+  return `${sign}${intPart}${m[3] ?? ""}`;
+}
+function formatStamp(value) {
+  if (!value) return "";
+  const s = String(value).trim();
+  if (/^\d{14}$/.test(s)) {
+    return `${s.slice(0, 4)}-${s.slice(4, 6)}-${s.slice(6, 8)} ${s.slice(8, 10)}:${s.slice(10, 12)}:${s.slice(12, 14)}`;
+  }
+  if (/^\d{8}$/.test(s)) {
+    return `${s.slice(0, 4)}-${s.slice(4, 6)}-${s.slice(6, 8)}`;
+  }
+  if (/^\d{6}$/.test(s)) {
+    return `${s.slice(0, 2)}:${s.slice(2, 4)}:${s.slice(4, 6)}`;
+  }
+  return s;
+}
+
+// src/utils/orderbook.ts
+function parseOrderbook(d) {
+  const asks = [];
+  for (let n = 10; n >= 2; n--) {
+    asks.push({
+      level: n,
+      price: unpad(d[`sel_${n}th_pre_bid`]),
+      qty: unpad(d[`sel_${n}th_pre_req`])
+    });
+  }
+  asks.push({ level: 1, price: unpad(d.sel_fpr_bid), qty: unpad(d.sel_fpr_req) });
+  const bids = [];
+  bids.push({ level: 1, price: unpad(d.buy_fpr_bid), qty: unpad(d.buy_fpr_req) });
+  for (let n = 2; n <= 10; n++) {
+    bids.push({
+      level: n,
+      price: unpad(d[`buy_${n}th_pre_bid`]),
+      qty: unpad(d[`buy_${n}th_pre_req`])
+    });
+  }
+  return {
+    baseTime: formatStamp(d.bid_req_base_tm),
+    asks,
+    bids,
+    totalAskQty: unpad(d.tot_sel_req),
+    totalBidQty: unpad(d.tot_buy_req)
+  };
+}
+
+// src/mcp/tools/market.ts
+function registerMarketTools(server2) {
+  tool(
+    server2,
+    "get_stock_info",
+    {
+      description: "Get Kiwoom stock fundamentals + current price for a Korean stock (name, price, change, PER/EPS/ROE/PBR/BPS, OHLC, limits). ka10001.",
+      inputSchema: { code: import_zod.z.string().describe("6-digit stock code, e.g. 005930 (\uC0BC\uC131\uC804\uC790)") }
+    },
+    async ({ code }) => withErrorHandling(async () => {
+      const client = clientOrThrow();
+      const { data } = await client.callEndpoint(ENDPOINTS.stockInfo, {
+        stk_cd: normalizeStockCode(code)
+      });
+      return mcpJson(data);
+    })
+  );
+  tool(
+    server2,
+    "get_price",
+    {
+      description: "Get a rich current-price snapshot incl. top-of-book for a stock. ka10007.",
+      inputSchema: { code: import_zod.z.string().describe("6-digit stock code") }
+    },
+    async ({ code }) => withErrorHandling(async () => {
+      const client = clientOrThrow();
+      const { data } = await client.callEndpoint(ENDPOINTS.priceTableInfo, {
+        stk_cd: normalizeStockCode(code)
+      });
+      return mcpJson(data);
+    })
+  );
+  tool(
+    server2,
+    "get_orderbook",
+    {
+      description: "Get the 10-level bid/ask order book for a stock, parsed into ordered levels. ka10004.",
+      inputSchema: { code: import_zod.z.string().describe("6-digit stock code") }
+    },
+    async ({ code }) => withErrorHandling(async () => {
+      const client = clientOrThrow();
+      const stk = normalizeStockCode(code);
+      const { data } = await client.callEndpoint(ENDPOINTS.orderbook, { stk_cd: stk });
+      return mcpJson({ code: stk, ...parseOrderbook(data) });
+    })
+  );
+  tool(
+    server2,
+    "get_daily_price",
+    {
+      description: "Get daily price history ending at a base date. ka10086.",
+      inputSchema: {
+        code: import_zod.z.string().describe("6-digit stock code"),
+        date: import_zod.z.string().optional().describe("Base date YYYYMMDD (default today)")
+      }
+    },
+    async ({ code, date }) => withErrorHandling(async () => {
+      const client = clientOrThrow();
+      const { data } = await client.callEndpoint(ENDPOINTS.dailyPrice, {
+        stk_cd: normalizeStockCode(code),
+        qry_dt: date ?? todayKst(),
+        indc_tp: "0"
+      });
+      return mcpJson(data);
+    })
+  );
+  tool(
+    server2,
+    "get_recent_trades",
+    {
+      description: "Get recent tick-by-tick executions for a stock. ka10003.",
+      inputSchema: { code: import_zod.z.string().describe("6-digit stock code") }
+    },
+    async ({ code }) => withErrorHandling(async () => {
+      const client = clientOrThrow();
+      const { data } = await client.callEndpoint(ENDPOINTS.stockTrades, {
+        stk_cd: normalizeStockCode(code)
+      });
+      return mcpJson(data);
+    })
+  );
+  tool(
+    server2,
+    "search_stocks",
+    {
+      description: "Search the master stock list by name keyword or code prefix. Returns matching code/name/market. ka10099.",
+      inputSchema: {
+        keyword: import_zod.z.string().describe("Name substring or code prefix to match"),
+        market: import_zod.z.enum(["0", "10"]).optional().describe("0=KOSPI (default), 10=KOSDAQ"),
+        limit: import_zod.z.number().min(1).max(200).optional().describe("Max rows (default 30)")
+      }
+    },
+    async ({ keyword, market, limit }) => withErrorHandling(async () => {
+      const client = clientOrThrow();
+      const { data } = await client.callEndpoint(
+        ENDPOINTS.stockList,
+        { mrkt_tp: market ?? "0" },
+        { paginate: true }
+      );
+      const rows = Array.isArray(data.list) ? data.list : [];
+      const kw = keyword.toLowerCase();
+      const matches = rows.filter(
+        (r) => String(r.name ?? "").toLowerCase().includes(kw) || String(r.code ?? "").startsWith(keyword)
+      ).slice(0, limit ?? 30).map((r) => ({ code: r.code, name: r.name, market: r.marketName, sector: r.upName }));
+      return mcpJson(matches);
+    })
+  );
+}
+
+// src/mcp/tools/chart.ts
+var import_zod2 = require("zod");
+var PERIOD_EP = {
+  day: ENDPOINTS.dailyChart,
+  week: ENDPOINTS.weeklyChart,
+  month: ENDPOINTS.monthlyChart,
+  year: ENDPOINTS.yearlyChart
+};
+function registerChartTools(server2) {
+  tool(
+    server2,
+    "get_chart",
+    {
+      description: "Get OHLC chart data for a stock. Period charts (day/week/month/year) end at base date; tick/minute use an aggregation scope. Returns latest-first; use count to cap rows.",
+      inputSchema: {
+        code: import_zod2.z.string().describe("6-digit stock code"),
+        timeframe: import_zod2.z.enum(["tick", "minute", "day", "week", "month", "year"]).describe("Chart timeframe"),
+        scope: import_zod2.z.string().optional().describe("Tick units (1/3/5/10/30) or minute interval (1/3/5/10/15/30/45/60); default 1"),
+        date: import_zod2.z.string().optional().describe("Base date YYYYMMDD for period charts (default today)"),
+        adjusted: import_zod2.z.boolean().optional().describe("Adjust for splits/rights (default true)"),
+        count: import_zod2.z.number().min(1).max(900).optional().describe("Max rows to return (default 50)")
+      }
+    },
+    async ({ code, timeframe, scope, date, adjusted, count }) => withErrorHandling(async () => {
+      const client = clientOrThrow();
+      const stk = normalizeStockCode(code);
+      const upd = adjusted === false ? "0" : "1";
+      let def;
+      let body;
+      if (timeframe === "tick") {
+        def = ENDPOINTS.tickChart;
+        body = { stk_cd: stk, tic_scope: scope ?? "1", upd_stkpc_tp: upd };
+      } else if (timeframe === "minute") {
+        def = ENDPOINTS.minuteChart;
+        body = { stk_cd: stk, tic_scope: scope ?? "1", upd_stkpc_tp: upd };
+      } else {
+        def = PERIOD_EP[timeframe];
+        body = { stk_cd: stk, base_dt: date ?? todayKst(), upd_stkpc_tp: upd };
+      }
+      const { data } = await client.callEndpoint(def, body);
+      const rows = Array.isArray(data[def.listKey]) ? data[def.listKey] : [];
+      return mcpJson({
+        code: stk,
+        timeframe,
+        rows: rows.slice(0, count ?? 50)
+      });
+    })
+  );
+}
+
+// src/mcp/tools/account.ts
+var import_zod3 = require("zod");
+function registerAccountTools(server2) {
+  tool(
+    server2,
+    "get_balance",
+    {
+      description: "Get account evaluation balance: totals (purchase/eval/PnL/profit-rate) and per-holding detail. kt00018.",
+      inputSchema: {
+        exchange: import_zod3.z.enum(["KRX", "NXT", "%"]).optional().describe("Exchange filter (default KRX)")
+      }
+    },
+    async ({ exchange }) => withErrorHandling(async () => {
+      const client = clientOrThrow();
+      const { data } = await client.callEndpoint(ENDPOINTS.balance, {
+        qry_tp: "1",
+        dmst_stex_tp: exchange ?? "KRX"
+      });
+      return mcpJson(data);
+    })
+  );
+  tool(
+    server2,
+    "get_deposit",
+    {
+      description: "Get cash deposit detail: cash, orderable/withdrawable, D+2 settlement. kt00001."
+    },
+    async () => withErrorHandling(async () => {
+      const client = clientOrThrow();
+      const { data } = await client.callEndpoint(ENDPOINTS.deposit, { qry_tp: "3" });
+      return mcpJson(data);
+    })
+  );
+  tool(
+    server2,
+    "get_open_orders",
+    {
+      description: "Get open / unfilled orders (optionally for one stock). ka10075.",
+      inputSchema: { code: import_zod3.z.string().optional().describe("6-digit stock code to filter") }
+    },
+    async ({ code }) => withErrorHandling(async () => {
+      const client = clientOrThrow();
+      const body = code ? { all_stk_tp: "0", trde_tp: "0", stk_cd: normalizeStockCode(code), stex_tp: "0" } : { all_stk_tp: "1", trde_tp: "0", stk_cd: "", stex_tp: "0" };
+      const { data } = await client.callEndpoint(ENDPOINTS.openOrders, body);
+      return mcpJson(data);
+    })
+  );
+  tool(
+    server2,
+    "get_executions",
+    {
+      description: "Get filled executions (optionally for one stock). ka10076.",
+      inputSchema: { code: import_zod3.z.string().optional().describe("6-digit stock code to filter") }
+    },
+    async ({ code }) => withErrorHandling(async () => {
+      const client = clientOrThrow();
+      const { data } = await client.callEndpoint(ENDPOINTS.executions, {
+        stk_cd: code ? normalizeStockCode(code) : "",
+        qry_tp: code ? "1" : "0",
+        sell_tp: "0",
+        ord_no: "",
+        stex_tp: "0"
+      });
+      return mcpJson(data);
+    })
+  );
+  tool(
+    server2,
+    "get_realized_pnl",
+    {
+      description: "Get realized profit/loss for a stock over a date (or period, max 3 months). ka10072 / ka10073.",
+      inputSchema: {
+        code: import_zod3.z.string().describe("6-digit stock code"),
+        start: import_zod3.z.string().optional().describe("Start date YYYYMMDD (default today)"),
+        end: import_zod3.z.string().optional().describe("End date YYYYMMDD; if set, queries the period")
+      }
+    },
+    async ({ code, start, end }) => withErrorHandling(async () => {
+      const client = clientOrThrow();
+      const stk = normalizeStockCode(code);
+      const { data } = end ? await client.callEndpoint(ENDPOINTS.realizedPlByPeriod, {
+        stk_cd: stk,
+        strt_dt: start ?? end,
+        end_dt: end
+      }) : await client.callEndpoint(ENDPOINTS.realizedPlByDate, {
+        stk_cd: stk,
+        strt_dt: start ?? todayKst()
+      });
+      return mcpJson(data);
+    })
+  );
+}
+
+// src/mcp/tools/order.ts
+var import_zod4 = require("zod");
+function resolveType(type, price) {
+  const trde_tp = type ?? (price ? "0" : "3");
+  if (!ORDER_TYPES[trde_tp]) {
+    throw new Error(`Invalid order type ${trde_tp}. Known: ${Object.keys(ORDER_TYPES).join(", ")}`);
+  }
+  if (MARKET_ORDER_TYPES.has(trde_tp)) {
+    if (price) throw new Error("Market orders must not include a price.");
+    return { trde_tp, ord_uv: "" };
+  }
+  if (!price) throw new Error(`Order type ${trde_tp} requires a price.`);
+  return { trde_tp, ord_uv: price };
+}
+function registerOrderTools(server2) {
+  tool(
+    server2,
+    "place_order",
+    {
+      description: 'Place a buy or sell order. SAFETY: nothing is sent unless confirm=true; otherwise a preview is returned. On the "real" environment this trades REAL money. kt10000/kt10001 (or credit kt10006/kt10007).',
+      inputSchema: {
+        side: import_zod4.z.enum(["buy", "sell"]).describe("buy or sell"),
+        code: import_zod4.z.string().describe("6-digit stock code"),
+        qty: import_zod4.z.string().describe("Order quantity"),
+        price: import_zod4.z.string().optional().describe("Limit price (won); omit for a market order"),
+        type: import_zod4.z.string().optional().describe("Order type code trde_tp (default 0=limit / 3=market)"),
+        condPrice: import_zod4.z.string().optional().describe("Trigger price for stop/conditional types (e.g. 28)"),
+        exchange: import_zod4.z.enum(["KRX", "NXT", "SOR"]).optional().describe("Exchange routing (default KRX)"),
+        credit: import_zod4.z.boolean().optional().describe("Use a credit (margin) order"),
+        creditDeal: import_zod4.z.enum(["33", "99"]).optional().describe("Credit deal type (sell): 33=\uC735\uC790, 99=\uC735\uC790\uD569"),
+        loanDate: import_zod4.z.string().optional().describe("Credit loan date YYYYMMDD (some credit sells)"),
+        confirm: import_zod4.z.boolean().optional().describe("Must be true to actually submit")
+      }
+    },
+    async ({ side, code, qty, price, type, condPrice, exchange, credit, creditDeal, loanDate, confirm }) => withErrorHandling(async () => {
+      const stk = normalizeStockCode(code);
+      const { trde_tp, ord_uv } = resolveType(type, price);
+      if (trde_tp === "28" && !condPrice) {
+        throw new Error("Stop-limit orders (type 28) require condPrice.");
+      }
+      const ex = exchange ?? "KRX";
+      if (!ORDER_EXCHANGE_TYPES.includes(ex)) throw new Error(`Invalid exchange ${ex}`);
+      const def = credit ? side === "buy" ? ENDPOINTS.creditBuy : ENDPOINTS.creditSell : side === "buy" ? ENDPOINTS.buy : ENDPOINTS.sell;
+      const body = {
+        dmst_stex_tp: ex,
+        stk_cd: stk,
+        ord_qty: qty,
+        ord_uv,
+        trde_tp,
+        cond_uv: condPrice ?? ""
+      };
+      if (credit && side === "sell") {
+        body.crd_deal_tp = creditDeal ?? "33";
+        if (loanDate) body.crd_loan_dt = loanDate;
+      }
+      const preview = {
+        willSubmit: confirm === true,
+        env: currentEnv(),
+        apiId: def.apiId,
+        side,
+        credit: Boolean(credit),
+        stock: stk,
+        qty,
+        price: MARKET_ORDER_TYPES.has(trde_tp) ? "MARKET" : ord_uv,
+        orderType: `${trde_tp} (${ORDER_TYPES[trde_tp]})`,
+        exchange: ex
+      };
+      if (confirm !== true) {
+        return mcpText(
+          `PREVIEW ONLY \u2014 set confirm=true to submit.
+${JSON.stringify(preview, null, 2)}`
+        );
+      }
+      const { data } = await clientOrThrow().callEndpoint(def, body);
+      return mcpJson({ submitted: true, ...preview, result: data });
+    })
+  );
+  tool(
+    server2,
+    "modify_order",
+    {
+      description: "Modify a resting order (new qty/price). Nothing is sent unless confirm=true. kt10002/kt10008.",
+      inputSchema: {
+        orderNo: import_zod4.z.string().describe("Original order number"),
+        code: import_zod4.z.string().describe("6-digit stock code"),
+        qty: import_zod4.z.string().describe("New quantity"),
+        price: import_zod4.z.string().describe("New price"),
+        condPrice: import_zod4.z.string().optional().describe("New trigger price for conditional/stop orders"),
+        exchange: import_zod4.z.enum(["KRX", "NXT", "SOR"]).optional().describe("Exchange (default KRX)"),
+        credit: import_zod4.z.boolean().optional(),
+        confirm: import_zod4.z.boolean().optional().describe("Must be true to actually submit")
+      }
+    },
+    async ({ orderNo, code, qty, price, condPrice, exchange, credit, confirm }) => withErrorHandling(async () => {
+      const stk = normalizeStockCode(code);
+      const ex = exchange ?? "KRX";
+      const def = credit ? ENDPOINTS.creditModify : ENDPOINTS.modify;
+      const body = {
+        dmst_stex_tp: ex,
+        orig_ord_no: orderNo,
+        stk_cd: stk,
+        mdfy_qty: qty,
+        mdfy_uv: price,
+        mdfy_cond_uv: condPrice ?? ""
+      };
+      const preview = { willSubmit: confirm === true, env: currentEnv(), apiId: def.apiId, orderNo, stock: stk, qty, price, exchange: ex };
+      if (confirm !== true) {
+        return mcpText(`PREVIEW ONLY \u2014 set confirm=true to submit.
+${JSON.stringify(preview, null, 2)}`);
+      }
+      const { data } = await clientOrThrow().callEndpoint(def, body);
+      return mcpJson({ submitted: true, ...preview, result: data });
+    })
+  );
+  tool(
+    server2,
+    "cancel_order",
+    {
+      description: "Cancel a resting order (qty 0 = all). Nothing is sent unless confirm=true. kt10003/kt10009.",
+      inputSchema: {
+        orderNo: import_zod4.z.string().describe("Original order number"),
+        code: import_zod4.z.string().describe("6-digit stock code"),
+        qty: import_zod4.z.string().optional().describe("Quantity to cancel; 0 = all remaining (default 0)"),
+        exchange: import_zod4.z.enum(["KRX", "NXT", "SOR"]).optional().describe("Exchange (default KRX)"),
+        credit: import_zod4.z.boolean().optional(),
+        confirm: import_zod4.z.boolean().optional().describe("Must be true to actually submit")
+      }
+    },
+    async ({ orderNo, code, qty, exchange, credit, confirm }) => withErrorHandling(async () => {
+      const stk = normalizeStockCode(code);
+      const ex = exchange ?? "KRX";
+      const def = credit ? ENDPOINTS.creditCancel : ENDPOINTS.cancel;
+      const body = { dmst_stex_tp: ex, orig_ord_no: orderNo, stk_cd: stk, cncl_qty: qty ?? "0" };
+      const preview = { willSubmit: confirm === true, env: currentEnv(), apiId: def.apiId, orderNo, stock: stk, qty: qty ?? "0 (all)", exchange: ex };
+      if (confirm !== true) {
+        return mcpText(`PREVIEW ONLY \u2014 set confirm=true to submit.
+${JSON.stringify(preview, null, 2)}`);
+      }
+      const { data } = await clientOrThrow().callEndpoint(def, body);
+      return mcpJson({ submitted: true, ...preview, result: data });
+    })
+  );
+}
+
+// src/mcp/tools/ranking.ts
+var import_zod5 = require("zod");
+function registerRankingTools(server2) {
+  tool(
+    server2,
+    "get_ranking",
+    {
+      description: "Get a market ranking list: gainers/losers (fluctuation), today volume, trade value (amount), volume surge, or previous-day volume.",
+      inputSchema: {
+        kind: import_zod5.z.enum(["fluctuation", "volume", "amount", "surge", "prev-volume"]).describe("Ranking type"),
+        market: import_zod5.z.enum(["000", "001", "101"]).optional().describe("000=all, 001=KOSPI, 101=KOSDAQ"),
+        sort: import_zod5.z.string().optional().describe("Sort code (meaning varies per kind; default 1)"),
+        exchange: import_zod5.z.enum(["1", "2", "3"]).optional().describe("1=KRX, 2=NXT, 3=unified (default 3)")
+      }
+    },
+    async ({ kind, market, sort, exchange }) => withErrorHandling(async () => {
+      const mrkt_tp = market ?? "000";
+      const stex_tp = exchange ?? "3";
+      let def;
+      let body;
+      switch (kind) {
+        case "fluctuation":
+          def = ENDPOINTS.rankFluctuation;
+          body = {
+            mrkt_tp,
+            sort_tp: sort ?? "1",
+            trde_qty_cnd: "0000",
+            stk_cnd: "0",
+            crd_cnd: "0",
+            updown_incls: "1",
+            pric_cnd: "0",
+            trde_prica_cnd: "0",
+            stex_tp
+          };
+          break;
+        case "volume":
+          def = ENDPOINTS.rankVolume;
+          body = {
+            mrkt_tp,
+            sort_tp: sort ?? "1",
+            mang_stk_incls: "0",
+            crd_tp: "0",
+            trde_qty_tp: "0",
+            pric_tp: "0",
+            trde_prica_tp: "0",
+            mrkt_open_tp: "0",
+            stex_tp
+          };
+          break;
+        case "amount":
+          def = ENDPOINTS.rankTradeAmount;
+          body = { mrkt_tp, mang_stk_incls: "1", stex_tp };
+          break;
+        case "surge":
+          def = ENDPOINTS.rankVolumeSurge;
+          body = {
+            mrkt_tp,
+            sort_tp: sort ?? "1",
+            tm_tp: "2",
+            trde_qty_tp: "5",
+            tm: "",
+            stk_cnd: "0",
+            pric_tp: "0",
+            stex_tp
+          };
+          break;
+        default:
+          def = ENDPOINTS.rankPrevVolume;
+          body = { mrkt_tp, qry_tp: "1", rank_strt: "0", rank_end: "100", stex_tp };
+      }
+      const { data } = await clientOrThrow().callEndpoint(def, body);
+      return mcpJson(data);
+    })
+  );
+  tool(
+    server2,
+    "get_sector",
+    {
+      description: "Get sector/industry data: index price, constituent stock prices, all sector indices, or daily index history.",
+      inputSchema: {
+        kind: import_zod5.z.enum(["price", "stocks", "all", "daily"]).describe("Sector query type"),
+        market: import_zod5.z.enum(["0", "1", "2"]).optional().describe("0=KOSPI, 1=KOSDAQ, 2=KOSPI200"),
+        code: import_zod5.z.string().optional().describe("Industry code inds_cd (default 001=\uC885\uD569KOSPI)")
+      }
+    },
+    async ({ kind, market, code }) => withErrorHandling(async () => {
+      const mrkt_tp = market ?? "0";
+      const inds_cd = code ?? "001";
+      let def;
+      let body;
+      switch (kind) {
+        case "stocks":
+          def = ENDPOINTS.sectorStocks;
+          body = { mrkt_tp, inds_cd, stex_tp: "1" };
+          break;
+        case "all":
+          def = ENDPOINTS.sectorAllIndex;
+          body = { inds_cd };
+          break;
+        case "daily":
+          def = ENDPOINTS.sectorDaily;
+          body = { mrkt_tp, inds_cd };
+          break;
+        default:
+          def = ENDPOINTS.sectorPrice;
+          body = { mrkt_tp, inds_cd };
+      }
+      const { data } = await clientOrThrow().callEndpoint(def, body);
+      return mcpJson(data);
+    })
+  );
+}
+
+// src/mcp.ts
+var server = new import_mcp.McpServer({
+  name: "kiwoom-mcp",
+  version: "0.1.0"
+});
+registerMarketTools(server);
+registerChartTools(server);
+registerAccountTools(server);
+registerOrderTools(server);
+registerRankingTools(server);
+var transport = new import_stdio.StdioServerTransport();
+server.connect(transport).catch((err) => {
+  console.error("MCP server error:", err);
+  process.exit(1);
+});
+//# sourceMappingURL=mcp.js.map