@portone/mcp-server 0.16.0 → 0.17.1

package/server/index.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 var __defProp = Object.defineProperty;
 var __export = (target, all) => {
-  for (var name14 in all)
-    __defProp(target, name14, { get: all[name14], enumerable: true });
+  for (var name17 in all)
+    __defProp(target, name17, { get: all[name17], enumerable: true });
 };
 
 // src/index.ts
@@ -15,7 +15,7 @@ import { GraphQLClient } from "graphql-request";
 // package.json
 var package_default = {
   name: "@portone/mcp-server",
-  version: "0.16.0",
+  version: "0.17.1",
   description: "\uD3EC\uD2B8\uC6D0 \uC0AC\uC6A9\uC790\uB97C \uC704\uD55C MCP (Model Context Protocol) \uC11C\uBC84\uC785\uB2C8\uB2E4. \uD3EC\uD2B8\uC6D0 \uAC1C\uBC1C\uC790\uC13C\uD130, \uD5EC\uD504\uC13C\uD130 \uB4F1 \uACF5\uC2DD \uBB38\uC11C \uB0B4\uC6A9\uC744 LLM(Large Language Model)\uC5D0 \uC81C\uACF5\uD574 \uC815\uD655\uD55C \uC815\uBCF4\uB97C \uBC14\uD0D5\uC73C\uB85C \uC0AC\uC6A9\uC790\uC758 \uC5F0\uB3D9 \uBC0F \uC9C8\uC758\uB97C \uB3D5\uB3C4\uB85D \uD569\uB2C8\uB2E4.",
   main: "server/index.js",
   type: "module",
@@ -671,6 +671,9 @@ var TokenProvider = class {
           "CHANNEL_UPDATE",
           "STORE_READ",
           "MERCHANT_READ"
+          // 거래대사(getReconciliationsByFilter / getSettlementSummaries /
+          // getSettlementStatistics) 조회는 위 기존 스코프로 게이트웨이 접근이
+          // 가능함을 실환경에서 확인했습니다. 별도 스코프는 필요하지 않습니다.
         ].join(" ")
       );
       url.searchParams.set("code_challenge", codeChallenge);
@@ -1745,15 +1748,1122 @@ function init4(tokenProvider, client) {
   };
 }
 
-// src/tools/listDocs.ts
-var listDocs_exports = {};
-__export(listDocs_exports, {
+// src/tools/getReconciliationsByFilter.ts
+var getReconciliationsByFilter_exports = {};
+__export(getReconciliationsByFilter_exports, {
   config: () => config5,
   init: () => init5,
   name: () => name5
 });
+import { match as match8 } from "ts-pattern";
+import z12 from "zod";
+
+// src/tools/request/getReconciliations.ts
+import { parse as parse3 } from "graphql";
+import { gql as gql3 } from "graphql-request";
+import { match as match7, P as P6 } from "ts-pattern";
 import z11 from "zod";
 
+// src/tools/utils/requestError.ts
+function toRequestError(error) {
+  const response = error?.response;
+  const rawErrors = response?.errors;
+  if (Array.isArray(rawErrors) && rawErrors.length > 0) {
+    const errors = rawErrors.map((entry) => {
+      const e = entry;
+      const message2 = typeof e.message === "string" && e.message.length > 0 ? e.message : void 0;
+      const code = e.extensions?.code != null ? String(e.extensions.code) : void 0;
+      const path = Array.isArray(e.path) ? e.path.join(".") : void 0;
+      return { message: message2, code, path };
+    });
+    const primary = errors[0];
+    const message = primary.message ?? (primary.code != null ? `GraphQL \uC624\uB958 (code: ${primary.code})` : "GraphQL \uC624\uB958\uAC00 \uBC1C\uC0DD\uD588\uC2B5\uB2C8\uB2E4. (\uC11C\uBC84\uAC00 \uC0C1\uC138 \uBA54\uC2DC\uC9C0\uB97C \uBC18\uD658\uD558\uC9C0 \uC54A\uC74C)");
+    return {
+      type: "error",
+      data: { message, type: "GraphQLError", errors }
+    };
+  }
+  if (error instanceof Error) {
+    return {
+      type: "error",
+      data: {
+        message: error.message || error.name || "\uC624\uB958\uAC00 \uBC1C\uC0DD\uD588\uC2B5\uB2C8\uB2E4.",
+        type: error.name
+      }
+    };
+  }
+  return {
+    type: "error",
+    data: { message: "\uC54C \uC218 \uC5C6\uB294 \uC624\uB958\uAC00 \uBC1C\uC0DD\uD588\uC2B5\uB2C8\uB2E4.", cause: String(error) }
+  };
+}
+
+// src/tools/request/getReconciliations.ts
+var ErrorResponse3 = z11.object({
+  __typename: z11.string(),
+  message: z11.string().nullable()
+});
+var ReconciliationStatus = z11.enum([
+  "MATCHED",
+  "NOT_MATCHED",
+  "INCOMPARABLE",
+  "NOT_COLLECTED"
+]);
+var ReconciliationActionType = z11.enum([
+  "APPROVAL",
+  "FULL_CANCEL",
+  "PARTIAL_CANCEL",
+  "UNCLASSIFIED_CANCEL",
+  "POST_CORRECTION"
+]);
+var ReconciliationPaymentMethodType = z11.enum([
+  "CARD",
+  "CHARGE",
+  "TRANSFER",
+  "ARS",
+  "GIFT_CERTIFICATE",
+  "MOBILE",
+  "VIRTUAL_ACCOUNT",
+  "ETC",
+  "EASY_PAY_ETC",
+  "EASY_PAY_PAYCO",
+  "EASY_PAY_SAMSUNGPAY",
+  "EASY_PAY_SSGPAY",
+  "EASY_PAY_KAKAOPAY",
+  "EASY_PAY_NAVERPAY",
+  "EASY_PAY_CHAI",
+  "EASY_PAY_LPAY",
+  "EASY_PAY_KPAY",
+  "EASY_PAY_TOSSPAY",
+  "EASY_PAY_LGPAY",
+  "EASY_PAY_APPLEPAY",
+  "EASY_PAY_PINPAY",
+  "EASY_PAY_SKPAY",
+  "EASY_PAY_WECHATPAY",
+  "EASY_PAY_PAYPAL",
+  "EASY_PAY_ALIPAY",
+  "EASY_PAY_TOSS_BRANDPAY",
+  "EASY_PAY_KB_APP",
+  "EASY_PAY_TMONEYPAY",
+  "EASY_PAY_HYPHEN",
+  "EASY_PAY_OK_CASHBAG",
+  "EASY_PAY_BENEPIA"
+]);
+var ReconciliationNotMatchedReason = z11.enum([
+  "PAYMENT_AMOUNT_NOT_MATCHED",
+  "TAX_FREE_AMOUNT_NOT_MATCHED",
+  "VAT_AMOUNT_NOT_MATCHED",
+  "ESCROW_NOT_MATCHED",
+  "INSTALLMENT_MONTH_NOT_MATCHED",
+  "PAYMENT_DATE_NOT_MATCHED"
+]);
+var ReconciliationIncomparableReason = z11.enum([
+  "NO_MATCHING_PORTONE_TRANSACTION",
+  "CHANNEL_MISMATCH",
+  "RECONCILIATION_SKIPPED",
+  "PG_COLLECTION_FAILED",
+  "PG_DATA_MISSING",
+  "UNKNOWN"
+]);
+var ReconciliationPgProvider = z11.enum([
+  "KAKAOPAY",
+  "NICEPAY",
+  "NAVERPAY",
+  "UPLUS",
+  "TOSSPAYMENTS",
+  "TOSSPAY",
+  "PAYCO",
+  "KCP",
+  "DANAL",
+  "EXIMBAY",
+  "INICIS",
+  "HECTO",
+  "KSNET",
+  "KPN",
+  "HYPHEN"
+]);
+var SortOrder = z11.enum(["DESC", "ASC"]);
+var Settlement = z11.object(
+  nullableObject({
+    feeAmount: z11.number(),
+    feeVatAmount: z11.number(),
+    settlementAmount: z11.number(),
+    settlementCurrency: z11.string(),
+    settlementDate: z11.string()
+  })
+);
+var PaymentMethod = z11.object({
+  __typename: z11.string(),
+  paymentMethodType: z11.string().nullable().optional(),
+  installmentMonth: z11.number().nullable().optional(),
+  name: z11.string().nullable().optional()
+}).partial();
+var PgSpecifier = z11.object(
+  nullableObject({
+    pgMerchantId: z11.string(),
+    pgProvider: z11.string()
+  })
+);
+var ReconciliationNode = z11.object({
+  __typename: z11.string(),
+  plainId: z11.string(),
+  actionType: z11.string(),
+  pgSpecifier: PgSpecifier.nullable(),
+  merchantPlainId: z11.string(),
+  paymentAmount: z11.number(),
+  taxFreeAmount: z11.number(),
+  vatAmount: z11.number(),
+  supplyAmount: z11.number(),
+  anomalyAmount: z11.number().nullable().optional(),
+  paidAt: z11.string(),
+  isEscrow: z11.boolean().nullable(),
+  paymentCurrency: z11.string(),
+  paymentMethod: PaymentMethod.nullable(),
+  settlement: Settlement.nullable(),
+  // 상태별 구체 필드 (필수형 / optional 형이 타입마다 다름)
+  pgTxId: z11.string().nullable().optional(),
+  pgTxIdOptional: z11.string().nullable().optional(),
+  transactionPlainId: z11.string().nullable().optional(),
+  transactionPlainIdOptional: z11.string().nullable().optional(),
+  paymentPlainId: z11.string().nullable().optional(),
+  paymentPlainIdOptional: z11.string().nullable().optional(),
+  orderName: z11.string().nullable().optional(),
+  orderNameOptional: z11.string().nullable().optional(),
+  storePlainId: z11.string().nullable().optional(),
+  storePlainIdOptional: z11.string().nullable().optional(),
+  notMatchedReasons: z11.array(z11.string()).nullable().optional(),
+  // INCOMPARABLE(대사 불가) 사유. 게이트웨이는 내부의 backward_incomparable
+  // 상태/사유를 INCOMPARABLE + 이 단일 reason 으로 병합해 노출합니다.
+  // enum 드리프트 방지를 위해 문자열로 수용합니다.
+  reason: z11.string().nullable().optional()
+}).partial({
+  pgSpecifier: true,
+  isEscrow: true,
+  paymentMethod: true,
+  settlement: true
+});
+var CursorPageInfo = z11.object({
+  startCursor: z11.string(),
+  endCursor: z11.string(),
+  hasPreviousPage: z11.boolean(),
+  hasNextPage: z11.boolean()
+});
+var ReconciliationsPayload = z11.object({
+  edges: z11.array(z11.object({ node: ReconciliationNode, cursor: z11.string() })),
+  pageInfo: CursorPageInfo
+});
+var GetReconciliationsResponse = z11.object({
+  merchant: z11.object({
+    reconciliation: z11.object({
+      paymentReconciliations: ReconciliationsPayload
+    })
+  }).or(ErrorResponse3)
+}).transform(({ merchant }) => {
+  if ("__typename" in merchant) return merchant;
+  return merchant.reconciliation.paymentReconciliations;
+});
+var getReconciliationsQuery = parse3(gql3`
+query GetReconciliations(
+  $dateCondition: ReconciliationDateConditionInput!
+  $searchCondition: PaymentReconciliationSearchConditionInput
+  $filter: PaymentReconciliationFilterInput
+  $order: PaymentReconciliationOrderInput
+  $first: Int!
+  $after: String
+) {
+  merchant {
+    ...ErrorFragment
+    ... on Merchant {
+      reconciliation {
+        paymentReconciliations(
+          dateCondition: $dateCondition
+          searchCondition: $searchCondition
+          filter: $filter
+          order: $order
+          first: $first
+          after: $after
+        ) {
+          edges {
+            cursor
+            node {
+              __typename
+              plainId
+              actionType
+              pgSpecifier {
+                pgMerchantId
+                pgProvider
+              }
+              merchantPlainId
+              paymentAmount
+              taxFreeAmount
+              vatAmount
+              supplyAmount
+              paidAt
+              isEscrow
+              paymentCurrency
+              paymentMethod {
+                __typename
+                ... on ReconciliationPaymentMethodCard {
+                  installmentMonth
+                }
+                ... on ReconciliationPaymentMethodEasyPay {
+                  paymentMethodType
+                }
+                ... on ReconciliationPaymentMethodEtc {
+                  name
+                }
+              }
+              settlement {
+                feeAmount
+                feeVatAmount
+                settlementAmount
+                settlementCurrency
+                settlementDate
+              }
+              ... on PaymentReconciliationMatched {
+                pgTxId
+                transactionPlainId
+                paymentPlainId
+                orderName
+                storePlainId
+              }
+              ... on PaymentReconciliationNotMatched {
+                pgTxId
+                anomalyAmount
+                transactionPlainId
+                paymentPlainId
+                orderName
+                storePlainId
+                notMatchedReasons
+              }
+              ... on PaymentReconciliationIncomparable {
+                pgTxId
+                anomalyAmount
+                reason
+                paymentPlainIdOptional
+                orderNameOptional
+              }
+              ... on PaymentReconciliationNotCollected {
+                pgTxIdOptional
+                anomalyAmount
+                transactionPlainIdOptional
+                paymentPlainIdOptional
+                orderNameOptional
+                storePlainIdOptional
+              }
+              ... on PaymentReconciliationPostCorrection {
+                pgTxIdOptional
+                anomalyAmount
+                transactionPlainIdOptional
+                paymentPlainIdOptional
+                orderNameOptional
+                storePlainIdOptional
+              }
+            }
+          }
+          pageInfo {
+            startCursor
+            endCursor
+            hasPreviousPage
+            hasNextPage
+          }
+        }
+      }
+    }
+  }
+}
+
+fragment ErrorFragment on Error {
+  __typename
+  message
+}
+`);
+var ReconciliationFilter = z11.object({
+  storeIds: z11.array(z11.string()),
+  channelKeys: z11.array(z11.string()),
+  pgSpecifiers: z11.array(
+    z11.object({
+      pgMerchantId: z11.string(),
+      pgProvider: ReconciliationPgProvider
+    })
+  ),
+  paymentMethodTypes: z11.array(ReconciliationPaymentMethodType),
+  paymentReconciliationStatuses: z11.array(ReconciliationStatus),
+  actionTypes: z11.array(ReconciliationActionType),
+  transactionCurrencies: z11.array(z11.string()),
+  settlementCurrencies: z11.array(z11.string())
+}).partial();
+var ReconciliationSearchCondition = z11.object({
+  paymentPlainId: z11.string(),
+  transactionPlainId: z11.string(),
+  pgTxId: z11.string(),
+  orderName: z11.string()
+}).partial();
+var ReconciliationOrder = z11.object({
+  settlementDate: SortOrder,
+  transactionDate: SortOrder,
+  transactionAmount: SortOrder,
+  anomalyAmount: SortOrder,
+  settlementAmount: SortOrder
+}).partial();
+async function getReconciliations({
+  client,
+  authorization,
+  dateType,
+  from,
+  until,
+  filter,
+  searchCondition,
+  order,
+  first,
+  after
+}) {
+  const dateRange = { from, until };
+  const dateCondition = dateType === "SETTLEMENT" ? { settlementDateRange: dateRange } : { transactionDateRange: dateRange };
+  try {
+    const response = await client.request({
+      document: getReconciliationsQuery,
+      requestHeaders: {
+        authorization
+      },
+      variables: {
+        dateCondition,
+        searchCondition,
+        filter,
+        order,
+        first,
+        after
+      }
+    });
+    const parsed = await GetReconciliationsResponse.parseAsync(response);
+    return match7(parsed).returnType().with({ __typename: P6.nonNullable }, ({ __typename, message }) => ({
+      type: "error",
+      data: {
+        message,
+        type: __typename
+      }
+    })).otherwise((data) => ({
+      type: "success",
+      data
+    }));
+  } catch (error) {
+    return toRequestError(error);
+  }
+}
+
+// src/tools/utils/dateRange.ts
+var LOOKBACK_MONTHS = 6;
+function maxRangeLabel(maxRange) {
+  if ("months" in maxRange) {
+    return `${maxRange.months}\uAC1C\uC6D4`;
+  }
+  if (maxRange.days % 7 === 0) {
+    return `${maxRange.days / 7}\uC8FC`;
+  }
+  return `${maxRange.days}\uC77C`;
+}
+function validateReconciliationDateRange(from, to, maxRange) {
+  const fromDate = /* @__PURE__ */ new Date(`${from}T00:00:00Z`);
+  const toDate = /* @__PURE__ */ new Date(`${to}T00:00:00Z`);
+  if (Number.isNaN(fromDate.getTime()) || Number.isNaN(toDate.getTime())) {
+    return "\uB0A0\uC9DC \uD615\uC2DD\uC774 \uC62C\uBC14\uB974\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 (YYYY-MM-DD).";
+  }
+  if (toDate < fromDate) {
+    return "\uC870\uD68C \uC885\uB8CC\uC77C(to)\uC740 \uC2DC\uC791\uC77C(from)\uBCF4\uB2E4 \uBE60\uB97C \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.";
+  }
+  const now = /* @__PURE__ */ new Date();
+  const earliest = new Date(
+    Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate())
+  );
+  earliest.setUTCMonth(earliest.getUTCMonth() - LOOKBACK_MONTHS);
+  if (fromDate < earliest) {
+    return `\uC870\uD68C \uC2DC\uC791\uC77C(from)\uC740 \uCD5C\uADFC ${LOOKBACK_MONTHS}\uAC1C\uC6D4 \uC774\uB0B4\uC5EC\uC57C \uD569\uB2C8\uB2E4. ${earliest.toISOString().slice(0, 10)} \uC774\uD6C4\uB85C \uC9C0\uC815\uD574\uC8FC\uC138\uC694.`;
+  }
+  const maxTo = new Date(fromDate);
+  if ("months" in maxRange) {
+    maxTo.setUTCMonth(maxTo.getUTCMonth() + maxRange.months);
+  } else {
+    maxTo.setUTCDate(maxTo.getUTCDate() + maxRange.days);
+  }
+  if (toDate > maxTo) {
+    return `\uC870\uD68C \uAD6C\uAC04\uC740 \uCD5C\uB300 ${maxRangeLabel(maxRange)}\uAE4C\uC9C0 \uAC00\uB2A5\uD569\uB2C8\uB2E4. from(${from}) \uAE30\uC900 ${maxTo.toISOString().slice(0, 10)} \uC774\uB0B4\uB85C to\uB97C \uC9C0\uC815\uD574\uC8FC\uC138\uC694.`;
+  }
+  return null;
+}
+
+// src/tools/getReconciliationsByFilter.ts
+var name5 = "getReconciliationsByFilter";
+var DateString = z12.string().regex(/^\d{4}-\d{2}-\d{2}$/, "YYYY-MM-DD \uD615\uC2DD\uC758 \uB0A0\uC9DC\uC5EC\uC57C \uD569\uB2C8\uB2E4.");
+var Settlement2 = z12.object({
+  feeAmount: z12.number().describe("PG \uC218\uC218\uB8CC"),
+  feeVatAmount: z12.number().describe("PG \uC218\uC218\uB8CC \uBD80\uAC00\uC138"),
+  settlementAmount: z12.number().describe("\uC815\uC0B0 \uAE08\uC561"),
+  settlementCurrency: z12.string().describe("\uC815\uC0B0 \uD1B5\uD654"),
+  settlementDate: z12.string().describe("\uC815\uC0B0\uC77C")
+}).partial();
+var Reconciliation = z12.object({
+  id: z12.string().describe("\uAC70\uB798\uB300\uC0AC \uC544\uC774\uB514"),
+  status: z12.string().describe(
+    "\uB300\uC0AC \uC0C1\uD0DC (MATCHED/NOT_MATCHED/INCOMPARABLE/NOT_COLLECTED/POST_CORRECTION)"
+  ),
+  actionType: z12.string().describe("\uACB0\uC81C \uC0C1\uD0DC (\uC2B9\uC778/\uCDE8\uC18C/\uD6C4\uBCF4\uC815)"),
+  pgProvider: z12.string().describe("\uB300\uC0AC\uC6A9 PG\uC0AC"),
+  pgMerchantId: z12.string().describe("PG\uC0AC \uAC00\uB9F9\uC810 \uC2DD\uBCC4 \uC544\uC774\uB514"),
+  pgTxId: z12.string().describe("PG\uC0AC \uAC70\uB798 \uC544\uC774\uB514"),
+  paymentAmount: z12.number().describe("\uACB0\uC81C \uAE08\uC561"),
+  supplyAmount: z12.number().describe("\uACF5\uAE09\uAC00\uC561"),
+  vatAmount: z12.number().describe("\uBD80\uAC00\uC138"),
+  taxFreeAmount: z12.number().describe("\uBA74\uC138\uAC00\uC561"),
+  anomalyAmount: z12.number().describe("\uAC70\uB798\uC774\uC0C1 \uAE08\uC561"),
+  paidAt: z12.string().describe("\uACB0\uC81C\uC77C"),
+  paymentCurrency: z12.string().describe("\uACB0\uC81C \uD1B5\uD654"),
+  isEscrow: z12.boolean().describe("\uC5D0\uC2A4\uD06C\uB85C \uC5EC\uBD80"),
+  paymentMethodType: z12.string().describe("\uACB0\uC81C \uC218\uB2E8 \uC885\uB958(__typename \uAE30\uBC18)"),
+  transactionId: z12.string().describe("\uD3EC\uD2B8\uC6D0 \uACB0\uC81C \uC544\uC774\uB514"),
+  paymentId: z12.string().describe("\uACE0\uAC1D\uC0AC \uACB0\uC81C \uC544\uC774\uB514"),
+  orderName: z12.string().describe("\uC8FC\uBB38\uBA85"),
+  storeId: z12.string().describe("\uD558\uC704 \uC0C1\uC810 \uC544\uC774\uB514"),
+  notMatchedReasons: z12.array(z12.string()).describe("\uB300\uC0AC \uBD88\uC77C\uCE58 \uC0AC\uC720 \uBAA9\uB85D (NOT_MATCHED \uC778 \uACBD\uC6B0)"),
+  incomparableReason: z12.string().describe(
+    "\uB300\uC0AC \uBD88\uAC00 \uC0AC\uC720 (INCOMPARABLE \uC778 \uACBD\uC6B0). \uB0B4\uBD80 backward_incomparable \uC0AC\uC720(PG_COLLECTION_FAILED/PG_DATA_MISSING \uB4F1)\uB3C4 \uC774 \uAC12\uC73C\uB85C \uBCD1\uD569\uB418\uC5B4 \uC81C\uACF5\uB429\uB2C8\uB2E4."
+  ),
+  settlement: Settlement2.describe("\uC815\uC0B0 \uC815\uBCF4")
+}).partial();
+var OutputSchema5 = z12.object({
+  items: Reconciliation.array().describe("\uC870\uD68C\uB41C \uAC70\uB798\uB300\uC0AC \uBAA9\uB85D"),
+  hasNextPage: z12.boolean().describe("\uB2E4\uC74C \uD398\uC774\uC9C0 \uC874\uC7AC \uC5EC\uBD80"),
+  endCursor: z12.string().describe("\uB2E4\uC74C \uD398\uC774\uC9C0 \uC870\uD68C\uC5D0 \uC0AC\uC6A9\uD560 \uCEE4\uC11C (after \uB85C \uC804\uB2EC)")
+});
+var InputSchema4 = z12.object({
+  store: z12.string().optional().describe(
+    "\uC870\uD68C\uD560 \uD558\uC704 \uC0C1\uC810 \uC544\uC774\uB514. \uC0DD\uB7B5\uD558\uBA74 \uACE0\uAC1D\uC0AC \uB0B4 \uBAA8\uB4E0 \uD558\uC704 \uC0C1\uC810\uC744 \uC870\uD68C\uD569\uB2C8\uB2E4."
+  ),
+  dateType: z12.enum(["SETTLEMENT", "TRANSACTION"]).default("TRANSACTION").describe("from/to \uB85C \uC81C\uC57D\uD560 \uAE30\uC900 (\uC815\uC0B0\uC77C / \uACB0\uC81C\uC77C)"),
+  from: DateString.describe("\uC870\uD68C \uC2DC\uC791\uC77C (YYYY-MM-DD)"),
+  to: DateString.describe("\uC870\uD68C \uC885\uB8CC\uC77C (YYYY-MM-DD)"),
+  statuses: z12.array(ReconciliationStatus).optional().describe(
+    "\uD3EC\uD568\uD560 \uB300\uC0AC \uC0C1\uD0DC \uBAA9\uB85D. \uBD88\uC77C\uCE58 \uAC74\uB9CC \uBCF4\uB824\uBA74 [NOT_MATCHED] \uB85C \uC9C0\uC815\uD569\uB2C8\uB2E4."
+  ),
+  actionTypes: z12.array(ReconciliationActionType).optional().describe("\uD3EC\uD568\uD560 \uACB0\uC81C \uC0C1\uD0DC \uBAA9\uB85D"),
+  paymentMethodTypes: z12.array(ReconciliationPaymentMethodType).optional().describe("\uD3EC\uD568\uD560 \uACB0\uC81C \uC218\uB2E8 \uBAA9\uB85D"),
+  transactionCurrencies: z12.array(z12.string().length(3).toUpperCase()).optional().describe("\uD3EC\uD568\uD560 \uACB0\uC81C \uD1B5\uD654 \uBAA9\uB85D (\uC138 \uC790\uB9AC \uD1B5\uD654 \uCF54\uB4DC)"),
+  settlementCurrencies: z12.array(z12.string().length(3).toUpperCase()).optional().describe("\uD3EC\uD568\uD560 \uC815\uC0B0 \uD1B5\uD654 \uBAA9\uB85D (\uC138 \uC790\uB9AC \uD1B5\uD654 \uCF54\uB4DC)"),
+  paymentId: z12.string().optional().describe("\uACE0\uAC1D\uC0AC \uACB0\uC81C \uC544\uC774\uB514 \uAC80\uC0C9"),
+  transactionId: z12.string().optional().describe("\uD3EC\uD2B8\uC6D0 \uACB0\uC81C \uC544\uC774\uB514 \uAC80\uC0C9"),
+  pgTxId: z12.string().optional().describe("PG\uC0AC \uAC70\uB798 \uC544\uC774\uB514 \uAC80\uC0C9"),
+  orderName: z12.string().optional().describe("\uC8FC\uBB38\uBA85 \uAC80\uC0C9"),
+  first: z12.number().min(1).max(100).default(20).describe("\uC870\uD68C\uD560 \uAC74 \uC218 (\uCD5C\uB300 100)"),
+  after: z12.string().optional().describe("\uC774\uC804 \uD398\uC774\uC9C0\uC758 \uB9C8\uC9C0\uB9C9 \uCEE4\uC11C (endCursor \uAC12)")
+});
+var config5 = {
+  title: "\uAC70\uB798\uB300\uC0AC \uAC74\uBCC4 \uB0B4\uC5ED \uC870\uD68C",
+  description: `\uD2B9\uC815 \uD558\uC704 \uC0C1\uC810(store)\uC758 \uAC70\uB798\uB300\uC0AC(\uC815\uC0B0/\uAC70\uB798 \uB300\uC0AC) \uAC74\uBCC4 \uB0B4\uC5ED\uC744 \uC870\uD68C\uD569\uB2C8\uB2E4.
+
+\uAC01 \uAC74\uC740 \uB2E4\uC74C \uC0C1\uD0DC \uC911 \uD558\uB098\uB97C \uAC00\uC9D1\uB2C8\uB2E4:
+  MATCHED(\uB300\uC0AC \uC131\uACF5), NOT_MATCHED(\uB300\uC0AC \uBD88\uC77C\uCE58), INCOMPARABLE(\uB300\uC0AC \uBD88\uAC00), NOT_COLLECTED(PG \uC815\uBCF4 \uBBF8\uC218\uC9D1), POST_CORRECTION(\uD6C4\uBCF4\uC815)
+  (\uB0B4\uBD80\uC801\uC73C\uB85C \uAD6C\uBD84\uB418\uB294 \uC5ED\uBC29\uD5A5 \uB300\uC0AC \uBD88\uAC00(backward incomparable)\uB294 INCOMPARABLE \uB85C \uD569\uCCD0\uC838 \uC81C\uACF5\uB429\uB2C8\uB2E4.)
+
+\uB300\uC0AC \uBD88\uC77C\uCE58 \uC0C1\uC138\uB294 statuses=[NOT_MATCHED] \uB85C \uC870\uD68C \uD6C4 \uAC01 \uAC74\uC758 notMatchedReasons \uB97C \uD655\uC778\uD569\uB2C8\uB2E4.
+\uB300\uC0AC \uBD88\uAC00 \uC0AC\uC720\uB294 INCOMPARABLE \uAC74\uC758 incomparableReason \uD544\uB4DC\uC5D0\uC11C \uD655\uC778\uD569\uB2C8\uB2E4.
+\uB0A0\uC9DC\uB294 \uBC18\uB4DC\uC2DC YYYY-MM-DD \uD615\uC2DD\uC73C\uB85C \uC785\uB825\uD558\uBA70, dateType \uC73C\uB85C \uC815\uC0B0\uC77C/\uACB0\uC81C\uC77C \uAE30\uC900\uC744 \uC120\uD0DD\uD569\uB2C8\uB2E4.
+\uC870\uD68C \uAE30\uAC04 \uC81C\uC57D: from \uC740 \uCD5C\uADFC 6\uAC1C\uC6D4 \uC774\uB0B4\uC5EC\uC57C \uD558\uACE0, \uD55C \uBC88\uC5D0 \uC870\uD68C \uAC00\uB2A5\uD55C \uAD6C\uAC04\uC740 \uCD5C\uB300 2\uC8FC\uC785\uB2C8\uB2E4.
+store \uC544\uC774\uB514\uB294 list_stores \uB3C4\uAD6C\uB85C \uBA3C\uC800 \uC870\uD68C\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4.`,
+  inputSchema: InputSchema4.shape,
+  outputSchema: OutputSchema5.shape
+};
+function normalize(node) {
+  const status = match8(node.__typename).with("PaymentReconciliationMatched", () => "MATCHED").with("PaymentReconciliationNotMatched", () => "NOT_MATCHED").with("PaymentReconciliationIncomparable", () => "INCOMPARABLE").with("PaymentReconciliationNotCollected", () => "NOT_COLLECTED").with("PaymentReconciliationPostCorrection", () => "POST_CORRECTION").otherwise((t) => t);
+  return {
+    id: node.plainId,
+    status,
+    actionType: node.actionType,
+    pgProvider: node.pgSpecifier?.pgProvider ?? void 0,
+    pgMerchantId: node.pgSpecifier?.pgMerchantId ?? void 0,
+    pgTxId: node.pgTxId ?? node.pgTxIdOptional ?? void 0,
+    paymentAmount: node.paymentAmount,
+    supplyAmount: node.supplyAmount,
+    vatAmount: node.vatAmount,
+    taxFreeAmount: node.taxFreeAmount,
+    anomalyAmount: node.anomalyAmount ?? void 0,
+    paidAt: node.paidAt,
+    paymentCurrency: node.paymentCurrency,
+    isEscrow: node.isEscrow ?? void 0,
+    paymentMethodType: node.paymentMethod?.paymentMethodType ?? node.paymentMethod?.__typename ?? void 0,
+    transactionId: node.transactionPlainId ?? node.transactionPlainIdOptional ?? void 0,
+    paymentId: node.paymentPlainId ?? node.paymentPlainIdOptional ?? void 0,
+    orderName: node.orderName ?? node.orderNameOptional ?? void 0,
+    storeId: node.storePlainId ?? node.storePlainIdOptional ?? void 0,
+    notMatchedReasons: node.notMatchedReasons ?? void 0,
+    incomparableReason: node.reason ?? void 0,
+    settlement: node.settlement ? {
+      feeAmount: node.settlement.feeAmount ?? void 0,
+      feeVatAmount: node.settlement.feeVatAmount ?? void 0,
+      settlementAmount: node.settlement.settlementAmount ?? void 0,
+      settlementCurrency: node.settlement.settlementCurrency ?? void 0,
+      settlementDate: node.settlement.settlementDate ?? void 0
+    } : void 0
+  };
+}
+function init5(tokenProvider, client) {
+  return async ({
+    store,
+    dateType,
+    from,
+    to,
+    statuses,
+    actionTypes,
+    paymentMethodTypes,
+    transactionCurrencies,
+    settlementCurrencies,
+    paymentId,
+    transactionId,
+    pgTxId,
+    orderName,
+    first,
+    after
+  }) => {
+    const dateRangeError = validateReconciliationDateRange(from, to, {
+      days: 14
+    });
+    if (dateRangeError != null) {
+      return toolErrorResult({
+        type: "error",
+        data: { message: dateRangeError }
+      });
+    }
+    const token = await getToken(tokenProvider);
+    if (token.type === "error") {
+      return toolErrorResult(token);
+    }
+    const searchCondition = paymentId == null && transactionId == null && pgTxId == null && orderName == null ? void 0 : {
+      paymentPlainId: paymentId,
+      transactionPlainId: transactionId,
+      pgTxId,
+      orderName
+    };
+    const result = await getReconciliations({
+      client,
+      authorization: token.data,
+      dateType,
+      from,
+      until: to,
+      searchCondition,
+      filter: {
+        storeIds: store == null ? void 0 : [store],
+        paymentReconciliationStatuses: statuses,
+        actionTypes,
+        paymentMethodTypes,
+        transactionCurrencies,
+        settlementCurrencies
+      },
+      first,
+      after
+    });
+    if (result.type === "error") {
+      return toolErrorResult(result);
+    }
+    try {
+      const structuredContent = {
+        items: result.data.edges.map((edge) => normalize(edge.node)),
+        hasNextPage: result.data.pageInfo.hasNextPage,
+        endCursor: result.data.pageInfo.endCursor
+      };
+      return {
+        content: [
+          { type: "text", text: JSON.stringify(structuredContent, null, 2) }
+        ],
+        structuredContent
+      };
+    } catch {
+      return {
+        content: [{ type: "text", text: "\uC11C\uBC84\uB85C\uBD80\uD130 \uC798\uBABB\uB41C \uC751\uB2F5 \uC218\uC2E0" }],
+        isError: true
+      };
+    }
+  };
+}
+
+// src/tools/getSettlementStatistics.ts
+var getSettlementStatistics_exports = {};
+__export(getSettlementStatistics_exports, {
+  config: () => config6,
+  init: () => init6,
+  name: () => name6
+});
+import z14 from "zod";
+
+// src/tools/request/getSettlements.ts
+import { parse as parse4 } from "graphql";
+import { gql as gql4 } from "graphql-request";
+import { match as match9, P as P7 } from "ts-pattern";
+import z13 from "zod";
+var ErrorResponse4 = z13.object({
+  __typename: z13.string(),
+  message: z13.string().nullable()
+});
+var SettlementFilter = z13.object({
+  storeIds: z13.array(z13.string()),
+  pgSpecifiers: z13.array(
+    z13.object({
+      pgMerchantId: z13.string(),
+      pgProvider: ReconciliationPgProvider
+    })
+  )
+}).partial();
+var SettlementAggregate = z13.object({
+  settlementAmount: z13.number(),
+  settlementCount: z13.number(),
+  feeAmount: z13.number(),
+  feeVatAmount: z13.number(),
+  cancelAmount: z13.number(),
+  cancelCount: z13.number(),
+  transactionAmount: z13.number(),
+  postCorrectionCount: z13.number(),
+  postCorrectionAmount: z13.number()
+});
+var SettlementDetail = z13.object({
+  storePlainId: z13.string().nullable(),
+  pgSpecifier: z13.object(
+    nullableObject({ pgMerchantId: z13.string(), pgProvider: z13.string() })
+  ),
+  settlementAmount: z13.number(),
+  settlementCount: z13.number(),
+  feeAmount: z13.number(),
+  feeVatAmount: z13.number(),
+  cancelAmount: z13.number(),
+  cancelCount: z13.number(),
+  transactionAmount: z13.number(),
+  postCorrectionCount: z13.number(),
+  postCorrectionAmount: z13.number()
+}).partial({ storePlainId: true, pgSpecifier: true });
+var SettlementSummaryNode = z13.object({
+  date: z13.string(),
+  settlementCurrency: z13.string(),
+  transactionCurrency: z13.string(),
+  aggregate: SettlementAggregate,
+  details: z13.array(SettlementDetail)
+});
+var CursorPageInfo2 = z13.object({
+  startCursor: z13.string(),
+  endCursor: z13.string(),
+  hasPreviousPage: z13.boolean(),
+  hasNextPage: z13.boolean()
+});
+var SettlementSummariesPayload = z13.object({
+  edges: z13.array(z13.object({ node: SettlementSummaryNode, cursor: z13.string() })),
+  pageInfo: CursorPageInfo2
+});
+var GetSettlementSummariesResponse = z13.object({
+  merchant: z13.object({
+    reconciliation: z13.object({
+      paymentReconciliationSettlementSummaries: SettlementSummariesPayload
+    })
+  }).or(ErrorResponse4)
+}).transform(({ merchant }) => {
+  if ("__typename" in merchant) return merchant;
+  return merchant.reconciliation.paymentReconciliationSettlementSummaries;
+});
+var getSettlementSummariesQuery = parse4(gql4`
+query GetSettlementSummaries(
+  $dateRange: DateRangeInput!
+  $filter: PaymentReconciliationSettlementSummaryFilterInput
+  $first: Int!
+  $after: String
+) {
+  merchant {
+    ...ErrorFragment
+    ... on Merchant {
+      reconciliation {
+        paymentReconciliationSettlementSummaries(
+          dateRange: $dateRange
+          filter: $filter
+          first: $first
+          after: $after
+        ) {
+          edges {
+            cursor
+            node {
+              date
+              settlementCurrency
+              transactionCurrency
+              aggregate {
+                settlementAmount
+                settlementCount
+                feeAmount
+                feeVatAmount
+                cancelAmount
+                cancelCount
+                transactionAmount
+                postCorrectionCount
+                postCorrectionAmount
+              }
+              details {
+                storePlainId
+                pgSpecifier {
+                  pgMerchantId
+                  pgProvider
+                }
+                settlementAmount
+                settlementCount
+                feeAmount
+                feeVatAmount
+                cancelAmount
+                cancelCount
+                transactionAmount
+                postCorrectionCount
+                postCorrectionAmount
+              }
+            }
+          }
+          pageInfo {
+            startCursor
+            endCursor
+            hasPreviousPage
+            hasNextPage
+          }
+        }
+      }
+    }
+  }
+}
+
+fragment ErrorFragment on Error {
+  __typename
+  message
+}
+`);
+async function getSettlementSummaries({
+  client,
+  authorization,
+  from,
+  until,
+  filter,
+  first,
+  after
+}) {
+  try {
+    const response = await client.request({
+      document: getSettlementSummariesQuery,
+      requestHeaders: { authorization },
+      variables: { dateRange: { from, until }, filter, first, after }
+    });
+    const parsed = await GetSettlementSummariesResponse.parseAsync(response);
+    return match9(parsed).returnType().with({ __typename: P7.nonNullable }, ({ __typename, message }) => ({
+      type: "error",
+      data: { message, type: __typename }
+    })).otherwise((data) => ({ type: "success", data }));
+  } catch (error) {
+    return toRequestError(error);
+  }
+}
+var SettlementStatistic = z13.object({
+  amount: z13.number(),
+  count: z13.number(),
+  pendingAmount: z13.number(),
+  pendingCount: z13.number(),
+  currency: z13.string()
+});
+var DailySettlementStatistics = z13.object({
+  date: z13.string(),
+  statistics: z13.array(SettlementStatistic)
+});
+var SettlementStatisticsPayload = z13.object({
+  __typename: z13.literal("PaymentReconciliationSettlementStatisticsPayload"),
+  rangeTotalStatistics: z13.array(SettlementStatistic),
+  dailyStatistics: z13.array(DailySettlementStatistics)
+});
+var GetSettlementStatisticsResponse = z13.object({
+  merchant: z13.object({
+    reconciliation: z13.object({
+      // Output 는 union 이므로 payload 또는 error typename 을 가짐
+      paymentReconciliationSettlementStatistics: SettlementStatisticsPayload.or(ErrorResponse4)
+    })
+  }).or(ErrorResponse4)
+}).transform(({ merchant }) => {
+  if ("__typename" in merchant) return merchant;
+  return merchant.reconciliation.paymentReconciliationSettlementStatistics;
+});
+var getSettlementStatisticsQuery = parse4(gql4`
+query GetSettlementStatistics(
+  $dateRange: DateRangeInput!
+  $filter: PaymentReconciliationSettlementStatisticsFilterInput
+) {
+  merchant {
+    ...ErrorFragment
+    ... on Merchant {
+      reconciliation {
+        paymentReconciliationSettlementStatistics(
+          dateRange: $dateRange
+          filter: $filter
+        ) {
+          __typename
+          ...ErrorFragment
+          ... on PaymentReconciliationSettlementStatisticsPayload {
+            rangeTotalStatistics {
+              amount
+              count
+              pendingAmount
+              pendingCount
+              currency
+            }
+            dailyStatistics {
+              date
+              statistics {
+                amount
+                count
+                pendingAmount
+                pendingCount
+                currency
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}
+
+fragment ErrorFragment on Error {
+  __typename
+  message
+}
+`);
+async function getSettlementStatistics({
+  client,
+  authorization,
+  from,
+  until,
+  filter
+}) {
+  try {
+    const response = await client.request({
+      document: getSettlementStatisticsQuery,
+      requestHeaders: { authorization },
+      variables: { dateRange: { from, until }, filter }
+    });
+    const parsed = await GetSettlementStatisticsResponse.parseAsync(response);
+    if ("rangeTotalStatistics" in parsed) {
+      return { type: "success", data: parsed };
+    }
+    return {
+      type: "error",
+      data: { message: parsed.message, type: parsed.__typename }
+    };
+  } catch (error) {
+    return toRequestError(error);
+  }
+}
+
+// src/tools/getSettlementStatistics.ts
+var name6 = "getSettlementStatistics";
+var DateString2 = z14.string().regex(/^\d{4}-\d{2}-\d{2}$/, "YYYY-MM-DD \uD615\uC2DD\uC758 \uB0A0\uC9DC\uC5EC\uC57C \uD569\uB2C8\uB2E4.");
+var Statistic = z14.object({
+  currency: z14.string().describe("\uD1B5\uD654"),
+  amount: z14.number().describe("\uC815\uC0B0 \uAE08\uC561"),
+  count: z14.number().describe("\uC815\uC0B0 \uAC74 \uC218"),
+  pendingAmount: z14.number().describe("\uC815\uC0B0 \uC608\uC815 \uAE08\uC561"),
+  pendingCount: z14.number().describe("\uC815\uC0B0 \uC608\uC815 \uAC74 \uC218")
+});
+var DailyStatistics = z14.object({
+  date: z14.string().describe("\uC815\uC0B0\uC77C"),
+  statistics: Statistic.array().describe("\uD574\uB2F9 \uC77C\uC790\uC758 \uD1B5\uD654\uBCC4 \uD1B5\uACC4")
+});
+var OutputSchema6 = z14.object({
+  rangeTotalStatistics: Statistic.array().describe(
+    "\uAC80\uC0C9 \uAD6C\uAC04 \uB0B4 \uD1B5\uD654\uBCC4 \uD569\uC0B0 \uD1B5\uACC4"
+  ),
+  dailyStatistics: DailyStatistics.array().describe("\uC77C\uBCC4 \uC815\uC0B0 \uD1B5\uACC4")
+});
+var InputSchema5 = z14.object({
+  store: z14.string().optional().describe(
+    "\uC870\uD68C\uD560 \uD558\uC704 \uC0C1\uC810 \uC544\uC774\uB514. \uC0DD\uB7B5\uD558\uBA74 \uACE0\uAC1D\uC0AC \uB0B4 \uBAA8\uB4E0 \uD558\uC704 \uC0C1\uC810\uC744 \uC870\uD68C\uD569\uB2C8\uB2E4."
+  ),
+  from: DateString2.describe("\uC815\uC0B0\uC77C \uC870\uD68C \uC2DC\uC791\uC77C (YYYY-MM-DD)"),
+  to: DateString2.describe("\uC815\uC0B0\uC77C \uC870\uD68C \uC885\uB8CC\uC77C (YYYY-MM-DD)")
+});
+var config6 = {
+  title: "\uAC70\uB798\uB300\uC0AC \uC815\uC0B0 \uD1B5\uACC4 \uC870\uD68C",
+  description: `\uD2B9\uC815 \uD558\uC704 \uC0C1\uC810(store)\uC758 \uAC70\uB798\uB300\uC0AC \uC815\uC0B0 \uD1B5\uACC4\uB97C \uC870\uD68C\uD569\uB2C8\uB2E4.
+
+\uAC80\uC0C9 \uAD6C\uAC04 \uB0B4 \uD1B5\uD654\uBCC4 \uD569\uC0B0 \uD1B5\uACC4(\uC815\uC0B0/\uC815\uC0B0\uC608\uC815 \uAE08\uC561\xB7\uAC74\uC218)\uC640 \uC77C\uBCC4 \uD1B5\uACC4\uB97C \uC81C\uACF5\uD569\uB2C8\uB2E4.
+\uB0A0\uC9DC\uB294 \uBC18\uB4DC\uC2DC YYYY-MM-DD \uD615\uC2DD\uC73C\uB85C \uC785\uB825\uD569\uB2C8\uB2E4.
+\uC870\uD68C \uAE30\uAC04 \uC81C\uC57D: from \uC740 \uCD5C\uADFC 6\uAC1C\uC6D4 \uC774\uB0B4\uC5EC\uC57C \uD558\uACE0, \uD55C \uBC88\uC5D0 \uC870\uD68C \uAC00\uB2A5\uD55C \uAD6C\uAC04\uC740 \uCD5C\uB300 1\uAC1C\uC6D4\uC785\uB2C8\uB2E4.
+store \uC544\uC774\uB514\uB294 list_stores \uB3C4\uAD6C\uB85C \uBA3C\uC800 \uC870\uD68C\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4.`,
+  inputSchema: InputSchema5.shape,
+  outputSchema: OutputSchema6.shape
+};
+function init6(tokenProvider, client) {
+  return async ({ store, from, to }) => {
+    const dateRangeError = validateReconciliationDateRange(from, to, {
+      months: 1
+    });
+    if (dateRangeError != null) {
+      return toolErrorResult({
+        type: "error",
+        data: { message: dateRangeError }
+      });
+    }
+    const token = await getToken(tokenProvider);
+    if (token.type === "error") {
+      return toolErrorResult(token);
+    }
+    const result = await getSettlementStatistics({
+      client,
+      authorization: token.data,
+      from,
+      until: to,
+      filter: { storeIds: store == null ? void 0 : [store] }
+    });
+    if (result.type === "error") {
+      return toolErrorResult(result);
+    }
+    const structuredContent = {
+      rangeTotalStatistics: result.data.rangeTotalStatistics,
+      dailyStatistics: result.data.dailyStatistics
+    };
+    return {
+      content: [
+        { type: "text", text: JSON.stringify(structuredContent, null, 2) }
+      ],
+      structuredContent
+    };
+  };
+}
+
+// src/tools/getSettlementSummaries.ts
+var getSettlementSummaries_exports = {};
+__export(getSettlementSummaries_exports, {
+  config: () => config7,
+  init: () => init7,
+  name: () => name7
+});
+import z15 from "zod";
+var name7 = "getSettlementSummaries";
+var DateString3 = z15.string().regex(/^\d{4}-\d{2}-\d{2}$/, "YYYY-MM-DD \uD615\uC2DD\uC758 \uB0A0\uC9DC\uC5EC\uC57C \uD569\uB2C8\uB2E4.");
+var Aggregate = z15.object({
+  settlementAmount: z15.number().describe("\uC815\uC0B0 \uAE08\uC561"),
+  settlementCount: z15.number().describe("\uC815\uC0B0 \uAC74 \uC218"),
+  feeAmount: z15.number().describe("PG \uC218\uC218\uB8CC"),
+  feeVatAmount: z15.number().describe("PG \uC218\uC218\uB8CC \uBD80\uAC00\uC138"),
+  cancelAmount: z15.number().describe("\uCDE8\uC18C \uAE08\uC561"),
+  cancelCount: z15.number().describe("\uCDE8\uC18C \uAC74 \uC218"),
+  transactionAmount: z15.number().describe("\uAC70\uB798 \uD569\uACC4 \uAE08\uC561"),
+  postCorrectionCount: z15.number().describe("\uD6C4\uBCF4\uC815 \uAC74 \uC218"),
+  postCorrectionAmount: z15.number().describe("\uD6C4\uBCF4\uC815 \uAE08\uC561")
+});
+var Detail = Aggregate.extend({
+  storeId: z15.string().optional().describe("\uD558\uC704 \uC0C1\uC810 \uC544\uC774\uB514"),
+  pgProvider: z15.string().optional().describe("\uB300\uC0AC\uC6A9 PG\uC0AC"),
+  pgMerchantId: z15.string().optional().describe("PG\uC0AC \uAC00\uB9F9\uC810 \uC2DD\uBCC4 \uC544\uC774\uB514")
+});
+var Summary = z15.object({
+  date: z15.string().describe("\uC815\uC0B0\uC77C"),
+  settlementCurrency: z15.string().describe("\uC815\uC0B0 \uD1B5\uD654"),
+  transactionCurrency: z15.string().describe("\uACB0\uC81C \uD1B5\uD654"),
+  aggregate: Aggregate.describe("\uC815\uC0B0\uB0B4\uC5ED \uD569\uC0B0 \uB370\uC774\uD130"),
+  details: Detail.array().describe("\uC0C1\uC810/PG \uBCC4 \uC0C1\uC138 \uB370\uC774\uD130")
+});
+var OutputSchema7 = z15.object({
+  items: Summary.array().describe("\uC77C\uBCC4 \uC815\uC0B0 \uC694\uC57D \uBAA9\uB85D"),
+  hasNextPage: z15.boolean().describe("\uB2E4\uC74C \uD398\uC774\uC9C0 \uC874\uC7AC \uC5EC\uBD80"),
+  endCursor: z15.string().describe("\uB2E4\uC74C \uD398\uC774\uC9C0 \uC870\uD68C\uC5D0 \uC0AC\uC6A9\uD560 \uCEE4\uC11C")
+});
+var InputSchema6 = z15.object({
+  store: z15.string().optional().describe(
+    "\uC870\uD68C\uD560 \uD558\uC704 \uC0C1\uC810 \uC544\uC774\uB514. \uC0DD\uB7B5\uD558\uBA74 \uACE0\uAC1D\uC0AC \uB0B4 \uBAA8\uB4E0 \uD558\uC704 \uC0C1\uC810\uC744 \uC870\uD68C\uD569\uB2C8\uB2E4."
+  ),
+  from: DateString3.describe("\uC815\uC0B0\uC77C \uC870\uD68C \uC2DC\uC791\uC77C (YYYY-MM-DD)"),
+  to: DateString3.describe("\uC815\uC0B0\uC77C \uC870\uD68C \uC885\uB8CC\uC77C (YYYY-MM-DD)"),
+  first: z15.number().min(1).max(100).default(31).describe("\uC870\uD68C\uD560 \uC77C \uC218 (\uCD5C\uB300 100)"),
+  after: z15.string().optional().describe("\uC774\uC804 \uD398\uC774\uC9C0\uC758 \uB9C8\uC9C0\uB9C9 \uCEE4\uC11C")
+});
+var config7 = {
+  title: "\uAC70\uB798\uB300\uC0AC \uC815\uC0B0 \uC694\uC57D \uC870\uD68C",
+  description: `\uD2B9\uC815 \uD558\uC704 \uC0C1\uC810(store)\uC758 \uAC70\uB798\uB300\uC0AC \uC815\uC0B0 \uC694\uC57D\uC744 \uC815\uC0B0\uC77C \uAE30\uC900 \uC77C\uBCC4\uB85C \uC870\uD68C\uD569\uB2C8\uB2E4.
+
+\uAC01 \uC77C\uC790\uBCC4\uB85C \uC815\uC0B0 \uAE08\uC561/\uAC74\uC218, PG \uC218\uC218\uB8CC, \uCDE8\uC18C, \uD6C4\uBCF4\uC815 \uD569\uC0B0\uCE58\uC640 \uC0C1\uC810\xB7PG\uBCC4 \uC0C1\uC138 \uB0B4\uC5ED\uC744 \uC81C\uACF5\uD569\uB2C8\uB2E4.
+\uB0A0\uC9DC\uB294 \uBC18\uB4DC\uC2DC YYYY-MM-DD \uD615\uC2DD\uC73C\uB85C \uC785\uB825\uD569\uB2C8\uB2E4.
+\uC870\uD68C \uAE30\uAC04 \uC81C\uC57D: from \uC740 \uCD5C\uADFC 6\uAC1C\uC6D4 \uC774\uB0B4\uC5EC\uC57C \uD558\uACE0, \uD55C \uBC88\uC5D0 \uC870\uD68C \uAC00\uB2A5\uD55C \uAD6C\uAC04\uC740 \uCD5C\uB300 1\uAC1C\uC6D4\uC785\uB2C8\uB2E4.
+store \uC544\uC774\uB514\uB294 list_stores \uB3C4\uAD6C\uB85C \uBA3C\uC800 \uC870\uD68C\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4.`,
+  inputSchema: InputSchema6.shape,
+  outputSchema: OutputSchema7.shape
+};
+function init7(tokenProvider, client) {
+  return async ({ store, from, to, first, after }) => {
+    const dateRangeError = validateReconciliationDateRange(from, to, {
+      months: 1
+    });
+    if (dateRangeError != null) {
+      return toolErrorResult({
+        type: "error",
+        data: { message: dateRangeError }
+      });
+    }
+    const token = await getToken(tokenProvider);
+    if (token.type === "error") {
+      return toolErrorResult(token);
+    }
+    const result = await getSettlementSummaries({
+      client,
+      authorization: token.data,
+      from,
+      until: to,
+      filter: { storeIds: store == null ? void 0 : [store] },
+      first,
+      after
+    });
+    if (result.type === "error") {
+      return toolErrorResult(result);
+    }
+    try {
+      const structuredContent = {
+        items: result.data.edges.map(({ node }) => ({
+          date: node.date,
+          settlementCurrency: node.settlementCurrency,
+          transactionCurrency: node.transactionCurrency,
+          aggregate: node.aggregate,
+          details: node.details.map((detail) => ({
+            storeId: detail.storePlainId ?? void 0,
+            pgProvider: detail.pgSpecifier?.pgProvider ?? void 0,
+            pgMerchantId: detail.pgSpecifier?.pgMerchantId ?? void 0,
+            settlementAmount: detail.settlementAmount,
+            settlementCount: detail.settlementCount,
+            feeAmount: detail.feeAmount,
+            feeVatAmount: detail.feeVatAmount,
+            cancelAmount: detail.cancelAmount,
+            cancelCount: detail.cancelCount,
+            transactionAmount: detail.transactionAmount,
+            postCorrectionCount: detail.postCorrectionCount,
+            postCorrectionAmount: detail.postCorrectionAmount
+          }))
+        })),
+        hasNextPage: result.data.pageInfo.hasNextPage,
+        endCursor: result.data.pageInfo.endCursor
+      };
+      return {
+        content: [
+          { type: "text", text: JSON.stringify(structuredContent, null, 2) }
+        ],
+        structuredContent
+      };
+    } catch {
+      return {
+        content: [{ type: "text", text: "\uC11C\uBC84\uB85C\uBD80\uD130 \uC798\uBABB\uB41C \uC751\uB2F5 \uC218\uC2E0" }],
+        isError: true
+      };
+    }
+  };
+}
+
+// src/tools/listDocs.ts
+var listDocs_exports = {};
+__export(listDocs_exports, {
+  config: () => config8,
+  init: () => init8,
+  name: () => name8
+});
+import z16 from "zod";
+
 // src/tools/utils/markdown.ts
 function formatDocumentMetadata(doc) {
   const lines = [];
@@ -1772,8 +2882,8 @@ function formatDocumentMetadata(doc) {
 }
 
 // src/tools/listDocs.ts
-var name5 = "listPortoneDocs";
-var config5 = {
+var name8 = "listPortoneDocs";
+var config8 = {
   title: "\uD3EC\uD2B8\uC6D0 \uBB38\uC11C \uBAA9\uB85D \uC870\uD68C",
   description: `\uD2B9\uC815 \uACBD\uB85C \uD558\uC704\uC5D0 \uC788\uB294 \uBAA8\uB4E0 \uD3EC\uD2B8\uC6D0 \uBB38\uC11C \uBAA9\uB85D\uC744 \uD2B8\uB9AC \uD615\uD0DC\uB85C \uC870\uD68C\uD569\uB2C8\uB2E4.
 \uBAA9\uB85D\uC5D0\uB294 \uBB38\uC11C \uACBD\uB85C, \uC81C\uBAA9, \uC124\uBA85, \uB300\uC0C1 \uBC84\uC804 \uB4F1 \uCD95\uC57D\uB41C \uBB38\uC11C \uC815\uBCF4\uAC00 \uD3EC\uD568\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4.
@@ -1784,15 +2894,15 @@ Returns:
 Note:
   \uBB38\uC11C \uBAA9\uB85D\uC740 \uB300\uB7C9\uC758 \uB370\uC774\uD130\uC774\uBBC0\uB85C \uC0C1\uC704 \uB514\uB809\uD1A0\uB9AC\uB97C \uC870\uD68C\uD560 \uACBD\uC6B0 omitFiles\uB97C true\uB85C \uC124\uC815\uD569\uB2C8\uB2E4.`,
   inputSchema: {
-    paths: z11.string().array().default([]).describe(
+    paths: z16.string().array().default([]).describe(
       "\uD558\uC704 \uBAA9\uB85D\uC744 \uC870\uD68C\uD560 \uACBD\uB85C\uB4E4\uC785\uB2C8\uB2E4. \uBBF8\uC785\uB825 \uC2DC \uC804\uCCB4 \uBAA9\uB85D\uC744 \uC870\uD68C\uD569\uB2C8\uB2E4."
     ),
-    onlyPaths: z11.boolean().default(false).describe(
+    onlyPaths: z16.boolean().default(false).describe(
       "true\uC778 \uACBD\uC6B0 \uBB38\uC11C\uB97C \uC81C\uC678\uD55C \uB514\uB809\uD1A0\uB9AC \uBAA9\uB85D\uB9CC \uD45C\uC2DC\uD558\uACE0, \uB514\uB809\uD1A0\uB9AC \uD558\uC704\uC5D0 readme.md\uAC00 \uC788\uB294 \uACBD\uC6B0 \uD574\uB2F9 \uD30C\uC77C\uC758 \uC124\uBA85\uC744 \uD45C\uC2DC\uD569\uB2C8\uB2E4."
     )
   }
 };
-function init5(documents) {
+function init8(documents) {
   return ({ paths, onlyPaths }) => {
     const { markdownDocs } = documents;
     const filteredDocs = [];
@@ -1869,32 +2979,32 @@ function init5(documents) {
 // src/tools/listSharedTestChannels.ts
 var listSharedTestChannels_exports = {};
 __export(listSharedTestChannels_exports, {
-  config: () => config6,
-  init: () => init6,
-  name: () => name6
+  config: () => config9,
+  init: () => init9,
+  name: () => name9
 });
-import z12 from "zod";
-var name6 = "listSharedTestChannels";
-var SharedTestChannel = z12.object({
-  pg: z12.string().describe(
+import z17 from "zod";
+var name9 = "listSharedTestChannels";
+var SharedTestChannel = z17.object({
+  pg: z17.string().describe(
     "PG\uC0AC \uACB0\uC81C \uBAA8\uB4C8\uC758 \uC2DD\uBCC4\uC790\uB85C, PG\uC0AC\uBCC4\uB85C \uC5EC\uB7EC \uBAA8\uB4C8\uC774 \uC788\uC744 \uC218 \uC788\uC2B5\uB2C8\uB2E4."
   ),
-  mid: z12.string().describe("PG\uC0AC\uC5D0\uC11C \uACE0\uAC1D\uC0AC\uB97C \uAD6C\uBD84\uD558\uAE30 \uC704\uD55C ID"),
-  name: z12.string().describe("\uD3EC\uD2B8\uC6D0\uC5D0\uC11C \uC9C0\uC815\uD55C \uCC44\uB110\uC758 \uC774\uB984"),
-  usage: z12.array(z12.enum(["PAYMENT", "IDENTITY"])).describe("\uCC44\uB110\uC744 \uC0AC\uC6A9 \uAC00\uB2A5\uD55C \uC6A9\uB3C4")
+  mid: z17.string().describe("PG\uC0AC\uC5D0\uC11C \uACE0\uAC1D\uC0AC\uB97C \uAD6C\uBD84\uD558\uAE30 \uC704\uD55C ID"),
+  name: z17.string().describe("\uD3EC\uD2B8\uC6D0\uC5D0\uC11C \uC9C0\uC815\uD55C \uCC44\uB110\uC758 \uC774\uB984"),
+  usage: z17.array(z17.enum(["PAYMENT", "IDENTITY"])).describe("\uCC44\uB110\uC744 \uC0AC\uC6A9 \uAC00\uB2A5\uD55C \uC6A9\uB3C4")
 });
-var OutputSchema5 = z12.object({
-  items: z12.array(SharedTestChannel).describe("\uC870\uD68C\uB41C \uCC44\uB110 \uBAA9\uB85D\uC73C\uB85C, MID\uAC00 \uD3EC\uD568\uB429\uB2C8\uB2E4.")
+var OutputSchema8 = z17.object({
+  items: z17.array(SharedTestChannel).describe("\uC870\uD68C\uB41C \uCC44\uB110 \uBAA9\uB85D\uC73C\uB85C, MID\uAC00 \uD3EC\uD568\uB429\uB2C8\uB2E4.")
 });
-var config6 = {
+var config9 = {
   title: "\uD3EC\uD2B8\uC6D0 \uACF5\uC6A9 \uD14C\uC2A4\uD2B8 \uCC44\uB110 \uBAA9\uB85D \uC870\uD68C",
   description: "\uD3EC\uD2B8\uC6D0\uC5D0\uC11C \uD14C\uC2A4\uD2B8 \uC6A9\uB3C4\uB85C \uC81C\uACF5\uD558\uB294 \uCC44\uB110\uC758 \uBAA9\uB85D\uC744 \uAC00\uC838\uC635\uB2C8\uB2E4.",
   inputSchema: {
-    pgProviders: z12.array(PgProvider).optional().describe("\uBAA9\uB85D\uC5D0 \uC788\uB294 PG\uC0AC(\uBBF8\uC124\uC815 \uC2DC \uBAA8\uB4E0 PG\uC0AC)\uB9CC \uBCF4\uC5EC\uC90D\uB2C8\uB2E4.")
+    pgProviders: z17.array(PgProvider).optional().describe("\uBAA9\uB85D\uC5D0 \uC788\uB294 PG\uC0AC(\uBBF8\uC124\uC815 \uC2DC \uBAA8\uB4E0 PG\uC0AC)\uB9CC \uBCF4\uC5EC\uC90D\uB2C8\uB2E4.")
   },
-  outputSchema: OutputSchema5.shape
+  outputSchema: OutputSchema8.shape
 };
-function init6(tokenProvider) {
+function init9(tokenProvider) {
   return async () => {
     const token = await getToken(tokenProvider);
     if (token.type === "error") {
@@ -1942,31 +3052,31 @@ function init6(tokenProvider) {
 // src/tools/listStores.ts
 var listStores_exports = {};
 __export(listStores_exports, {
-  config: () => config7,
-  init: () => init7,
-  name: () => name7
+  config: () => config10,
+  init: () => init10,
+  name: () => name10
 });
-import z13 from "zod";
-var name7 = "listStores";
-var Store = z13.object({
-  id: z13.string().describe("\uAC70\uB798 \uB2E4\uAC74 \uC870\uD68C\uC6A9 \uC0C1\uC810 \uC2DD\uBCC4\uC790"),
-  storeId: z13.string().describe("\uD3EC\uD2B8\uC6D0 \uC0C1\uC810\uC544\uC774\uB514"),
-  name: z13.string().describe("\uC0C1\uC810\uBA85"),
-  userId: z13.number().optional().describe("V1 \uC720\uC800 \uC544\uC774\uB514"),
-  userCode: z13.string().optional().describe("V1 \uACE0\uAC1D \uC2DD\uBCC4\uBC88\uD638"),
-  tierCode: z13.string().optional().describe("\uD2F0\uC5B4\uCF54\uB4DC")
-});
-var OutputSchema6 = z13.object({
+import z18 from "zod";
+var name10 = "listStores";
+var Store = z18.object({
+  id: z18.string().describe("\uAC70\uB798 \uB2E4\uAC74 \uC870\uD68C\uC6A9 \uC0C1\uC810 \uC2DD\uBCC4\uC790"),
+  storeId: z18.string().describe("\uD3EC\uD2B8\uC6D0 \uC0C1\uC810\uC544\uC774\uB514"),
+  name: z18.string().describe("\uC0C1\uC810\uBA85"),
+  userId: z18.number().optional().describe("V1 \uC720\uC800 \uC544\uC774\uB514"),
+  userCode: z18.string().optional().describe("V1 \uACE0\uAC1D \uC2DD\uBCC4\uBC88\uD638"),
+  tierCode: z18.string().optional().describe("\uD2F0\uC5B4\uCF54\uB4DC")
+});
+var OutputSchema9 = z18.object({
   main: Store.optional().describe("\uB300\uD45C\uC0C1\uC810"),
-  items: z13.array(Store).describe("\uD558\uC704\uC0C1\uC810 \uBAA9\uB85D")
+  items: z18.array(Store).describe("\uD558\uC704\uC0C1\uC810 \uBAA9\uB85D")
 });
-var config7 = {
+var config10 = {
   title: "\uC0C1\uC810 \uBAA9\uB85D \uC870\uD68C",
   description: "\uD3EC\uD2B8\uC6D0 \uACC4\uC815\uC5D0 \uC5F0\uACB0\uB41C \uB300\uD45C\uC0C1\uC810 \uBC0F \uD558\uC704\uC0C1\uC810\uC758 \uC815\uBCF4\uB97C \uAC00\uC838\uC635\uB2C8\uB2E4.",
   inputSchema: {},
-  outputSchema: OutputSchema6.shape
+  outputSchema: OutputSchema9.shape
 };
-function init7(tokenProvider, client) {
+function init10(tokenProvider, client) {
   return async () => {
     const token = await getToken(tokenProvider);
     if (token.type === "error") {
@@ -2005,18 +3115,18 @@ function renameStore(store) {
 // src/tools/readDoc.ts
 var readDoc_exports = {};
 __export(readDoc_exports, {
-  config: () => config8,
-  init: () => init8,
-  name: () => name8
+  config: () => config11,
+  init: () => init11,
+  name: () => name11
 });
-import z14 from "zod";
-var name8 = "readPortoneDoc";
-var OutputSchema7 = z14.object({
-  content: z14.string().describe("\uCC3E\uC740 \uD3EC\uD2B8\uC6D0 \uBB38\uC11C\uC758 \uB0B4\uC6A9"),
-  metadata: z14.string().describe("\uCC3E\uC740 \uD3EC\uD2B8\uC6D0 \uBB38\uC11C\uC758 \uBA54\uD0C0 \uC815\uBCF4"),
-  url: z14.string().describe("\uBB38\uC11C\uB97C \uC6F9\uC73C\uB85C \uC811\uADFC \uAC00\uB2A5\uD55C \uB9C1\uD06C")
+import z19 from "zod";
+var name11 = "readPortoneDoc";
+var OutputSchema10 = z19.object({
+  content: z19.string().describe("\uCC3E\uC740 \uD3EC\uD2B8\uC6D0 \uBB38\uC11C\uC758 \uB0B4\uC6A9"),
+  metadata: z19.string().describe("\uCC3E\uC740 \uD3EC\uD2B8\uC6D0 \uBB38\uC11C\uC758 \uBA54\uD0C0 \uC815\uBCF4"),
+  url: z19.string().describe("\uBB38\uC11C\uB97C \uC6F9\uC73C\uB85C \uC811\uADFC \uAC00\uB2A5\uD55C \uB9C1\uD06C")
 }).partial();
-var config8 = {
+var config11 = {
   title: "\uD3EC\uD2B8\uC6D0 \uBB38\uC11C \uC77D\uAE30",
   description: `\uD3EC\uD2B8\uC6D0 \uAC1C\uBCC4 \uBB38\uC11C\uC758 \uACBD\uB85C\uB97C \uD1B5\uD574 \uD574\uB2F9 \uD3EC\uD2B8\uC6D0 \uBB38\uC11C\uC758 \uB0B4\uC6A9, \uBA54\uD0C0 \uC815\uBCF4(\uC81C\uBAA9, \uC124\uBA85, \uB300\uC0C1 \uBC84\uC804 \uB4F1), \uC6F9\uC73C\uB85C \uC811\uADFC \uAC00\uB2A5\uD55C \uB9C1\uD06C\uB97C \uAC00\uC838\uC635\uB2C8\uB2E4.
 
@@ -2024,14 +3134,14 @@ Note:
   \uBA3C\uC800 listPortoneDocs\uC744 \uC0AC\uC6A9\uD574 \uD3EC\uD2B8\uC6D0 \uBB38\uC11C \uBAA9\uB85D\uC744 \uD655\uC778\uD558\uACE0,
   \uADF8 \uC911 \uC6D0\uD558\uB294 \uBB38\uC11C\uC758 path\uB97C readPortoneDoc\uC5D0 \uC804\uB2EC\uD558\uC5EC \uB0B4\uC6A9\uC744 \uD655\uC778\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4.`,
   inputSchema: {
-    path: z14.string().describe("\uC77D\uC744 \uD3EC\uD2B8\uC6D0 \uBB38\uC11C\uC758 \uACBD\uB85C"),
-    fields: OutputSchema7.keyof().array().describe("\uBC1B\uC744 \uD544\uB4DC \uBAA9\uB85D"),
-    startIndex: z14.number().optional().describe("\uC77D\uC5B4\uC62C \uBC94\uC704 \uC2DC\uC791 \uC778\uB371\uC2A4. \uBBF8\uC124\uC815 \uC2DC \uCC98\uC74C\uBD80\uD130 \uC77D\uC5B4\uC635\uB2C8\uB2E4."),
-    endIndex: z14.number().optional().describe("\uC77D\uC5B4\uC62C \uBC94\uC704 \uB05D \uC778\uB371\uC2A4. \uBBF8\uC124\uC815 \uC2DC \uB05D\uAE4C\uC9C0 \uC77D\uC5B4\uC635\uB2C8\uB2E4.")
+    path: z19.string().describe("\uC77D\uC744 \uD3EC\uD2B8\uC6D0 \uBB38\uC11C\uC758 \uACBD\uB85C"),
+    fields: OutputSchema10.keyof().array().describe("\uBC1B\uC744 \uD544\uB4DC \uBAA9\uB85D"),
+    startIndex: z19.number().optional().describe("\uC77D\uC5B4\uC62C \uBC94\uC704 \uC2DC\uC791 \uC778\uB371\uC2A4. \uBBF8\uC124\uC815 \uC2DC \uCC98\uC74C\uBD80\uD130 \uC77D\uC5B4\uC635\uB2C8\uB2E4."),
+    endIndex: z19.number().optional().describe("\uC77D\uC5B4\uC62C \uBC94\uC704 \uB05D \uC778\uB371\uC2A4. \uBBF8\uC124\uC815 \uC2DC \uB05D\uAE4C\uC9C0 \uC77D\uC5B4\uC635\uB2C8\uB2E4.")
   },
-  outputSchema: OutputSchema7.shape
+  outputSchema: OutputSchema10.shape
 };
-function init8(documents) {
+function init11(documents) {
   return ({ path, fields, startIndex, endIndex }) => {
     const { markdownDocs } = documents;
     const doc = markdownDocs[path];
@@ -2069,11 +3179,11 @@ function init8(documents) {
 // src/tools/readOpenapiSchema.ts
 var readOpenapiSchema_exports = {};
 __export(readOpenapiSchema_exports, {
-  config: () => config9,
-  init: () => init9,
-  name: () => name9
+  config: () => config12,
+  init: () => init12,
+  name: () => name12
 });
-import z15 from "zod";
+import z20 from "zod";
 
 // src/tools/utils/yaml.ts
 import yaml from "js-yaml";
@@ -2143,21 +3253,21 @@ function stringifyYaml(data) {
 }
 
 // src/tools/readOpenapiSchema.ts
-var name9 = "readPortoneOpenapiSchema";
-var config9 = {
+var name12 = "readPortoneOpenapiSchema";
+var config12 = {
   title: "\uD3EC\uD2B8\uC6D0 OpenAPI \uC2A4\uD0A4\uB9C8 \uC77D\uAE30",
   description: `\uC694\uCCAD\uB41C \uD3EC\uD2B8\uC6D0 \uBC84\uC804\uC5D0\uC11C \uC81C\uACF5\uD558\uB294 OpenAPI \uC2A4\uD0A4\uB9C8 \uB0B4 \uD2B9\uC815 path\uC758 \uB370\uC774\uD130\uB97C \uBC18\uD658\uD569\uB2C8\uB2E4.`,
   inputSchema: {
-    version: z15.enum(["V1", "V2"]).describe("\uD3EC\uD2B8\uC6D0 \uBC84\uC804"),
-    yaml_path: z15.array(z15.string()).describe(
+    version: z20.enum(["V1", "V2"]).describe("\uD3EC\uD2B8\uC6D0 \uBC84\uC804"),
+    yaml_path: z20.array(z20.string()).describe(
       "OpenAPI \uC2A4\uD0A4\uB9C8 \uB0B4\uC758 yaml path (list of strings)\n\uD0A4 \uB610\uB294 \uC778\uB371\uC2A4(0\uBD80\uD130 \uC2DC\uC791)\uB97C \uD3EC\uD568\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4."
     )
   },
   outputSchema: {
-    result: z15.string().describe(" OpenAPI \uC2A4\uD0A4\uB9C8\uB97C \uCD5C\uB300 depth 3\uC73C\uB85C \uC694\uC57D\uD55C YAML \uD615\uC2DD\uC758 \uBB38\uC790\uC5F4")
+    result: z20.string().describe(" OpenAPI \uC2A4\uD0A4\uB9C8\uB97C \uCD5C\uB300 depth 3\uC73C\uB85C \uC694\uC57D\uD55C YAML \uD615\uC2DD\uC758 \uBB38\uC790\uC5F4")
   }
 };
-function init9(schema) {
+function init12(schema) {
   return ({ version, yaml_path }) => {
     let schemaData;
     if (version === "V1") {
@@ -2218,23 +3328,23 @@ function init9(schema) {
 // src/tools/readOpenapiSchemaSummary.ts
 var readOpenapiSchemaSummary_exports = {};
 __export(readOpenapiSchemaSummary_exports, {
-  config: () => config10,
-  init: () => init10,
-  name: () => name10
+  config: () => config13,
+  init: () => init13,
+  name: () => name13
 });
-import z16 from "zod";
-var name10 = "readPortoneOpenapiSchemaSummary";
-var config10 = {
+import z21 from "zod";
+var name13 = "readPortoneOpenapiSchemaSummary";
+var config13 = {
   title: "\uD3EC\uD2B8\uC6D0 OpenAPI \uC2A4\uD0A4\uB9C8 \uC694\uC57D",
   description: `\uC694\uCCAD\uB41C \uD3EC\uD2B8\uC6D0 \uBC84\uC804\uC5D0\uC11C \uC81C\uACF5\uD558\uB294 OpenAPI \uC2A4\uD0A4\uB9C8\uB97C \uC694\uC57D\uD574 \uBB38\uC790\uC5F4\uB85C \uBC18\uD658\uD569\uB2C8\uB2E4. \uD574\uB2F9 \uC694\uC57D\uC5D0\uB294 \uC694\uCCAD\uB41C \uD3EC\uD2B8\uC6D0 \uBC84\uC804\uC5D0\uC11C \uC81C\uACF5\uD558\uB294 \uBAA8\uB4E0 REST API\uAC00 \uD3EC\uD568\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4.`,
   inputSchema: {
-    version: z16.enum(["V1", "V2"]).describe("\uD3EC\uD2B8\uC6D0 \uBC84\uC804")
+    version: z21.enum(["V1", "V2"]).describe("\uD3EC\uD2B8\uC6D0 \uBC84\uC804")
   },
   outputSchema: {
-    result: z16.string().describe("OpenAPI \uC2A4\uD0A4\uB9C8\uB97C \uCD5C\uB300 depth 3\uC73C\uB85C \uC694\uC57D\uD55C YAML \uD615\uC2DD\uC758 \uBB38\uC790\uC5F4")
+    result: z21.string().describe("OpenAPI \uC2A4\uD0A4\uB9C8\uB97C \uCD5C\uB300 depth 3\uC73C\uB85C \uC694\uC57D\uD55C YAML \uD615\uC2DD\uC758 \uBB38\uC790\uC5F4")
   }
 };
-function init10(schema) {
+function init13(schema) {
   return ({ version }) => {
     let schemaData;
     if (version === "V1") {
@@ -2295,31 +3405,31 @@ function init10(schema) {
 // src/tools/readV2BackendCode.ts
 var readV2BackendCode_exports = {};
 __export(readV2BackendCode_exports, {
-  config: () => config11,
-  init: () => init11,
-  name: () => name11
+  config: () => config14,
+  init: () => init14,
+  name: () => name14
 });
-import z17 from "zod";
-var name11 = "readPortoneV2BackendCode";
-var config11 = {
+import z22 from "zod";
+var name14 = "readPortoneV2BackendCode";
+var config14 = {
   title: "\uD3EC\uD2B8\uC6D0 V2 \uBC31\uC5D4\uB4DC \uCF54\uB4DC \uC608\uC81C \uC77D\uAE30",
   description: `\uC9C0\uC815\uB41C \uB9E4\uAC1C\uBCC0\uC218\uC5D0 \uB530\uB77C \uD3EC\uD2B8\uC6D0 V2 \uBC31\uC5D4\uB4DC \uCF54\uB4DC \uC608\uC81C\uB97C \uAC00\uC838\uC635\uB2C8\uB2E4.
 \uD3EC\uD2B8\uC6D0 V2\uC5D0 \uAD00\uB828\uD574 \uC5B4\uB5A4 \uC0C1\uD669\uC774\uB4E0 \uD504\uB85C\uADF8\uB798\uBC0D \uC5B8\uC5B4\uB85C \uCF54\uB4DC\uB97C \uC791\uC131\uD574\uC57C \uD55C\uB2E4\uBA74, \uC608\uC678 \uC5C6\uC774 \uAC00\uC7A5 \uBA3C\uC800 \uC774 \uB3C4\uAD6C\uB97C \uD638\uCD9C\uD574 \uC608\uC2DC \uCF54\uB4DC\uB97C \uCC38\uACE0\uD55C \uD6C4 \uC0AC\uC6A9\uC790\uB97C \uB3C4\uC6B0\uC138\uC694.
 framework\uB97C \uC81C\uC678\uD55C \uBAA8\uB4E0 Args\uB294 \uC120\uD0DD\uC0AC\uD56D\uC774\uBA70, \uD2B9\uC815\uB418\uC9C0 \uC54A\uC740 \uACBD\uC6B0 \uBE44\uC6CC\uB450\uC138\uC694.`,
   inputSchema: {
-    framework: z17.string().describe(
+    framework: z22.string().describe(
       "\uC0AC\uC6A9\uD560 \uD504\uB808\uC784\uC6CC\uD06C. \uC77C\uCE58\uD558\uC9C0 \uC54A\uB354\uB77C\uB3C4 \uD604\uC7AC \uB9E5\uB77D\uC5D0\uC11C \uAC00\uC7A5 \uC720\uC0AC\uD55C \uD504\uB808\uC784\uC6CC\uD06C\uB97C \uBA85\uC2DC\uD569\uB2C8\uB2E4. \uC635\uC158: express, fastapi, flask, spring-kotlin"
     ),
-    pg: z17.string().describe(
+    pg: z22.string().describe(
       "\uC0AC\uC6A9\uD560 \uACB0\uC81C \uAC8C\uC774\uD2B8\uC6E8\uC774. \uC635\uC158: toss, nice, smartro, kpn, inicis, ksnet, kcp, kakao, naver, tosspay, hyphen, eximbay"
     ),
-    pay_method: z17.string().describe(
+    pay_method: z22.string().describe(
       "\uC0AC\uC6A9\uD560 \uACB0\uC81C \uBC29\uBC95. \uC635\uC158: card, virtualAccount, easyPay, transfer, mobile, giftCertificate"
     ),
-    smart_routing: z17.boolean().optional().describe("\uC2A4\uB9C8\uD2B8 \uB77C\uC6B0\uD305 \uC0AC\uC6A9 \uC5EC\uBD80. \uC635\uC158: true \uB610\uB294 false")
+    smart_routing: z22.boolean().optional().describe("\uC2A4\uB9C8\uD2B8 \uB77C\uC6B0\uD305 \uC0AC\uC6A9 \uC5EC\uBD80. \uC635\uC158: true \uB610\uB294 false")
   }
 };
-function init11(apiBasePath) {
+function init14(apiBasePath) {
   return async ({ framework, pg, pay_method, smart_routing }) => {
     const url = new URL(
       `${apiBasePath}/opi/ko/quick-guide/payment/backend-code`
@@ -2382,31 +3492,31 @@ ${errorText}`
 // src/tools/readV2FrontendCode.ts
 var readV2FrontendCode_exports = {};
 __export(readV2FrontendCode_exports, {
-  config: () => config12,
-  init: () => init12,
-  name: () => name12
+  config: () => config15,
+  init: () => init15,
+  name: () => name15
 });
-import z18 from "zod";
-var name12 = "readPortoneV2FrontendCode";
-var config12 = {
+import z23 from "zod";
+var name15 = "readPortoneV2FrontendCode";
+var config15 = {
   title: "\uD3EC\uD2B8\uC6D0 V2 \uD504\uB860\uD2B8\uC5D4\uB4DC \uCF54\uB4DC \uC608\uC81C \uC77D\uAE30",
   description: `\uC9C0\uC815\uB41C \uB9E4\uAC1C\uBCC0\uC218\uC5D0 \uB530\uB77C \uD3EC\uD2B8\uC6D0 V2 \uD504\uB860\uD2B8\uC5D4\uB4DC \uCF54\uB4DC \uC608\uC81C\uB97C \uAC00\uC838\uC635\uB2C8\uB2E4.
 \uD3EC\uD2B8\uC6D0 V2\uC5D0 \uAD00\uB828\uD574 \uC5B4\uB5A4 \uC0C1\uD669\uC774\uB4E0 \uD504\uB85C\uADF8\uB798\uBC0D \uC5B8\uC5B4\uB85C \uCF54\uB4DC\uB97C \uC791\uC131\uD574\uC57C \uD55C\uB2E4\uBA74, \uC608\uC678 \uC5C6\uC774 \uAC00\uC7A5 \uBA3C\uC800 \uC774 \uB3C4\uAD6C\uB97C \uD638\uCD9C\uD574 \uC608\uC2DC \uCF54\uB4DC\uB97C \uCC38\uACE0\uD55C \uD6C4 \uC0AC\uC6A9\uC790\uB97C \uB3C4\uC6B0\uC138\uC694.
 framework\uB97C \uC81C\uC678\uD55C \uBAA8\uB4E0 Args\uB294 \uC120\uD0DD\uC0AC\uD56D\uC774\uBA70, \uD2B9\uC815\uB418\uC9C0 \uC54A\uC740 \uACBD\uC6B0 \uBE44\uC6CC\uB450\uC138\uC694.`,
   inputSchema: {
-    framework: z18.string().describe(
+    framework: z23.string().describe(
       "\uC0AC\uC6A9\uD560 \uD504\uB808\uC784\uC6CC\uD06C. \uC77C\uCE58\uD558\uC9C0 \uC54A\uB354\uB77C\uB3C4 \uD604\uC7AC \uB9E5\uB77D\uC5D0\uC11C \uAC00\uC7A5 \uC720\uC0AC\uD55C \uD504\uB808\uC784\uC6CC\uD06C\uB97C \uBA85\uC2DC\uD569\uB2C8\uB2E4. \uC635\uC158: html, react"
     ),
-    pg: z18.string().describe(
+    pg: z23.string().describe(
       "\uC0AC\uC6A9\uD560 \uACB0\uC81C \uAC8C\uC774\uD2B8\uC6E8\uC774. \uC635\uC158: toss, nice, smartro, kpn, inicis, ksnet, kcp, kakao, naver, tosspay, hyphen, eximbay"
     ),
-    pay_method: z18.string().describe(
+    pay_method: z23.string().describe(
       "\uC0AC\uC6A9\uD560 \uACB0\uC81C \uBC29\uBC95. \uC635\uC158: card, virtualAccount, easyPay, transfer, mobile, giftCertificate"
     ),
-    smart_routing: z18.boolean().optional().describe("\uC2A4\uB9C8\uD2B8 \uB77C\uC6B0\uD305 \uC0AC\uC6A9 \uC5EC\uBD80. \uC635\uC158: true \uB610\uB294 false")
+    smart_routing: z23.boolean().optional().describe("\uC2A4\uB9C8\uD2B8 \uB77C\uC6B0\uD305 \uC0AC\uC6A9 \uC5EC\uBD80. \uC635\uC158: true \uB610\uB294 false")
   }
 };
-function init12(apiBasePath) {
+function init15(apiBasePath) {
   return async ({ framework, pg, pay_method, smart_routing }) => {
     const url = new URL(
       `${apiBasePath}/opi/ko/quick-guide/payment/frontend-code`
@@ -2469,11 +3579,11 @@ ${errorText}`
 // src/tools/regexSearch.ts
 var regexSearch_exports = {};
 __export(regexSearch_exports, {
-  config: () => config13,
-  init: () => init13,
-  name: () => name13
+  config: () => config16,
+  init: () => init16,
+  name: () => name16
 });
-import z19 from "zod";
+import z24 from "zod";
 
 // src/tools/utils/bm25.ts
 function calculateBm25Scores(query, documents, k1 = 1.2, b = 0.75) {
@@ -2513,8 +3623,8 @@ ${searchableText}`;
     );
     if (matches.length > 0) {
       const termCounts = {};
-      for (const match7 of matches) {
-        const term = match7[0].toLowerCase();
+      for (const match10 of matches) {
+        const term = match10[0].toLowerCase();
         termCounts[term] = (termCounts[term] || 0) + 1;
       }
       termFrequencies[path] = termCounts;
@@ -2554,29 +3664,29 @@ ${searchableText}`;
 }
 
 // src/tools/regexSearch.ts
-var name13 = "regexSearchPortoneDocs";
-var config13 = {
+var name16 = "regexSearchPortoneDocs";
+var config16 = {
   title: "\uD3EC\uD2B8\uC6D0 \uBB38\uC11C \uC815\uADDC\uD45C\uD604\uC2DD \uAC80\uC0C9",
   description: `\uD2B9\uC815 \uACBD\uB85C \uD558\uC704\uC758 \uD3EC\uD2B8\uC6D0 \uBB38\uC11C\uC758 \uB0B4\uC6A9 \uC911 Node.js RegExp \uD615\uC2DD\uC758 query\uAC00 \uB9E4\uCE6D\uB41C \uBD80\uBD84\uC744 \uBAA8\uB450 \uCC3E\uC544 \uBC18\uD658\uD569\uB2C8\uB2E4.
 \uC815\uADDC\uC2DD \uAE30\uBC18\uC73C\uB85C \uAD00\uB828 \uD3EC\uD2B8\uC6D0 \uBB38\uC11C\uB97C \uCC3E\uACE0 \uC2F6\uC740 \uACBD\uC6B0 \uC774 \uB3C4\uAD6C\uB97C \uC0AC\uC6A9\uD558\uBA70, \uBA54\uD0C0 \uC815\uBCF4\uC640 \uBB38\uC11C \uB0B4\uC6A9 \uBAA8\uB450 \uAC80\uC0C9\uD569\uB2C8\uB2E4.`,
   inputSchema: {
-    paths: z19.string().array().optional().describe(
+    paths: z24.string().array().optional().describe(
       "\uC124\uC815 \uC2DC \uC774 \uACBD\uB85C\uB97C \uC811\uB450\uC0AC\uB85C \uAC00\uC9C0\uB294 \uBB38\uC11C\uC5D0\uC11C\uB9CC \uAC80\uC0C9\uC744 \uC218\uD589\uD569\uB2C8\uB2E4. \uC608\uB97C \uB4E4\uC5B4 OPI \uBB38\uC11C\uC758 \uACBD\uC6B0 opi/\uB97C \uC785\uB825\uD569\uB2C8\uB2E4."
     ),
-    query: z19.string().describe(`Node.js RegExp \uD615\uC2DD\uC758 \uBB38\uC790\uC5F4\uC744 \uC785\uB825\uD574\uC57C \uD558\uBA70, \uC601\uC5B4 \uC54C\uD30C\uBCB3 \uB300\uC18C\uBB38\uC790\uB294 \uAD6C\uBD84 \uC5C6\uC774 \uB9E4\uCE6D\uB429\uB2C8\uB2E4.
+    query: z24.string().describe(`Node.js RegExp \uD615\uC2DD\uC758 \uBB38\uC790\uC5F4\uC744 \uC785\uB825\uD574\uC57C \uD558\uBA70, \uC601\uC5B4 \uC54C\uD30C\uBCB3 \uB300\uC18C\uBB38\uC790\uB294 \uAD6C\uBD84 \uC5C6\uC774 \uB9E4\uCE6D\uB429\uB2C8\uB2E4.
 \uC808\uB300 query\uC5D0 \uACF5\uBC31\uC744 \uD3EC\uD568\uC2DC\uD0A4\uC9C0 \uB9C8\uC138\uC694. \uC5EC\uB7EC \uD0A4\uC6CC\uB4DC\uB97C \uD55C \uBC88\uC5D0 \uAC80\uC0C9\uD558\uACE0 \uC2F6\uB2E4\uBA74, \uACF5\uBC31 \uB300\uC2E0 | \uC5F0\uC0B0\uC790\uB97C \uC0AC\uC6A9\uD558\uC5EC \uAD6C\uBD84\uD569\uB2C8\uB2E4.
 \uB2E8\uC5B4 \uAE00\uC790 \uC0AC\uC774\uC5D0 \uACF5\uBC31\uC774 \uC788\uB294 \uACBD\uC6B0\uB3C4 \uB9E4\uCE6D\uD558\uACE0 \uC2F6\uB2E4\uBA74, \uACF5\uBC31 \uB300\uC2E0 \\s*\uB97C \uC0AC\uC6A9\uD558\uC138\uC694.`),
-    contextSize: z19.number().default(0).describe(`0\uBCF4\uB2E4 \uD070 \uAC12\uC744 \uC124\uC815\uD560 \uACBD\uC6B0, \uAC80\uC0C9 \uACB0\uACFC\uC758 \uCEE8\uD14D\uC2A4\uD2B8 \uD06C\uAE30\uB85C, \uBB38\uC790 \uC218\uB97C \uAE30\uC900\uC73C\uB85C \uD569\uB2C8\uB2E4. 0 \uB610\uB294 50 \uC815\uB3C4\uB97C \uCD94\uCC9C\uD569\uB2C8\uB2E4.
+    contextSize: z24.number().default(0).describe(`0\uBCF4\uB2E4 \uD070 \uAC12\uC744 \uC124\uC815\uD560 \uACBD\uC6B0, \uAC80\uC0C9 \uACB0\uACFC\uC758 \uCEE8\uD14D\uC2A4\uD2B8 \uD06C\uAE30\uB85C, \uBB38\uC790 \uC218\uB97C \uAE30\uC900\uC73C\uB85C \uD569\uB2C8\uB2E4. 0 \uB610\uB294 50 \uC815\uB3C4\uB97C \uCD94\uCC9C\uD569\uB2C8\uB2E4.
 query \uB9E4\uCE58\uAC00 \uBC1C\uACAC\uB41C \uC2DC\uC791 \uC778\uB371\uC2A4\uB97C idx\uB77C\uACE0 \uD560 \uB54C,
 max(0, idx - contextSize)\uBD80\uD130 min(contentLength, idx + len(query) + contextSize) - 1\uAE4C\uC9C0\uC758 \uB0B4\uC6A9\uC744 \uBC18\uD658\uD569\uB2C8\uB2E4.
 \uB2E8, \uC774\uC804 \uAC80\uC0C9\uACB0\uACFC\uC640 \uACB9\uCE58\uB294 \uCEE8\uD14D\uC2A4\uD2B8\uB294 \uBCD1\uD569\uB418\uC5B4 \uBC18\uD658\uB429\uB2C8\uB2E4.`),
-    limit: z19.number().default(1e3).describe(
+    limit: z24.number().default(1e3).describe(
       `\uBC18\uD658\uD560 \uCD5C\uB300 \uBB38\uC790\uC5F4 \uAE38\uC774\uC785\uB2C8\uB2E4. \uCD9C\uB825\uC774 \uC774 \uAE38\uC774\uB97C \uCD08\uACFC\uD558\uBA74 \uC798\uB9AC\uACE0 truncation \uBA54\uC2DC\uC9C0\uAC00 \uCD94\uAC00\uB429\uB2C8\uB2E4.`
     ),
-    page: z19.number().default(0).describe(
+    page: z24.number().default(0).describe(
       `\uACB0\uACFC \uBB38\uC790\uC5F4\uC758 \uD398\uC774\uC9C0\uB124\uC774\uC158\uC744 \uC704\uD55C \uC2DC\uC791 \uC778\uB371\uC2A4\uC785\uB2C8\uB2E4. \uD55C \uD398\uC774\uC9C0\uC758 \uAE00\uC790 \uC218\uB294 limit \uC785\uB2C8\uB2E4.`
     ),
-    showMetadata: z19.boolean().default(false).describe(
+    showMetadata: z24.boolean().default(false).describe(
       "true\uC774\uBA74 \uBB38\uC11C\uC758 \uBA54\uD0C0\uB370\uC774\uD130(\uC81C\uBAA9, \uC124\uBA85, \uB300\uC0C1 \uBC84\uC804)\uC744 \uACB0\uACFC\uC5D0 \uD3EC\uD568\uD569\uB2C8\uB2E4."
     )
   }
@@ -2590,7 +3700,7 @@ ${occurrence.context}
 \`\`\`
 `;
 }
-function init13(documents) {
+function init16(documents) {
   return ({ paths, query, contextSize, page, limit, showMetadata }) => {
     const { markdownDocs } = documents;
     let occurrenceCount = 0;
@@ -2617,14 +3727,14 @@ function init13(documents) {
           });
         }
         const regex = new RegExp(query, "gi");
-        let match7 = regex.exec(doc.content);
-        while (match7 !== null) {
-          match7 = regex.exec(doc.content);
-          if (match7 === null) {
+        let match10 = regex.exec(doc.content);
+        while (match10 !== null) {
+          match10 = regex.exec(doc.content);
+          if (match10 === null) {
             break;
           }
-          const idx = match7.index;
-          const matchLen = match7[0].length;
+          const idx = match10.index;
+          const matchLen = match10[0].length;
           const contextStart = Math.max(0, idx - contextSize);
           const contextEnd = Math.min(contentLen, idx + matchLen + contextSize);
           if (contextStart < lastContextEnd) {
@@ -2806,6 +3916,21 @@ ${documents.readme}`
     getPaymentsByFilter_exports.config,
     getPaymentsByFilter_exports.init(tokenProvider, graphClient)
   );
+  mcp.registerTool(
+    getReconciliationsByFilter_exports.name,
+    getReconciliationsByFilter_exports.config,
+    getReconciliationsByFilter_exports.init(tokenProvider, graphClient)
+  );
+  mcp.registerTool(
+    getSettlementSummaries_exports.name,
+    getSettlementSummaries_exports.config,
+    getSettlementSummaries_exports.init(tokenProvider, graphClient)
+  );
+  mcp.registerTool(
+    getSettlementStatistics_exports.name,
+    getSettlementStatistics_exports.config,
+    getSettlementStatistics_exports.init(tokenProvider, graphClient)
+  );
   const transport = new StdioServerTransport();
   await mcp.connect(transport);
 }