korea-invoice-mcp

Let AI agents issue Korea NTS e-tax invoices (전자세금계산서) — issue via your own POPBiLL/Linkhub account (merchant-owned LinkID, certificate stays in your account), query status, force NTS transmission. Stateless remote MCP server: per-request HMAC token minting, VAT 10% computed locally, never stores data.

该来源不提供完整文件导出（国内平台多为平台内托管），仅存元数据与原链

模型生成摘要（rules/v1 · 2026-09-27 16:35）：Let AI agents issue Korea NTS e-tax invoices (전자세금계산서) — issue via your own POPBiLL/Linkhub account (merchant-owned Link…
这是模型对公开材料的总结，不是官方声明，请以原链内容为准。

接入信息

传输形态: http
鉴权方式: 鉴权未知
端点: https://korea-invoice-mcp--wishpool.run.tools

鉴权方式未标注，请核对官方文档后再接入——不要直接使用以下片段

{
  "mcpServers": {
    "korea-invoice-mcp": {
      "url": "https://korea-invoice-mcp--wishpool.run.tools"
    }
  }
}

能力清单

工具	说明
create_invoice	Issue a Korean 전자세금계산서 (electronic tax invoice) in ONE step (registIssue = 즉시발행) through POPBiLL, and register it. The invoice is issued to the buyer immediately; POPBiLL transmits it to 국세청 (NTS / National Tax Service) automatically the NEXT day (익일전송) unless you call send_to_nts to force it now. The invoicer (seller) 사업자번호, name and CEO come from you; the buyer (invoicee) and the line items come in the arguments. 부가세 (VAT) is computed for you server-side: taxType 과세 = 10% (per-line tax = floor(supplyCost x 0.1), 원 단위 절사), 영세/면세 = 0. A unique 문서관리번호 (mgt_key) is generated automatically if you do not pass one (rule: "K" + base36 timestamp + random, uppercased, <=24 chars, unique per business). Returns the mgt_key and the assigned ntsConfirmNum (국세청 승인번호). Required credential headers (set once in your MCP client, per-request, never stored): x-popbill-linkid + x-popbill-secretkey (your OWN Linkhub keys, free from linkhub.co.kr 파트너 신청) + x-popbill-corpnum (your 10-digit 사업자번호, the invoicer/seller — the invoice is issued FROM this business). Optional header x-popbill-mode: test (default = POPBILL_TEST, no fiscal effect) \| prod (production, real fiscal effect, live 국세청 transmission). Optional owner-policy headers x-agentpay-max-amount / x-agentpay-approval-above / x-agentpay-allowed-tools.
query_invoice	Look up a single 전자세금계산서 by its 문서관리번호 (mgt_key) — GET /Taxinvoice/{MgtKeyType}/{MgtKey}. MgtKeyType selects whose box: SELL (you issued it as the seller — default), BUY (you received it as the buyer), TRUSTEE (you issued it as an entrusted agent / 수탁). Returns the document stateCode and a readable state: 200 발행완료 (issued), 300 국세청 전송대기 (queued for NTS — next-day auto-send unless send_to_nts is called), 320 국세청 전송완료 (NTS transmission succeeded — terminal success), 330 국세청 전송실패 (failed), 400 발행취소 (cancelled), plus the ntsConfirmNum, issue/NTS-send timestamps and totals. Required credential headers (set once in your MCP client, per-request, never stored): x-popbill-linkid + x-popbill-secretkey (your OWN Linkhub keys, free from linkhub.co.kr 파트너 신청) + x-popbill-corpnum (your 10-digit 사업자번호, the invoicer/seller — the invoice is issued FROM this business). Optional header x-popbill-mode: test (default = POPBILL_TEST, no fiscal effect) \| prod (production, real fiscal effect, live 국세청 transmission). Optional owner-policy headers x-agentpay-max-amount / x-agentpay-approval-above / x-agentpay-allowed-tools.
send_to_nts	FORCE immediate 국세청 (NTS) transmission of an already-issued 전자세금계산서 — POST /Taxinvoice/{MgtKeyType}/{MgtKey} (override NTS). Normally POPBiLL transmits an issued invoice to NTS automatically the NEXT DAY (익일전송); call this only when you need it sent to the tax authority right now instead of waiting for the next-day batch. It does NOT issue the invoice (create_invoice already did that) and does NOT change the invoice content. Returns whether NTS transmission was accepted; poll query_invoice for stateCode 320 (전송완료). Required credential headers (set once in your MCP client, per-request, never stored): x-popbill-linkid + x-popbill-secretkey (your OWN Linkhub keys, free from linkhub.co.kr 파트너 신청) + x-popbill-corpnum (your 10-digit 사업자번호, the invoicer/seller — the invoice is issued FROM this business). Optional header x-popbill-mode: test (default = POPBILL_TEST, no fiscal effect) \| prod (production, real fiscal effect, live 국세청 transmission). Optional owner-policy headers x-agentpay-max-amount / x-agentpay-approval-above / x-agentpay-allowed-tools.

纠错与举报（发现条目失效、署名有误或涉及侵权？）

提交举报 / 纠错

侵权举报经核验成立后，我们会即时下线该条目并删除已存的内容副本。