# XBOSS Muse connector

From musedirectory.ai, the independent directory of Meta Muse connectors. Not affiliated with Meta.

## XBOSS

Korean tax filings, e-invoices, and payroll data from Hometax and NHIS

- Record: https://musedirectory.ai/connector/xboss
- Category: Finance & Bills
- Developer: xdata.kr (https://xdata.kr)
- Muse status: Extra setup. Not in Muse's Connectors list yet. Muse can still use it: its page gives you a request to paste into Muse.
- Health: Working, 1523ms, checked 2026-09-28T09:01:11Z
- Endpoint: https://api.xdata.kr/mcp
- Auth: No account needed; Pricing: unknown
- Screening: Screened, no issues found (2026-09-24T05:01:15Z)
- Source: Found in the official MCP Registry (kr.xdata/xdata-mcp) https://registry.modelcontextprotocol.io/v0/servers?search=kr.xdata%2Fxdata-mcp

Connects to Korea's Hometax system for tax certificates, VAT returns, e-invoices, business registration, and payment records. Also integrates with NHIS for social insurance filings. Requires NPKI certificate login. Supports issuing and modifying tax documents with preview-then-confirm workflow.

Example request: "Show me my VAT return history for the last year and help me apply for a tax payment certificate."

How to connect: Not in Muse's Connectors list yet, but Muse can still use it. Paste this into Muse: "Use XBOSS to help me. It is a free service with an MCP server at https://api.xdata.kr/mcp. It does not need an API key. Ask me before you share anything with it." Muse asks before it shares anything with the app's site. Meta does not review apps used this way, so only use ones you trust. We tested this in the Muse app on September 24, 2026: Muse used an app's link directly this way and returned a live answer.

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 mean
- 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 f
- 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 p
- 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 preview
- 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 a
- 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' an
- 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 under
- 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 exactly
- 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 t
- 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.
- hometax__tax__my_tax_agent__search: REQUIRES prior hometax__session__login call with same account_link_id. Search assigned tax agent information.
- 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 longe
- 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.
- 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.
- 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.
- 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.
- 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 tax declaration and payment submission history. 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 list of trade partners (buyers/sellers) from tax records.
- 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 fewe
- 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. C
- 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. C
- 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 confir
- hometax__certificate__list_templates: REQUIRES prior hometax__session__login call with same account_link_id. 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 withou
- hometax__certificate__download: REQUIRES prior hometax__session__login call with same account_link_id. Download an issued certificate as PDF (returned base64-encoded). Get cva_id/rcat_no from the certificate application result (hometax__certificate__apply_auto or apply_with_template).
- hometax__etax__business_info__get: REQUIRES prior hometax__session__login call with same account_link_id. Get business info for e-tax invoice purposes.
- hometax__etax__client_info__get: REQUIRES prior hometax__session__login call with same account_link_id. Get client/counterparty info for e-tax invoicing.
- nhis_edi__session__login: Call this FIRST before any other tool for this provider. Login to NHIS EDI via NPKI certificate. Returns API_KEY for chaining.

Screening checks:
- MCP handshake: pass (Answered in 1398ms)
- Domain against threat feeds (Cloudflare security DNS): pass (api.xdata.kr, xdata.kr not flagged)
- Published packages against the OSV malicious-package database: n/a (No npm or PyPI package published)
- Hidden instructions or invisible characters in tool text: pass (98 tools read, nothing found)
- Inputs asking for passwords, card numbers or seed phrases: pass (None found)
- Domain and redirects: pass (No redirects off the domain)
- AI review of purpose and tool behavior: pass (No concerns)