XBOSS

Reliability

Status and outage history · Atom feed · Watch with other listings

How to connect

Add it to any MCP client that supports remote servers.

{
  "mcpServers": {
    "xboss": {
      "type": "http",
      "url": "https://api.xdata.kr/mcp"
    }
  }
}

266 tools

• hometax__session__login

  Call this FIRST before any other tool for this provider. Login to Hometax via NPKI certificate. Returns a session credential.

• hometax__session__user_info

  Retrieve logged-in user info from Hometax.

• hometax__certificate__list

  REQUIRES prior hometax__session__login call with same account_link_id. List certificate applications already filed at Hometax (민원증명 발급 목록) with their receipt ids (cvaId, rcatNo). Read-only. Without strt_dt/end_dt only the last 3 days are returned, so an empty result does not…

• hometax__certificate__apply__national_tax_payment

  REQUIRES prior hometax__session__login call with same account_link_id. Apply for National Tax Payment Certificate from Hometax. IRREVERSIBLE: this files an application with the NTS and a receipt record (cvaId + rcatNo) is created; there is no cancel action. Call without confirm…

• hometax__certificate__apply__tax_payment_record

  REQUIRES prior hometax__session__login call with same account_link_id. Apply for Tax Payment Record Certificate. IRREVERSIBLE: this files an application with the NTS and a receipt record (cvaId + rcatNo) is created; there is no cancel action. Call without confirm first to get a…

• hometax__certificate__apply__vat_standard

  REQUIRES prior hometax__session__login call with same account_link_id. Apply for VAT Standard Certificate. IRREVERSIBLE: this files an application with the NTS and a receipt record (cvaId + rcatNo) is created; there is no cancel action. Call without confirm first to get a…

• hometax__certificate__apply__business_registration

  REQUIRES prior hometax__session__login call with same account_link_id. Apply for Business Registration Certificate. IRREVERSIBLE: this files an application with the NTS and a receipt record (cvaId + rcatNo) is created; there is no cancel action. Call without confirm first to get…

• hometax__certificate__apply__financial_statement

  REQUIRES prior hometax__session__login call with same account_link_id. Apply for Standard Financial Statement Certificate. IRREVERSIBLE: this files an application with the NTS and a receipt record (cvaId + rcatNo) is created; there is no cancel action. Call without confirm first…

• hometax__certificate__apply__business_registration_reissue

  REQUIRES prior hometax__session__login call with same account_link_id. Apply for Business Registration Reissuance. IRREVERSIBLE: this files an application with the NTS and a receipt record (cvaId + rcatNo) is created; there is no cancel action. Call without confirm first to get…

• hometax__etax__invoice__search_summary

  REQUIRES prior hometax__session__login call with same account_link_id. Search e-tax invoice summary (totals). Choose ONE date mode: (1) daily: set date_type='01' and start_date+end_date YYYYMMDD. (2) monthly: set date_type='02' and year+month. (3) quarterly: set date_type='03'…

• hometax__etax__invoice__search_list

  REQUIRES prior hometax__session__login call with same account_link_id. Search e-tax invoices by date range. Use from_date/to_date (YYYYMMDD or YYYY-MM-DD). prh_sls_cl_cd: '01'=issued(매출), '02'=received(매입). 국세청 rejects long ranges with '6개월이상은 조회할 수 없습니다.' — keep the window…

• hometax__etax__invoice__search_statistics

  REQUIRES prior hometax__session__login call with same account_link_id. Search e-tax invoice monthly statistics. Use wrt_ym_strt/wrt_ym_end in YYYYMM format (e.g. 202507/202509 for July-September 2025).

• hometax__etax__invoice__search_detail

  REQUIRES prior hometax__session__login call with same account_link_id. Get detailed information for a specific e-tax invoice by its 승인번호 (etan). Get etan from hometax__etax__invoice__search_list results.

• hometax__etax__invoice__issue

  REQUIRES prior hometax__session__login call with same account_link_id. Issue an e-tax invoice to 국세청. IRREVERSIBLE: once issued the buyer is notified and it enters VAT filing; it can only be corrected by issuing a 수정세금계산서. Call without confirm first — you get a preview of…

• hometax__etax__invoice__modify

  REQUIRES prior hometax__session__login call with same account_link_id. Issue a correcting e-tax invoice (수정세금계산서) against an existing one. IRREVERSIBLE, same as issuing: call without confirm first to get a preview, show it to the user, then retry with confirm=true. You MUST ask…

• hometax__tax__business_registration__search_status

  REQUIRES prior hometax__session__login call with same account_link_id. Search business registration status by business registration number (사업자등록번호).

• hometax__tax__business_registration__search_info

  REQUIRES prior hometax__session__login call with same account_link_id. Search detailed business registration information. Files: a document generated from this result, as Excel (xlsx) only when requested in output_formats, listed in artifacts[] of the result with a download_url…

• hometax__tax__my_tax_agent__search

  REQUIRES prior hometax__session__login call with same account_link_id. Search assigned tax agent information. Files: a document generated from this result, as Excel (xlsx) only when requested in output_formats, listed in artifacts[] of the result with a download_url that works…

• hometax__tax__return_history__search_vat

  REQUIRES prior hometax__session__login call with same account_link_id. Search VAT return history. Use rtn_dt_srt/rtn_dt_end (YYYYMMDD). Dates before 2015-02-23 are refused ('2015년 2월 23일 이후 신고내역만 조회 가능합니다.'), and the NTS screen documents a maximum window of one year — split…

• hometax__tax__payment_due__search_or_pay

  REQUIRES prior hometax__session__login call with same account_link_id. Search tax amounts due by payment deadline (납부할 세액 조회). Read-only: this tool never executes a payment; the 'or_pay' in its name is historical. Files: a document generated from this result, as Excel (xlsx)…

• hometax__tax__electronic_notice__check_status

  REQUIRES prior hometax__session__login call with same account_link_id. Check electronic notice reception status.

• hometax__tax__refund__search_detail

  REQUIRES prior hometax__session__login call with same account_link_id. Search tax refund details. Use strt_dt/end_dt (YYYYMMDD). The NTS only serves the last 5 years from today. Files: a document generated from this result, as Excel (xlsx) only when requested in output_formats…

• hometax__tax__unclaimed_refund__search

  REQUIRES prior hometax__session__login call with same account_link_id. Search unclaimed tax refunds (최근 5년간 미수령 국세환급금). Both txpr_dscm_no and txpr_nm are required by 국세청 — the session TIN does not substitute for them.

• hometax__tax__notice__search_history

  REQUIRES prior hometax__session__login call with same account_link_id. Search tax notice history. Use strt_dt/end_dt (YYYYMMDD). The NTS accepts start dates within the last 10 years. Files: a document generated from this result, as Excel (xlsx) only when requested in…

• hometax__tax__overdue__search_history

  REQUIRES prior hometax__session__login call with same account_link_id. Search overdue tax history (체납 내역). Narrow the period with strt_dt/end_dt; without them the NTS default period applies. Only 3 rows come back per page unless you raise page_size. Files: a document generated…

• hometax__tax__payment_statement__search

  REQUIRES prior hometax__session__login call with same account_link_id. Search tax payment statement. mate_knd_cd: document type code. sbms_ym_strt/sbms_ym_end: submission year-month YYYYMM.

• hometax__tax__payment_statement__search_submit_history

  REQUIRES prior hometax__session__login call with same account_link_id. Search the submission history of payment statements such as daily-worker and simplified payment statements, including whether submitted and the year-month. Use sbms_ym_strt/sbms_ym_end (YYYYMM).

• hometax__tax__trade_partner__search_list

  REQUIRES prior hometax__session__login call with same account_link_id. Search the list of trade partners the customer has registered for management.

• hometax__tax__credit_card__search_sales_data

  REQUIRES prior hometax__session__login call with same account_link_id. Search credit card sales data. Use bsno (business number), stl_yr (year YYYY), qrt_from/qrt_to (quarter 1-4).

• hometax__cash_receipt__sales__search_history

  REQUIRES prior hometax__session__login call with same account_link_id. Search cash receipt sales history. from_date/to_date are required (YYYYMMDD or YYYY-MM-DD). Counts: totalCount (and the same value in pageInfoVO.totalCount) is the record count for this query and is never…

• hometax__cash_receipt__sales__search_summary

  REQUIRES prior hometax__session__login call with same account_link_id. Search cash receipt sales annual summary. Use cmtt_yr for the target year. Optionally specify qrt (quarter 1-4) for quarterly breakdown.

• hometax__cash_receipt__purchase__search_history

  REQUIRES prior hometax__session__login call with same account_link_id. Search cash receipt purchase history. from_date/to_date are required (YYYYMMDD or YYYY-MM-DD). 국세청 rejects ranges longer than 3 months with '조회기간은 최대 3개월 까지 가능합니다.' — split longer periods into 3-month calls…

• hometax__cash_receipt__issue_individual

  REQUIRES prior hometax__session__login call with same account_link_id. Issue a cash receipt for an individual consumer. IRREVERSIBLE on the next day: the NTS ledger changes immediately and it flows into the consumer's year-end tax deduction records; cancellation is possible on…

• hometax__cash_receipt__daily_issue__search

  REQUIRES prior hometax__session__login call with same account_link_id. Search cash receipt issuance records for a single day (당일 발급 조회). trs_dt is optional; omitting it means today. The adapter documents this endpoint as same-day only, so other dates are not a supported lookup…

• hometax__cash_receipt__daily_issue__modify

  REQUIRES prior hometax__session__login call with same account_link_id. Modify a cash receipt issued today. Get aprv_no from hometax__cash_receipt__daily_issue__search. Fields you send are changed to those values; fields you omit (usage, issue means, transaction date/time) are…

• hometax__cash_receipt__daily_issue__cancel

  REQUIRES prior hometax__session__login call with same account_link_id. Cancel a cash receipt issued today. Only aprv_no and cshpt_cncl_rsn_cd are needed: every other field is taken from today's original receipt when omitted (get aprv_no from…

• hometax__certificate__apply_with_template

  REQUIRES prior hometax__session__login call with same account_link_id. Apply for a certificate with an explicitly chosen template. IRREVERSIBLE: this files an application with the NTS and a receipt record (cvaId + rcatNo) is created; there is no cancel action. Call without…

• hometax__certificate__list_templates

  No credential or login required. List the certificate templates that can be applied for (9). The slugs returned here are exactly the values accepted by cert_template; nothing else is.

• hometax__certificate__apply_auto

  REQUIRES prior hometax__session__login call with same account_link_id. Apply for a certificate using the logged-in taxpayer's own details. IRREVERSIBLE: this files an application with the NTS and a receipt record (cvaId + rcatNo) is created; there is no cancel action. Call…

• hometax__certificate__download

  REQUIRES prior hometax__session__login call with same account_link_id. Download an issued certificate as PDF. Result: the issuance ids in data (cva_id, rcat_no) and the PDF in artifacts[] with a signed download_url. Get cva_id/rcat_no from the certificate application result…

Security scan

Recent checks