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…

CommunityOnlineNo sign-inGlobalFreeRead-only

What it can do

  • 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
  • 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 i
  • 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 automatica

What data it sees

Do you need an account

No: the server works without sign-in

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.

Server tool list (3)

Raw names from tools/list. Only developers need these.

create_invoiceIssue 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_invoiceLook 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_ntsFORCE 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.