{"server":"dev.asiaref/reference-data","count":25,"tools":[{"name":"add_business_days","title":"Add business days to a date","description":"FREE, unmetered. The date n business days after (or, for negative n, before) a start date. The start date is day 0 and never counted; n = 0 returns the date itself if it is a business day, otherwise the next one. Lists every non-business day skipped and why. Uses the country's national public-holiday calendar and its statutory weekend rule (Gulf Friday+Saturday, Israel Saturday-only, India 2nd/4th Saturdays, Nepal's 2026 change, China's multi-day breaks and make-up working days). A date in a year whose holidays we do not hold is refused with error year_not_held and the years_held list; it is never computed from weekends alone. A statutory holiday whose date is not yet fixed is refused as holiday_date_pending. Regional (sub-national) holidays are not applied.","input_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["country","date","n"],"properties":{"n":{"type":"integer","maximum":500,"minimum":-500,"description":"Business days to add; negative walks backward"},"date":{"type":"string","description":"Start date (day 0), YYYY-MM-DD"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code, e.g. 'za', 'ae', 'in'. Every country we hold a holiday calendar for is accepted on every brand, not only this brand's region."}}},"output_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"n":{"type":"number"},"free":{"type":"boolean"},"year":{"type":"number","description":"On year_not_held: the year we do not hold"},"basis":{},"error":{"description":"Present on a free refusal or error; no charge"},"price":{"type":"string"},"caveats":{"type":"array","items":{"type":"string"}},"country":{"type":"string"},"reached":{"type":"string","description":"On a refusal: the first date the calculation could not classify"},"weekend":{"description":"Weekend days applied, the basis of that rule, and any dated or sub-national note"},"calendar":{"description":"Holiday calendar used: years_held, source, last_confirmed, stale"},"direction":{"enum":["forward","backward"],"type":"string"},"no_charge":{"type":"boolean"},"price_usd":{"type":"number"},"convention":{"type":"string"},"disclaimer":{},"how_to_pay":{"type":"array","items":{"type":"string"}},"start_date":{"type":"string"},"years_held":{"type":"array","items":{"type":"number"},"description":"On year_not_held: the years whose holidays we do hold"},"bind_series":{},"explanation":{},"result_date":{"type":"string"},"x_next_bind":{},"country_name":{"type":"string"},"http_endpoint":{"type":"string"},"result_weekday":{"type":"string"},"what_you_can_do":{"type":"array","items":{"type":"string"}},"payment_required":{"type":"boolean","description":"true when the call needs payment; how_to_pay explains x402 or card"},"calendar_days_moved":{"type":"number"},"non_business_days_skipped":{"type":"array","items":{}}},"description":"Date plus n business days, with every non-business day skipped and why","additionalProperties":{}},"annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T15:02:05.489Z"},{"name":"business_days_between","title":"Count business days between two dates","description":"FREE, unmetered. Business days between two dates. business_days counts (from, to] and is negative when to is before from, so add_business_days(from, business_days) lands on to whenever to is a business day; business_days_inclusive counts both ends. Also returns weekend days and the public holidays in range. Uses the country's national public-holiday calendar and its statutory weekend rule (Gulf Friday+Saturday, Israel Saturday-only, India 2nd/4th Saturdays, Nepal's 2026 change, China's multi-day breaks and make-up working days). A date in a year whose holidays we do not hold is refused with error year_not_held and the years_held list; it is never computed from weekends alone. A statutory holiday whose date is not yet fixed is refused as holiday_date_pending. Regional (sub-national) holidays are not applied.","input_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["country","from","to"],"properties":{"to":{"type":"string","description":"Range end, YYYY-MM-DD"},"from":{"type":"string","description":"Range start, YYYY-MM-DD"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code, e.g. 'za', 'ae', 'in'. Every country we hold a holiday calendar for is accepted on every brand, not only this brand's region."}}},"output_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"to":{"type":"string"},"free":{"type":"boolean"},"from":{"type":"string"},"year":{"type":"number","description":"On year_not_held: the year we do not hold"},"basis":{},"error":{"description":"Present on a free refusal or error; no charge"},"price":{"type":"string"},"caveats":{"type":"array","items":{"type":"string"}},"country":{"type":"string"},"reached":{"type":"string","description":"On a refusal: the first date the calculation could not classify"},"weekend":{"description":"Weekend days applied, the basis of that rule, and any dated or sub-national note"},"calendar":{"description":"Holiday calendar used: years_held, source, last_confirmed, stale"},"no_charge":{"type":"boolean"},"price_usd":{"type":"number"},"convention":{"type":"string"},"disclaimer":{},"how_to_pay":{"type":"array","items":{"type":"string"}},"years_held":{"type":"array","items":{"type":"number"},"description":"On year_not_held: the years whose holidays we do hold"},"bind_series":{},"explanation":{},"x_next_bind":{},"country_name":{"type":"string"},"weekend_days":{"type":"number"},"business_days":{"type":"number","description":"Business days in (from, to]; negative when to is before from"},"http_endpoint":{"type":"string"},"what_you_can_do":{"type":"array","items":{"type":"string"}},"payment_required":{"type":"boolean","description":"true when the call needs payment; how_to_pay explains x402 or card"},"business_days_inclusive":{"type":"number","description":"Business days counting both ends"},"calendar_days_inclusive":{"type":"number"},"public_holidays_on_weekdays":{"type":"array","items":{}},"public_holidays_on_weekends":{"type":"array","items":{}}},"description":"Business days between two dates: signed (from, to] count and inclusive count","additionalProperties":{}},"annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T15:02:05.489Z"},{"name":"check_minimum_wage","title":null,"description":"PAID ($0.02). Compliance verdict: is a salary at, above or below the country's statutory minimum wage? Returns verdict, margin, the statutory floor and the legal instrument it rests on. Honest statuses when no enforceable floor exists or the period doesn't match the floor's period (cross-period conversion is never guessed). Pass api_key if you have one (instant card checkout at /pricing); otherwise the response explains how to pay via x402. The evaluation country is free to try (see list_series). Optional receipt (boolean, default false): on a paid success, include an Ed25519 answer receipt at no extra USDC. An answer receipt is not a series certified extract (GET /v1/certified/{country}/{series} is $0.10 and is not an MCP tool) and is not legal advice. Verify with verify_answer_receipt against /certified/public-key.","input_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["country","amount","period"],"properties":{"amount":{"type":"number","description":"Wage to check, in the country's own currency"},"period":{"enum":["month","day","hour","week"],"type":"string","description":"Period the amount covers — must match the statutory floor's period"},"api_key":{"type":"string","description":"API key (bypasses x402; metered for invoicing)"},"country":{"enum":["ae","bd","bh","cn","hk","id","il","in","iq","jo","jp","kr","kw","kz","lk","my","np","om","ph","pk","qa","sa","sg","th","tr","tw","uz","vn"],"type":"string","description":"ISO country code"},"receipt":{"type":"boolean","default":false,"description":"Default false. When true, a paid success includes an Ed25519 answer receipt (kind answer_receipt) at no extra USDC. Unpaid 402 and free refusals do not include one. Not a series certified extract (GET /v1/certified/{country}/{series} at $0.10; that SKU is not an MCP tool)."}}},"output_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"basis":{},"error":{"description":"Present on a free refusal or error; no charge"},"floor":{},"status":{"type":"string","description":"Answer status, e.g. computed or an honest no-answer status"},"country":{"type":"string"},"receipt":{"description":"Ed25519 answer receipt when receipt=true on a paid success"},"verdict":{},"question":{},"no_charge":{"type":"boolean"},"price_usd":{"type":"number"},"disclaimer":{},"how_to_pay":{"type":"array","items":{"type":"string"}},"provenance":{"description":"Cited official sources behind the answer"},"bind_series":{},"explanation":{},"label_basis":{"type":"object","properties":{"rules":{"type":"string"},"stale":{"type":"boolean"},"inputs":{"type":"array","items":{}},"source_type":{"type":["string","null"]},"rules_version":{"type":"string"},"coverage_reasons":{"type":"array","items":{"type":"string"}},"confidence_reasons":{"type":"array","items":{"type":"string"}},"verification_age_days":{"type":["number","null"]}},"description":"Inputs and the rule ids that produced the two labels","additionalProperties":{}},"x_next_bind":{},"http_endpoint":{"type":"string"},"coverage_label":{"enum":["ready","partial","gap"],"type":"string","description":"How much of the question is covered: ready = complete; partial = held with a disclosed limitation or default; gap = no number served. Rules at /label-rules"},"confidence_label":{"enum":["high","medium","low"],"type":"string","description":"Evidence verdict derived from source type, verification age and the stale flag (answers: the weakest series read). Rules at /label-rules"},"payment_required":{"type":"boolean","description":"true when the call needs payment; how_to_pay explains x402 or card"}},"description":"Minimum-wage compliance verdict","additionalProperties":{}},"annotations":{"title":"Check Minimum Wage","readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T15:02:05.489Z"},{"name":"compare_series","title":null,"description":"PAID ($0.02). One series (e.g. vat, policy-rate, minimum-wage, corporate-tax) across up to 10 countries of this brand in one call; each row carries its own source, dates and labels, and countries without the series are listed under missing. Malformed requests are refused free. Pass api_key if you have one; otherwise the response explains how to pay via x402. After a 200, bind get_changes (free poll) or register_alert (HMAC push; Register: $0 · Delivery after trial: $0.05) on this series so a later gazette does not silently retire the value.","input_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["series","countries"],"properties":{"series":{"type":"string","description":"Series id from list_series, e.g. vat"},"api_key":{"type":"string","description":"API key"},"countries":{"type":"array","items":{"type":"string"},"maxItems":10,"minItems":1,"description":"ISO 3166-1 alpha-2 codes on this brand, at most 10"}}},"output_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"rows":{"type":"array","items":{"type":"object","properties":{"unit":{},"notes":{},"stale":{"type":"boolean"},"value":{},"series":{"type":"string"},"source":{},"country":{"type":"string"},"confidence":{},"label_basis":{"type":"object","properties":{"rules":{"type":"string"},"stale":{"type":"boolean"},"inputs":{"type":"array","items":{}},"source_type":{"type":["string","null"]},"rules_version":{"type":"string"},"coverage_reasons":{"type":"array","items":{"type":"string"}},"confidence_reasons":{"type":"array","items":{"type":"string"}},"verification_age_days":{"type":["number","null"]}},"description":"Inputs and the rule ids that produced the two labels","additionalProperties":{}},"coverage_label":{"enum":["ready","partial","gap"],"type":"string","description":"How much of the question is covered: ready = complete; partial = held with a disclosed limitation or default; gap = no number served. Rules at /label-rules"},"effective_from":{},"last_confirmed":{},"confidence_label":{"enum":["high","medium","low"],"type":"string","description":"Evidence verdict derived from source type, verification age and the stale flag (answers: the weakest series read). Rules at /label-rules"}},"additionalProperties":{}}},"as_of":{"type":"string"},"count":{"type":"number"},"error":{"description":"Present on a free refusal or error; no charge"},"series":{"type":"string"},"missing":{"type":"array","items":{}},"no_charge":{"type":"boolean"},"price_usd":{"type":"number"},"disclaimer":{},"how_to_pay":{"type":"array","items":{"type":"string"}},"bind_series":{},"explanation":{},"x_next_bind":{},"http_endpoint":{"type":"string"},"payment_required":{"type":"boolean","description":"true when the call needs payment; how_to_pay explains x402 or card"}},"description":"One series across up to 10 countries, each row cited","additionalProperties":{}},"annotations":{"title":"Compare Series Across Countries","readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T15:02:05.489Z"},{"name":"compute_employment_cost","title":null,"description":"PAID ($0.05). Cost to employ: prices every statutory contribution on both the employee and employer sides for a gross salary, returning line-by-line amounts with instrument citations and an explicit refused list for schemes that could not be priced (unknown, not zero). Does NOT compute income tax — use compute_payroll for gross-to-net take-home where supported. Pass api_key if you have one (instant card checkout at /pricing); otherwise the response explains how to pay via x402. The evaluation country is free to try (see list_series). Optional receipt (boolean, default false): on a paid success, include an Ed25519 answer receipt at no extra USDC. An answer receipt is not a series certified extract (GET /v1/certified/{country}/{series} is $0.10 and is not an MCP tool) and is not legal advice. Verify with verify_answer_receipt against /certified/public-key.","input_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["country","gross"],"properties":{"gross":{"type":"number","description":"Gross pay in local currency"},"period":{"enum":["month","year"],"type":"string","description":"Period the gross covers (default month)"},"api_key":{"type":"string","description":"API key (bypasses x402; metered for invoicing)"},"country":{"enum":["ae"],"type":"string","description":"ISO country code with a costed contribution schedule"},"receipt":{"type":"boolean","default":false,"description":"Default false. When true, a paid success includes an Ed25519 answer receipt (kind answer_receipt) at no extra USDC. Unpaid 402 and free refusals do not include one. Not a series certified extract (GET /v1/certified/{country}/{series} at $0.10; that SKU is not an MCP tool)."},"contract":{"enum":["indefinite","fixed_term"],"type":"string","description":"Contract type where rates differ"},"nationality":{"enum":["national","gcc","expat"],"type":"string","description":"Gulf nationality for pension reach"},"subdivision":{"type":"string","description":"Optional ISO 3166-2 regional schedule (e.g. CA-QC, DE-SN)"},"childless_over_23":{"type":"boolean","description":"Germany care surcharge"},"children_under_25":{"type":"number","description":"Germany per-child care reduction"},"workplace_pension":{"type":"boolean","description":"Auto-enrolment / PPK participation (default true)"},"zusatzbeitrag_rate":{"type":"number","description":"Germany sickness-fund supplement"}}},"output_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"basis":{},"error":{"description":"Present on a free refusal or error; no charge"},"status":{"type":"string","description":"Answer status, e.g. computed or an honest no-answer status"},"country":{"type":"string"},"receipt":{"description":"Ed25519 answer receipt when receipt=true on a paid success"},"question":{},"no_charge":{"type":"boolean"},"price_usd":{"type":"number"},"disclaimer":{},"how_to_pay":{"type":"array","items":{"type":"string"}},"provenance":{"description":"Cited official sources behind the answer"},"bind_series":{},"explanation":{},"label_basis":{"type":"object","properties":{"rules":{"type":"string"},"stale":{"type":"boolean"},"inputs":{"type":"array","items":{}},"source_type":{"type":["string","null"]},"rules_version":{"type":"string"},"coverage_reasons":{"type":"array","items":{"type":"string"}},"confidence_reasons":{"type":"array","items":{"type":"string"}},"verification_age_days":{"type":["number","null"]}},"description":"Inputs and the rule ids that produced the two labels","additionalProperties":{}},"x_next_bind":{},"http_endpoint":{"type":"string"},"coverage_label":{"enum":["ready","partial","gap"],"type":"string","description":"How much of the question is covered: ready = complete; partial = held with a disclosed limitation or default; gap = no number served. Rules at /label-rules"},"confidence_label":{"enum":["high","medium","low"],"type":"string","description":"Evidence verdict derived from source type, verification age and the stale flag (answers: the weakest series read). Rules at /label-rules"},"payment_required":{"type":"boolean","description":"true when the call needs payment; how_to_pay explains x402 or card"}},"description":"Employee and employer statutory contributions with citations","additionalProperties":{}},"annotations":{"title":"Compute Employment Cost","readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T15:02:05.489Z"},{"name":"compute_income_tax","title":null,"description":"PAID ($0.02). Statutory income tax on a TAXABLE-income figure using the country's verified marginal bracket schedule, with full per-bracket workings, effective rate and marginal rate. You pass the amount in local currency. IMPORTANT: this is tax on taxable income, NOT net take-home pay — reliefs/allowances and social-security contributions are the caller's concern and are not applied (see the response scope_note). Pass api_key if you have one (instant card checkout at /pricing); otherwise the response explains how to pay via x402. The evaluation country is free to try (see list_series). Optional receipt (boolean, default false): on a paid success, include an Ed25519 answer receipt at no extra USDC. An answer receipt is not a series certified extract (GET /v1/certified/{country}/{series} is $0.10 and is not an MCP tool) and is not legal advice. Verify with verify_answer_receipt against /certified/public-key.","input_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["country","taxable_income"],"properties":{"api_key":{"type":"string","description":"API key (bypasses x402; metered for invoicing)"},"country":{"enum":["ae","bd","bh","cn","hk","id","il","in","iq","jo","jp","kr","kw","kz","lk","my","np","om","ph","pk","qa","sa","sg","th","tr","tw","uz","vn"],"type":"string","description":"ISO country code"},"receipt":{"type":"boolean","default":false,"description":"Default false. When true, a paid success includes an Ed25519 answer receipt (kind answer_receipt) at no extra USDC. Unpaid 402 and free refusals do not include one. Not a series certified extract (GET /v1/certified/{country}/{series} at $0.10; that SKU is not an MCP tool)."},"taxable_income":{"type":"number","description":"Taxable income in the country's local currency, in the schedule's own period basis (annual for most; monthly for Côte d'Ivoire, Uganda, Ethiopia, Costa Rica)"}}},"output_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"tax":{},"basis":{},"error":{"description":"Present on a free refusal or error; no charge"},"status":{"type":"string","description":"Answer status, e.g. computed or an honest no-answer status"},"country":{"type":"string"},"receipt":{"description":"Ed25519 answer receipt when receipt=true on a paid success"},"question":{},"breakdown":{},"no_charge":{"type":"boolean"},"price_usd":{"type":"number"},"disclaimer":{},"how_to_pay":{"type":"array","items":{"type":"string"}},"provenance":{"description":"Cited official sources behind the answer"},"scope_note":{},"bind_series":{},"explanation":{},"label_basis":{"type":"object","properties":{"rules":{"type":"string"},"stale":{"type":"boolean"},"inputs":{"type":"array","items":{}},"source_type":{"type":["string","null"]},"rules_version":{"type":"string"},"coverage_reasons":{"type":"array","items":{"type":"string"}},"confidence_reasons":{"type":"array","items":{"type":"string"}},"verification_age_days":{"type":["number","null"]}},"description":"Inputs and the rule ids that produced the two labels","additionalProperties":{}},"x_next_bind":{},"http_endpoint":{"type":"string"},"marginal_rate":{},"coverage_label":{"enum":["ready","partial","gap"],"type":"string","description":"How much of the question is covered: ready = complete; partial = held with a disclosed limitation or default; gap = no number served. Rules at /label-rules"},"effective_rate":{},"confidence_label":{"enum":["high","medium","low"],"type":"string","description":"Evidence verdict derived from source type, verification age and the stale flag (answers: the weakest series read). Rules at /label-rules"},"payment_required":{"type":"boolean","description":"true when the call needs payment; how_to_pay explains x402 or card"}},"description":"Income tax on taxable income with per-bracket workings","additionalProperties":{}},"annotations":{"title":"Compute Income Tax","readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T15:02:05.489Z"},{"name":"compute_statutory_interest","title":null,"description":"PAID ($0.02). Simple statutory interest on a principal at the cited statutory-interest series rate: Actual/365 simple, principal × (rate/100) × (days/365). Pass days, or from and to as YYYY-MM-DD (from inclusive, to exclusive). If both are sent and disagree, the call is refused free. A series with no numeric rate after materialization (mechanism-only) is refused free — a non-answer is not sold. Not legal advice. Jurisdiction-specific compounding and day-count statutes are not applied. Pass api_key if you have one (instant card checkout at /pricing); otherwise the response explains how to pay via x402. Every JP series is free to try. Optional receipt (boolean, default false): on a paid success, include an Ed25519 answer receipt at no extra USDC. An answer receipt is not a series certified extract (GET /v1/certified/{country}/{series} is $0.10 and is not an MCP tool) and is not legal advice. Verify with verify_answer_receipt against /certified/public-key.","input_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["country","principal"],"properties":{"to":{"type":"string","description":"Period end, YYYY-MM-DD, exclusive."},"days":{"type":"number","description":"Day-count days. Omit when from and to are set. If both are sent and disagree, the answer is refused free (HTTP 400)."},"from":{"type":"string","description":"Period start, YYYY-MM-DD, inclusive. Pair with to. Day count is calendar days from inclusive to to exclusive (UTC dates)."},"api_key":{"type":"string","description":"API key (bypasses x402; metered for invoicing)"},"country":{"enum":["ae","bd","bh","cn","hk","id","il","in","iq","jo","jp","kr","kw","kz","lk","my","np","om","ph","pk","qa","sa","sg","th","tr","tw","uz","vn"],"type":"string","description":"ISO country code"},"receipt":{"type":"boolean","default":false,"description":"Default false. When true, a paid success includes an Ed25519 answer receipt (kind answer_receipt) at no extra USDC. Unpaid 402 and free refusals do not include one. Not a series certified extract (GET /v1/certified/{country}/{series} at $0.10; that SKU is not an MCP tool)."},"principal":{"type":"number","description":"Principal in the country's own currency. Must be a finite number greater than 0."}}},"output_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"basis":{},"error":{"description":"Present on a free refusal or error; no charge"},"status":{"type":"string","description":"Answer status, e.g. computed or an honest no-answer status"},"country":{"type":"string"},"receipt":{"description":"Ed25519 answer receipt when receipt=true on a paid success"},"question":{},"no_charge":{"type":"boolean"},"price_usd":{"type":"number"},"disclaimer":{},"how_to_pay":{"type":"array","items":{"type":"string"}},"provenance":{"description":"Cited official sources behind the answer"},"bind_series":{},"explanation":{},"label_basis":{"type":"object","properties":{"rules":{"type":"string"},"stale":{"type":"boolean"},"inputs":{"type":"array","items":{}},"source_type":{"type":["string","null"]},"rules_version":{"type":"string"},"coverage_reasons":{"type":"array","items":{"type":"string"}},"confidence_reasons":{"type":"array","items":{"type":"string"}},"verification_age_days":{"type":["number","null"]}},"description":"Inputs and the rule ids that produced the two labels","additionalProperties":{}},"x_next_bind":{},"http_endpoint":{"type":"string"},"coverage_label":{"enum":["ready","partial","gap"],"type":"string","description":"How much of the question is covered: ready = complete; partial = held with a disclosed limitation or default; gap = no number served. Rules at /label-rules"},"confidence_label":{"enum":["high","medium","low"],"type":"string","description":"Evidence verdict derived from source type, verification age and the stale flag (answers: the weakest series read). Rules at /label-rules"},"payment_required":{"type":"boolean","description":"true when the call needs payment; how_to_pay explains x402 or card"}},"description":"Simple statutory interest at the cited rate","additionalProperties":{}},"annotations":{"title":"Compute Statutory Interest","readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T15:02:05.489Z"},{"name":"compute_vat","title":null,"description":"PAID ($0.01). VAT breakdown for an amount: net, tax and gross using the country's current statutory rate, including per-levy components where the rate is composite (e.g. Ghana VAT + NHIL + GETFund). mode=add treats the amount as net; mode=extract backs VAT out of a gross amount. Pass api_key if you have one (instant card checkout at /pricing); otherwise the response explains how to pay via x402. The evaluation country is free to try (see list_series). Optional receipt (boolean, default false): on a paid success, include an Ed25519 answer receipt at no extra USDC. An answer receipt is not a series certified extract (GET /v1/certified/{country}/{series} is $0.10 and is not an MCP tool) and is not legal advice. Verify with verify_answer_receipt against /certified/public-key.","input_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["country","amount"],"properties":{"mode":{"enum":["add","extract"],"type":"string","description":"add = amount is net (default); extract = amount is gross"},"amount":{"type":"number","description":"Amount in the country's own currency"},"api_key":{"type":"string","description":"API key"},"country":{"enum":["ae","bd","bh","cn","hk","id","il","in","iq","jo","jp","kr","kw","kz","lk","my","np","om","ph","pk","qa","sa","sg","th","tr","tw","uz","vn"],"type":"string","description":"ISO country code"},"receipt":{"type":"boolean","default":false,"description":"Default false. When true, a paid success includes an Ed25519 answer receipt (kind answer_receipt) at no extra USDC. Unpaid 402 and free refusals do not include one. Not a series certified extract (GET /v1/certified/{country}/{series} at $0.10; that SKU is not an MCP tool)."}}},"output_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"net":{},"tax":{},"rate":{},"basis":{},"error":{"description":"Present on a free refusal or error; no charge"},"gross":{},"status":{"type":"string","description":"Answer status, e.g. computed or an honest no-answer status"},"country":{"type":"string"},"receipt":{"description":"Ed25519 answer receipt when receipt=true on a paid success"},"question":{},"workings":{},"no_charge":{"type":"boolean"},"price_usd":{"type":"number"},"disclaimer":{},"how_to_pay":{"type":"array","items":{"type":"string"}},"provenance":{"description":"Cited official sources behind the answer"},"bind_series":{},"explanation":{},"label_basis":{"type":"object","properties":{"rules":{"type":"string"},"stale":{"type":"boolean"},"inputs":{"type":"array","items":{}},"source_type":{"type":["string","null"]},"rules_version":{"type":"string"},"coverage_reasons":{"type":"array","items":{"type":"string"}},"confidence_reasons":{"type":"array","items":{"type":"string"}},"verification_age_days":{"type":["number","null"]}},"description":"Inputs and the rule ids that produced the two labels","additionalProperties":{}},"x_next_bind":{},"http_endpoint":{"type":"string"},"coverage_label":{"enum":["ready","partial","gap"],"type":"string","description":"How much of the question is covered: ready = complete; partial = held with a disclosed limitation or default; gap = no number served. Rules at /label-rules"},"confidence_label":{"enum":["high","medium","low"],"type":"string","description":"Evidence verdict derived from source type, verification age and the stale flag (answers: the weakest series read). Rules at /label-rules"},"payment_required":{"type":"boolean","description":"true when the call needs payment; how_to_pay explains x402 or card"}},"description":"VAT breakdown","additionalProperties":{}},"annotations":{"title":"Compute VAT","readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T15:02:05.489Z"},{"name":"count_working_days","title":null,"description":"PAID ($0.002). Working days in a date range for a country: weekends (Egypt's Fri–Sat handled) and statutory public holidays applied, with the holidays hit by name and the next working day after the range. Range max 366 days. Pass api_key if you have one (instant card checkout at /pricing); otherwise the response explains how to pay via x402. The evaluation country is free to try (see list_series). Optional receipt (boolean, default false): on a paid success, include an Ed25519 answer receipt at no extra USDC. An answer receipt is not a series certified extract (GET /v1/certified/{country}/{series} is $0.10 and is not an MCP tool) and is not legal advice. Verify with verify_answer_receipt against /certified/public-key.","input_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["country","from","to"],"properties":{"to":{"type":"string","description":"Range end, YYYY-MM-DD, inclusive"},"from":{"type":"string","description":"Range start, YYYY-MM-DD, inclusive"},"api_key":{"type":"string","description":"API key"},"country":{"enum":["ae","bd","bh","cn","hk","id","il","in","iq","jo","jp","kr","kw","kz","lk","my","np","om","ph","pk","qa","sa","sg","th","tr","tw","uz","vn"],"type":"string","description":"ISO country code"},"receipt":{"type":"boolean","default":false,"description":"Default false. When true, a paid success includes an Ed25519 answer receipt (kind answer_receipt) at no extra USDC. Unpaid 402 and free refusals do not include one. Not a series certified extract (GET /v1/certified/{country}/{series} at $0.10; that SKU is not an MCP tool)."},"subdivision":{"type":"string","description":"Optional ISO 3166-2 region code (e.g. 'DE-BY') to apply that region's statutory holidays on top of the national calendar. Regions are listed under `subdivisions` by get_public_holidays. Unknown code is refused free with the list."}}},"output_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"basis":{},"error":{"description":"Present on a free refusal or error; no charge"},"status":{"type":"string","description":"Answer status, e.g. computed or an honest no-answer status"},"country":{"type":"string"},"receipt":{"description":"Ed25519 answer receipt when receipt=true on a paid success"},"question":{},"no_charge":{"type":"boolean"},"price_usd":{"type":"number"},"disclaimer":{},"how_to_pay":{"type":"array","items":{"type":"string"}},"provenance":{"description":"Cited official sources behind the answer"},"bind_series":{},"explanation":{},"label_basis":{"type":"object","properties":{"rules":{"type":"string"},"stale":{"type":"boolean"},"inputs":{"type":"array","items":{}},"source_type":{"type":["string","null"]},"rules_version":{"type":"string"},"coverage_reasons":{"type":"array","items":{"type":"string"}},"confidence_reasons":{"type":"array","items":{"type":"string"}},"verification_age_days":{"type":["number","null"]}},"description":"Inputs and the rule ids that produced the two labels","additionalProperties":{}},"x_next_bind":{},"http_endpoint":{"type":"string"},"coverage_label":{"enum":["ready","partial","gap"],"type":"string","description":"How much of the question is covered: ready = complete; partial = held with a disclosed limitation or default; gap = no number served. Rules at /label-rules"},"confidence_label":{"enum":["high","medium","low"],"type":"string","description":"Evidence verdict derived from source type, verification age and the stale flag (answers: the weakest series read). Rules at /label-rules"},"payment_required":{"type":"boolean","description":"true when the call needs payment; how_to_pay explains x402 or card"}},"description":"Working-day count over a range with holidays hit","additionalProperties":{}},"annotations":{"title":"Count Working Days","readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T15:02:05.489Z"},{"name":"get_calendar","title":null,"description":"FREE, unmetered. GET /v1/calendar for this brand's continent. Optional country (ISO 3166-1 alpha-2) and series. Derives reverify_by from last_confirmed + update_cycle_days (the same window that sets stale) and, only when current.effective_to is a non-empty string, next_effective_known with basis effective_to. status unknown omits that date. Never parses notes. Does not invent MPC, budget, or wage-review dates. next_effective_known is the recorded end of the current value, not a promised gazette event. A 402 is a gate bug — do not pay. Past changes stay on get_changes.","input_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"series":{"type":"string","description":"Optional series id (for example policy-rate). Omit for every series. A valid country with no match stays free."},"country":{"type":"string","description":"Optional ISO 3166-1 alpha-2. Omit for every series on this brand's continent. Unknown to the catalog is 404 free. Not two letters is 400 free."}}},"output_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"as_of":{},"brand":{},"count":{"type":"number"},"error":{"description":"Present on a free refusal or error; no charge"},"entries":{"type":"array","items":{}},"no_charge":{"type":"boolean"},"price_usd":{"type":"number"},"disclaimer":{},"how_to_pay":{"type":"array","items":{"type":"string"}},"bind_series":{},"explanation":{},"x_next_bind":{},"http_endpoint":{"type":"string"},"payment_required":{"type":"boolean","description":"true when the call needs payment; how_to_pay explains x402 or card"}},"description":"Derived reverify_by and next_effective_known dates","additionalProperties":{}},"annotations":{"title":"Get Compliance Calendar","readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T15:02:05.489Z"},{"name":"get_changes","title":null,"description":"FREE unmetered change + freshness feed. After any paid series or\nanswer call, call this before you assume the cached value is still the\nlaw. Returns every series whose current value took effect on or after\n`since` (default last 30 days), newest first, each with last_confirmed\nand stale, PLUS a dataset-wide freshness summary: how many of the served\nseries were re-verified within 1/7/30/90 days, how many are past their\nwindow, and which single series has gone longest without a check.\nFreshness is checkable or it is marketing. Args: since? (YYYY-MM-DD).\nDo not re-pay get_series to discover a diff. For a push bind, use\nregister_alert (Register: $0 · Delivery after trial: $0.05). For a filing freeze of the current\nvalue, GET /v1/certified/{country}/{series} ($0.10).","input_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"since":{"type":"string","description":"YYYY-MM-DD. Omit for the server default (last 30 days). Free, unmetered."}}},"output_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"as_of":{},"error":{"description":"Present on a free refusal or error; no charge"},"since":{},"changes":{"type":"array","items":{}},"no_charge":{"type":"boolean"},"price_usd":{"type":"number"},"disclaimer":{},"how_to_pay":{"type":"array","items":{"type":"string"}},"bind_series":{},"explanation":{},"x_next_bind":{},"http_endpoint":{"type":"string"},"payment_required":{"type":"boolean","description":"true when the call needs payment; how_to_pay explains x402 or card"}},"description":"Value changes since a date","additionalProperties":{}},"annotations":{"title":"Get Recent Changes","readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T15:02:05.489Z"},{"name":"get_country_brief","title":null,"description":"PAID ($0.01). Country brief: every reference series we hold for one country (policy rate, VAT/GST, CPI, taxes, minimum wage, holidays...) in one call, each with value, unit, effective and last-confirmed dates, official source and confidence label. Cheaper than buying the series one by one. Pass api_key if you have one (card checkout at /pricing); otherwise the response explains how to pay via x402. After a 200, bind get_changes (free poll) or register_alert (HMAC push; Register: $0 · Delivery after trial: $0.05) on this series so a later gazette does not silently retire the value.","input_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["country"],"properties":{"api_key":{"type":"string","description":"API key"},"country":{"enum":["ae","bd","bh","cn","hk","id","il","in","iq","jo","jp","kr","kw","kz","lk","my","np","om","ph","pk","qa","sa","sg","th","tr","tw","uz","vn"],"type":"string","description":"ISO country code"}}},"output_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"name":{"type":"string"},"as_of":{"type":"string"},"error":{"description":"Present on a free refusal or error; no charge"},"series":{"type":"array","items":{"type":"object","properties":{"unit":{},"notes":{},"stale":{"type":"boolean"},"value":{},"series":{"type":"string"},"source":{},"country":{"type":"string"},"confidence":{},"label_basis":{"type":"object","properties":{"rules":{"type":"string"},"stale":{"type":"boolean"},"inputs":{"type":"array","items":{}},"source_type":{"type":["string","null"]},"rules_version":{"type":"string"},"coverage_reasons":{"type":"array","items":{"type":"string"}},"confidence_reasons":{"type":"array","items":{"type":"string"}},"verification_age_days":{"type":["number","null"]}},"description":"Inputs and the rule ids that produced the two labels","additionalProperties":{}},"coverage_label":{"enum":["ready","partial","gap"],"type":"string","description":"How much of the question is covered: ready = complete; partial = held with a disclosed limitation or default; gap = no number served. Rules at /label-rules"},"effective_from":{},"last_confirmed":{},"confidence_label":{"enum":["high","medium","low"],"type":"string","description":"Evidence verdict derived from source type, verification age and the stale flag (answers: the weakest series read). Rules at /label-rules"}},"additionalProperties":{}}},"country":{"type":"string"},"no_charge":{"type":"boolean"},"price_usd":{"type":"number"},"disclaimer":{},"how_to_pay":{"type":"array","items":{"type":"string"}},"bind_series":{},"explanation":{},"x_next_bind":{},"series_count":{"type":"number"},"http_endpoint":{"type":"string"},"payment_required":{"type":"boolean","description":"true when the call needs payment; how_to_pay explains x402 or card"}},"description":"Every series for one country, each cited","additionalProperties":{}},"annotations":{"title":"Get Country Brief","readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T15:02:05.489Z"},{"name":"get_filing_deadlines","title":"Statutory filing deadlines","description":"PAID ($0.003, same as any series). Recurring statutory tax deadlines for a country — VAT/GST returns and payments, PAYE/payroll withholding remittances, corporate income tax returns and provisional/instalment payments — as RULES, each cited to the official source with the verbatim phrase that states it, plus the actual DUE DATES in a window, rolled for the country's weekend and national public holidays (every skipped day is listed). Where a rule's source does not say which way a weekend deadline moves, the date is flagged roll_unverified rather than guessed. Countries or taxes we could not verify are returned as a free coverage_gap with reasons, never invented. Pass year_end (MM-DD) to re-anchor corporate-tax rules on the company's own accounting year end. The HTML page /{country}/filing-deadlines shows the rules free. Every JP series is free to try. After a 200, bind get_changes (free poll) or register_alert (HMAC push; Register: $0 · Delivery after trial: $0.05) on this series so a later gazette does not silently retire the value.","input_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["country"],"properties":{"to":{"type":"string","description":"Window end, YYYY-MM-DD. Default from + 365 days; at most 400 days after from"},"tax":{"enum":["vat","paye","cit"],"type":"string","description":"Only this tax's rules and dates"},"from":{"type":"string","description":"Window start, YYYY-MM-DD. Default today"},"api_key":{"type":"string","description":"API key (bypasses x402; metered for invoicing)"},"country":{"enum":["ae","bd","bh","cn","hk","id","il","in","iq","jo","jp","kr","kw","kz","lk","my","np","om","ph","pk","qa","sa","sg","th","tr","tw","uz","vn"],"type":"string","description":"ISO country code"},"year_end":{"type":"string","description":"Company accounting year end, MM-DD (e.g. 06-30). Applies to rules marked year_end_variable"}}},"output_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"gaps":{"type":"array","items":{"type":"object","required":["tax","reason"],"properties":{"tax":{"type":"string"},"reason":{"type":"string"}},"additionalProperties":false}},"unit":{},"error":{"description":"Present on a free refusal or error; no charge"},"notes":{},"stale":{"type":"boolean"},"value":{"type":"array","items":{"type":"object","required":["key","tax","obligation","label","frequency","due","roll","source"],"properties":{"due":{},"key":{"type":"string"},"tax":{"enum":["vat","paye","cit"],"type":"string"},"roll":{},"label":{"type":"string"},"source":{},"frequency":{"type":"string"},"obligation":{"type":"string"}},"additionalProperties":{}},"description":"The rules. Each carries its own source {name, url, anchor} and last_confirmed"},"series":{"type":"string"},"source":{},"status":{"type":"string","description":"On a coverage gap: researched_no_verified_rule or not_yet_researched"},"country":{"type":"string"},"due_dates":{"type":"object","required":["window","count","occurrences","caveats"],"properties":{"count":{"type":"number"},"window":{"type":"object","required":["from","to"],"properties":{"to":{"type":"string"},"from":{"type":"string"}},"additionalProperties":false},"caveats":{"type":"array","items":{"type":"string"}},"occurrences":{"type":"array","items":{"type":"object","required":["rule","tax","statutory_date","due_date","rolled","roll_rule","adjustments","holiday_calendar_covered"],"properties":{"tax":{"type":"string"},"rule":{"type":"string"},"rolled":{"type":"boolean"},"due_date":{"type":"string"},"roll_rule":{"type":"string"},"adjustments":{"type":"array","items":{}},"statutory_date":{"type":"string"},"holiday_calendar_covered":{"type":"boolean"}},"additionalProperties":{}}}},"description":"Computed occurrences in the window, sorted by due_date","additionalProperties":{}},"no_charge":{"type":"boolean"},"price_usd":{"type":"number"},"confidence":{},"disclaimer":{},"how_to_pay":{"type":"array","items":{"type":"string"}},"bind_series":{},"explanation":{},"label_basis":{"type":"object","properties":{"rules":{"type":"string"},"stale":{"type":"boolean"},"inputs":{"type":"array","items":{}},"source_type":{"type":["string","null"]},"rules_version":{"type":"string"},"coverage_reasons":{"type":"array","items":{"type":"string"}},"confidence_reasons":{"type":"array","items":{"type":"string"}},"verification_age_days":{"type":["number","null"]}},"description":"Inputs and the rule ids that produced the two labels","additionalProperties":{}},"x_next_bind":{},"coverage_gaps":{"type":"array","items":{"type":"object","required":["tax","reason"],"properties":{"tax":{"type":"string"},"reason":{"type":"string"}},"additionalProperties":false},"description":"Taxes in scope with no verified rule for this country, and why"},"http_endpoint":{"type":"string"},"coverage_label":{"enum":["ready","partial","gap"],"type":"string","description":"How much of the question is covered: ready = complete; partial = held with a disclosed limitation or default; gap = no number served. Rules at /label-rules"},"effective_from":{},"last_confirmed":{},"confidence_label":{"enum":["high","medium","low"],"type":"string","description":"Evidence verdict derived from source type, verification age and the stale flag (answers: the weakest series read). Rules at /label-rules"},"payment_required":{"type":"boolean","description":"true when the call needs payment; how_to_pay explains x402 or card"},"computed_disclaimer":{"type":"string"}},"description":"Statutory filing-deadline rules (each cited to its official source with a verbatim anchor) plus computed due dates rolled for weekends and public holidays; on a coverage gap, the per-tax reasons","additionalProperties":{}},"annotations":{"title":"Statutory filing deadlines","readOnlyHint":true,"openWorldHint":false,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T15:02:05.489Z"},{"name":"get_key_balance","title":null,"description":"FREE. Remaining allowance for an API key (free, card or metered): plan, quota, used, remaining, reset date and what the key covers. Never metered. Pass api_key, or send the key as the X-API-Key header on /mcp.","input_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"api_key":{"type":"string","description":"API key. Optional when sent as the X-API-Key header on /mcp."}}},"output_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"plan":{"type":"string"},"used":{"type":"number"},"error":{"description":"Present on a free refusal or error; no charge"},"quota":{"type":"number"},"covers":{"type":"string"},"no_charge":{"type":"boolean"},"price_usd":{"type":"number"},"remaining":{"type":"number"},"resets_on":{},"disclaimer":{},"how_to_pay":{"type":"array","items":{"type":"string"}},"bind_series":{},"explanation":{},"x_next_bind":{},"http_endpoint":{"type":"string"},"payment_required":{"type":"boolean","description":"true when the call needs payment; how_to_pay explains x402 or card"}},"description":"Allowance and usage for an API key","additionalProperties":{}},"annotations":{"title":"Get Key Balance","readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T15:02:05.489Z"},{"name":"get_public_holidays","title":null,"description":"FREE. Official public-holiday calendar for a supported country, including gazetted movable holidays, with the official government source cited. Some countries also carry sub-national calendars (e.g. the German Laender): the `subdivisions` field lists them, and passing `subdivision` (ISO 3166-2, e.g. 'DE-BY') returns the national calendar merged with that region's statutory days.","input_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["country"],"properties":{"country":{"enum":["ae","bd","bh","cn","hk","id","il","in","iq","jo","jp","kr","kw","kz","lk","my","np","om","ph","pk","qa","sa","sg","th","tr","tw","uz","vn"],"type":"string","description":"ISO country code"},"subdivision":{"type":"string","description":"Optional ISO 3166-2 region code (e.g. 'DE-BY'). Returns national + that region's statutory holidays, each tagged national/regional. Omit for the national calendar."}}},"output_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"unit":{},"error":{"description":"Present on a free refusal or error; no charge"},"notes":{},"stale":{"type":"boolean"},"value":{},"series":{"type":"string"},"source":{},"country":{"type":"string"},"no_charge":{"type":"boolean"},"price_usd":{"type":"number"},"confidence":{},"disclaimer":{},"how_to_pay":{"type":"array","items":{"type":"string"}},"bind_series":{},"explanation":{},"label_basis":{"type":"object","properties":{"rules":{"type":"string"},"stale":{"type":"boolean"},"inputs":{"type":"array","items":{}},"source_type":{"type":["string","null"]},"rules_version":{"type":"string"},"coverage_reasons":{"type":"array","items":{"type":"string"}},"confidence_reasons":{"type":"array","items":{"type":"string"}},"verification_age_days":{"type":["number","null"]}},"description":"Inputs and the rule ids that produced the two labels","additionalProperties":{}},"subdivision":{},"x_next_bind":{},"http_endpoint":{"type":"string"},"coverage_label":{"enum":["ready","partial","gap"],"type":"string","description":"How much of the question is covered: ready = complete; partial = held with a disclosed limitation or default; gap = no number served. Rules at /label-rules"},"effective_from":{},"last_confirmed":{},"confidence_label":{"enum":["high","medium","low"],"type":"string","description":"Evidence verdict derived from source type, verification age and the stale flag (answers: the weakest series read). Rules at /label-rules"},"payment_required":{"type":"boolean","description":"true when the call needs payment; how_to_pay explains x402 or card"},"available_subdivisions":{"type":"array","items":{"type":"string"}}},"description":"Holiday calendar series with cited source; with subdivision, merged national+regional days","additionalProperties":{}},"annotations":{"title":"Get Public Holidays","readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T15:02:05.489Z"},{"name":"get_public_holidays_worldwide","title":null,"description":"FREE with any API key, including the free key by email (https://asiaref.dev/free-key). Same as get_public_holidays, but for every country across all seven brands, not only Asian. Unmetered: never counts against the key's allowance. Pass api_key, or send the key as the X-API-Key header on /mcp.","input_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["country"],"properties":{"api_key":{"type":"string","description":"Any valid API key. Optional when the key is sent as the X-API-Key header on /mcp."},"country":{"enum":["ae","ao","ar","at","au","bb","bd","be","bf","bg","bh","bj","bo","br","bs","bw","bz","ca","cd","cf","cg","ch","ci","cl","cm","cn","co","cr","cy","cz","de","dk","do","dz","ec","ee","eg","es","et","eu","fi","fj","fr","ga","gb","gh","gq","gr","gt","gy","hk","hn","hr","hu","id","ie","il","in","iq","is","it","jm","jo","jp","ke","kr","kw","kz","lk","ls","lt","lu","lv","ma","ml","mt","mu","mx","my","mz","na","ne","ng","ni","nl","no","np","nz","om","pa","pe","pg","ph","pk","pl","pt","py","qa","ro","rs","rw","sa","sb","se","sg","si","sk","sn","sv","sz","td","tg","th","tn","to","tr","tt","tw","tz","ua","ug","us","uy","uz","vn","vu","ws","za","zm"],"type":"string","description":"ISO country code, any covered country"},"subdivision":{"type":"string","description":"Optional ISO 3166-2 region code (e.g. 'DE-BY'). Returns national + that region's statutory holidays, each tagged national/regional. Omit for the national calendar."}}},"output_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"unit":{},"error":{"description":"Present on a free refusal or error; no charge"},"notes":{},"stale":{"type":"boolean"},"value":{},"series":{"type":"string"},"source":{},"country":{"type":"string"},"no_charge":{"type":"boolean"},"price_usd":{"type":"number"},"confidence":{},"disclaimer":{},"how_to_pay":{"type":"array","items":{"type":"string"}},"bind_series":{},"explanation":{},"label_basis":{"type":"object","properties":{"rules":{"type":"string"},"stale":{"type":"boolean"},"inputs":{"type":"array","items":{}},"source_type":{"type":["string","null"]},"rules_version":{"type":"string"},"coverage_reasons":{"type":"array","items":{"type":"string"}},"confidence_reasons":{"type":"array","items":{"type":"string"}},"verification_age_days":{"type":["number","null"]}},"description":"Inputs and the rule ids that produced the two labels","additionalProperties":{}},"subdivision":{},"x_next_bind":{},"http_endpoint":{"type":"string"},"coverage_label":{"enum":["ready","partial","gap"],"type":"string","description":"How much of the question is covered: ready = complete; partial = held with a disclosed limitation or default; gap = no number served. Rules at /label-rules"},"effective_from":{},"last_confirmed":{},"confidence_label":{"enum":["high","medium","low"],"type":"string","description":"Evidence verdict derived from source type, verification age and the stale flag (answers: the weakest series read). Rules at /label-rules"},"payment_required":{"type":"boolean","description":"true when the call needs payment; how_to_pay explains x402 or card"},"available_subdivisions":{"type":"array","items":{"type":"string"}}},"description":"Holiday calendar series with cited source; with subdivision, merged national+regional days","additionalProperties":{}},"annotations":{"title":"Get Public Holidays Worldwide","readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T15:02:05.489Z"},{"name":"get_series","title":null,"description":"PAID ($0.003). Current value of a reference series — e.g. series=policy-rate, vat, minimum-wage. Every value carries its official source citation, effective date, last-confirmed date and staleness flag. Pass api_key if you have one (instant card checkout at /pricing); otherwise the response explains how to pay via x402. Every JP series is free to try. After a 200, bind get_changes (free poll) or register_alert (HMAC push; Register: $0 · Delivery after trial: $0.05) on this series so a later gazette does not silently retire the value.","input_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["country","series"],"properties":{"series":{"type":"string","description":"Series id, e.g. policy-rate, vat, minimum-wage"},"api_key":{"type":"string","description":"API key (bypasses x402; metered for invoicing)"},"country":{"enum":["ae","bd","bh","cn","hk","id","il","in","iq","jo","jp","kr","kw","kz","lk","my","np","om","ph","pk","qa","sa","sg","th","tr","tw","uz","vn"],"type":"string","description":"ISO country code"}}},"output_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"unit":{},"error":{"description":"Present on a free refusal or error; no charge"},"notes":{},"stale":{"type":"boolean"},"value":{},"series":{"type":"string"},"source":{},"country":{"type":"string"},"no_charge":{"type":"boolean"},"price_usd":{"type":"number"},"confidence":{},"disclaimer":{},"how_to_pay":{"type":"array","items":{"type":"string"}},"bind_series":{},"explanation":{},"label_basis":{"type":"object","properties":{"rules":{"type":"string"},"stale":{"type":"boolean"},"inputs":{"type":"array","items":{}},"source_type":{"type":["string","null"]},"rules_version":{"type":"string"},"coverage_reasons":{"type":"array","items":{"type":"string"}},"confidence_reasons":{"type":"array","items":{"type":"string"}},"verification_age_days":{"type":["number","null"]}},"description":"Inputs and the rule ids that produced the two labels","additionalProperties":{}},"x_next_bind":{},"http_endpoint":{"type":"string"},"coverage_label":{"enum":["ready","partial","gap"],"type":"string","description":"How much of the question is covered: ready = complete; partial = held with a disclosed limitation or default; gap = no number served. Rules at /label-rules"},"effective_from":{},"last_confirmed":{},"confidence_label":{"enum":["high","medium","low"],"type":"string","description":"Evidence verdict derived from source type, verification age and the stale flag (answers: the weakest series read). Rules at /label-rules"},"payment_required":{"type":"boolean","description":"true when the call needs payment; how_to_pay explains x402 or card"}},"description":"Current value of one series with source, effective date, last_confirmed and stale flag","additionalProperties":{}},"annotations":{"title":"Get Series Value","readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T15:02:05.489Z"},{"name":"get_series_history","title":null,"description":"PAID ($0.003). Historical values of a reference series with effective date ranges, optionally filtered by from/to (YYYY-MM-DD). Pass api_key if you have one (instant card checkout at /pricing); otherwise the response explains how to pay via x402. Every JP series is free to try. After a 200, bind get_changes (free poll) or register_alert (HMAC push; Register: $0 · Delivery after trial: $0.05) on this series so a later gazette does not silently retire the value.","input_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["country","series"],"properties":{"to":{"type":"string","description":"Latest effective date, YYYY-MM-DD"},"from":{"type":"string","description":"Earliest effective date, YYYY-MM-DD"},"series":{"type":"string","description":"Series id"},"api_key":{"type":"string","description":"API key"},"country":{"enum":["ae","bd","bh","cn","hk","id","il","in","iq","jo","jp","kr","kw","kz","lk","my","np","om","ph","pk","qa","sa","sg","th","tr","tw","uz","vn"],"type":"string","description":"ISO country code"}}},"output_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"error":{"description":"Present on a free refusal or error; no charge"},"stale":{"type":"boolean"},"series":{"type":"string"},"country":{"type":"string"},"entries":{"type":"array","items":{"type":"object","properties":{"unit":{},"notes":{},"stale":{"type":"boolean"},"value":{},"series":{"type":"string"},"source":{},"country":{"type":"string"},"confidence":{},"label_basis":{"type":"object","properties":{"rules":{"type":"string"},"stale":{"type":"boolean"},"inputs":{"type":"array","items":{}},"source_type":{"type":["string","null"]},"rules_version":{"type":"string"},"coverage_reasons":{"type":"array","items":{"type":"string"}},"confidence_reasons":{"type":"array","items":{"type":"string"}},"verification_age_days":{"type":["number","null"]}},"description":"Inputs and the rule ids that produced the two labels","additionalProperties":{}},"coverage_label":{"enum":["ready","partial","gap"],"type":"string","description":"How much of the question is covered: ready = complete; partial = held with a disclosed limitation or default; gap = no number served. Rules at /label-rules"},"effective_from":{},"last_confirmed":{},"confidence_label":{"enum":["high","medium","low"],"type":"string","description":"Evidence verdict derived from source type, verification age and the stale flag (answers: the weakest series read). Rules at /label-rules"}},"additionalProperties":{}}},"no_charge":{"type":"boolean"},"price_usd":{"type":"number"},"disclaimer":{},"how_to_pay":{"type":"array","items":{"type":"string"}},"bind_series":{},"explanation":{},"label_basis":{"type":"object","properties":{"rules":{"type":"string"},"stale":{"type":"boolean"},"inputs":{"type":"array","items":{}},"source_type":{"type":["string","null"]},"rules_version":{"type":"string"},"coverage_reasons":{"type":"array","items":{"type":"string"}},"confidence_reasons":{"type":"array","items":{"type":"string"}},"verification_age_days":{"type":["number","null"]}},"description":"Inputs and the rule ids that produced the two labels","additionalProperties":{}},"x_next_bind":{},"http_endpoint":{"type":"string"},"coverage_label":{"enum":["ready","partial","gap"],"type":"string","description":"How much of the question is covered: ready = complete; partial = held with a disclosed limitation or default; gap = no number served. Rules at /label-rules"},"confidence_label":{"enum":["high","medium","low"],"type":"string","description":"Evidence verdict derived from source type, verification age and the stale flag (answers: the weakest series read). Rules at /label-rules"},"payment_required":{"type":"boolean","description":"true when the call needs payment; how_to_pay explains x402 or card"}},"description":"Historical entries of one series; top-level labels describe the current value, and each entry carries its own","additionalProperties":{}},"annotations":{"title":"Get Series History","readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T15:02:05.489Z"},{"name":"get_snapshot","title":null,"description":"PAID ($0.02). Snapshot of every series for every country in one call. Pass api_key if you have one (instant card checkout at /pricing); otherwise the response explains how to pay via x402. Every JP series is free to try. After a 200, bind get_changes (free poll) or register_alert (HMAC push; Register: $0 · Delivery after trial: $0.05) on this series so a later gazette does not silently retire the value.","input_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"api_key":{"type":"string","description":"API key"}}},"output_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"error":{"description":"Present on a free refusal or error; no charge"},"result":{"type":"array","items":{"type":"object","properties":{"series":{"type":"array","items":{"type":"object","properties":{"unit":{},"notes":{},"stale":{"type":"boolean"},"value":{},"series":{"type":"string"},"source":{},"country":{"type":"string"},"confidence":{},"label_basis":{"type":"object","properties":{"rules":{"type":"string"},"stale":{"type":"boolean"},"inputs":{"type":"array","items":{}},"source_type":{"type":["string","null"]},"rules_version":{"type":"string"},"coverage_reasons":{"type":"array","items":{"type":"string"}},"confidence_reasons":{"type":"array","items":{"type":"string"}},"verification_age_days":{"type":["number","null"]}},"description":"Inputs and the rule ids that produced the two labels","additionalProperties":{}},"coverage_label":{"enum":["ready","partial","gap"],"type":"string","description":"How much of the question is covered: ready = complete; partial = held with a disclosed limitation or default; gap = no number served. Rules at /label-rules"},"effective_from":{},"last_confirmed":{},"confidence_label":{"enum":["high","medium","low"],"type":"string","description":"Evidence verdict derived from source type, verification age and the stale flag (answers: the weakest series read). Rules at /label-rules"}},"additionalProperties":{}}},"country":{"type":"string"}},"additionalProperties":{}},"description":"One entry per country; every series value carries confidence_label, coverage_label and label_basis"},"countries":{},"no_charge":{"type":"boolean"},"price_usd":{"type":"number"},"disclaimer":{},"how_to_pay":{"type":"array","items":{"type":"string"}},"bind_series":{},"explanation":{},"x_next_bind":{},"http_endpoint":{"type":"string"},"payment_required":{"type":"boolean","description":"true when the call needs payment; how_to_pay explains x402 or card"}},"description":"Every series for every country of this brand","additionalProperties":{}},"annotations":{"title":"Get Full Snapshot","readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T15:02:05.489Z"},{"name":"is_business_day","title":"Is it a business day?","description":"FREE, unmetered. Is this date a business day in this country? Returns is_business_day, the reason (weekend, public_holiday, makeup_workday…), the holiday names, and the next and previous business day. Uses the country's national public-holiday calendar and its statutory weekend rule (Gulf Friday+Saturday, Israel Saturday-only, India 2nd/4th Saturdays, Nepal's 2026 change, China's multi-day breaks and make-up working days). A date in a year whose holidays we do not hold is refused with error year_not_held and the years_held list; it is never computed from weekends alone. A statutory holiday whose date is not yet fixed is refused as holiday_date_pending. Regional (sub-national) holidays are not applied.","input_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["country","date"],"properties":{"date":{"type":"string","description":"Date to classify, YYYY-MM-DD"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code, e.g. 'za', 'ae', 'in'. Every country we hold a holiday calendar for is accepted on every brand, not only this brand's region."}}},"output_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"date":{"type":"string"},"free":{"type":"boolean"},"year":{"type":"number","description":"On year_not_held: the year we do not hold"},"basis":{},"error":{"description":"Present on a free refusal or error; no charge"},"price":{"type":"string"},"reason":{"enum":["business_day","weekend","public_holiday","weekend_and_public_holiday","makeup_workday"],"type":"string"},"caveats":{"type":"array","items":{"type":"string"}},"country":{"type":"string"},"reached":{"type":"string","description":"On a refusal: the first date the calculation could not classify"},"weekday":{"type":"string"},"weekend":{"description":"Weekend days applied, the basis of that rule, and any dated or sub-national note"},"calendar":{"description":"Holiday calendar used: years_held, source, last_confirmed, stale"},"no_charge":{"type":"boolean"},"price_usd":{"type":"number"},"disclaimer":{},"how_to_pay":{"type":"array","items":{"type":"string"}},"years_held":{"type":"array","items":{"type":"number"},"description":"On year_not_held: the years whose holidays we do hold"},"bind_series":{},"explanation":{},"x_next_bind":{},"country_name":{"type":"string"},"http_endpoint":{"type":"string"},"is_weekend_day":{"type":"boolean"},"is_business_day":{"type":"boolean"},"public_holidays":{"type":"array","items":{"type":"string"}},"what_you_can_do":{"type":"array","items":{"type":"string"}},"payment_required":{"type":"boolean","description":"true when the call needs payment; how_to_pay explains x402 or card"},"next_business_day":{"description":"{date, weekday}, or date null with why_unknown when it falls outside the held calendar"},"previous_business_day":{}},"description":"Business-day verdict for one date, with reason, holiday names and the neighbouring business days","additionalProperties":{}},"annotations":{"readOnlyHint":true,"openWorldHint":false,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T15:02:05.489Z"},{"name":"list_series","title":null,"description":"FREE. Catalog of all asiaref reference-data series: supported countries, series ids, descriptions, freshness metadata and per-series URLs. Call this first to discover what data exists. Paid answer tools accept receipt=true (included in the answer price, no extra USDC) and, on a paid success, return an Ed25519 answer receipt (kind answer_receipt). That receipt is not a series certified extract and is not legal advice. Series certified extracts are GET /v1/certified/{country}/{series} at $0.10 and are not an MCP tool. Verify a receipt with verify_answer_receipt (free, public key only) against /certified/public-key. get_changes is free. get_calendar is free. register_alert registration is free.","input_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"detail":{"type":"boolean","description":"Default false. Without country, false returns a compact index (country -> series ids). true returns the full catalog, which is large."},"country":{"type":"string","description":"Optional ISO country code. Returns full per-series metadata (source, freshness, bands) for that country only."}}},"output_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"note":{"type":"string"},"error":{"description":"Present on a free refusal or error; no charge"},"countries":{"type":"array","items":{},"description":"Country entries ({country, name, series}); on an unknown-country refusal, the list of valid codes"},"no_charge":{"type":"boolean"},"price_usd":{"type":"number"},"disclaimer":{},"how_to_pay":{"type":"array","items":{"type":"string"}},"bind_series":{},"explanation":{},"x_next_bind":{},"http_endpoint":{"type":"string"},"payment_required":{"type":"boolean","description":"true when the call needs payment; how_to_pay explains x402 or card"}},"description":"Catalog: brand metadata plus countries[] (compact: country, name, series ids; with country or detail: full per-series metadata including confidence_label and coverage_label)","additionalProperties":{}},"annotations":{"title":"List Reference Series","readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T15:02:05.489Z"},{"name":"register_alert","title":null,"description":"Bind a webhook so the next gazette does not silently stale a value\nyou already paid for. REGISTERING IS FREE. Register: $0 · Delivery after trial: $0.05. First 3\ndeliveries are free; later deliveries are $0.05 and refunded if the webhook\nfails to send. HMAC-SHA256 signed. Two watch types on the same call:\n  • series: [\"za/vat-registration-threshold\", \"ke/*\", \"*\"] → series.changed\n    when the served value or its effective date moves. On usaref those\n    watches are statutory (minimum-wage, income-tax, statutory-interest,\n    sales-tax, public-holidays), not a FRED-macro subscription.\n  • sources: [\"<exact official source.url>\"] → source.changed when the\n    document BYTES change (old/new sha256 + citing series). Bytes ≠ value.\n    Value changes arrive as series.changed. Unknown URLs refuse free\n    (source_not_fingerprinted).\nMax 20 series + 20 sources. Required: url. Optional: api_key stored on the\nsubscription to fund deliveries after the trial. This call does not meter\nthat key. Prefer this over polling get_changes if you are a long-running\nagent. This is retention, not a new data product.","input_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["url"],"properties":{"url":{"type":"string","description":"Webhook endpoint that will receive HMAC-SHA256 signed events"},"series":{"type":"array","items":{"type":"string"},"maxItems":20,"description":"Value watches, e.g. [\"za/vat-registration-threshold\", \"ke/*\", \"*\"]"},"api_key":{"type":"string","description":"Optional prepaid key stored on the subscription to fund deliveries after the trial. This call does not meter it."},"sources":{"type":"array","items":{"type":"string"},"maxItems":20,"description":"Exact official-source URLs from a series source.url. Unknown URLs are refused free."}}},"output_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"error":{"description":"Present on a free refusal or error; no charge"},"no_charge":{"type":"boolean"},"price_usd":{"type":"number"},"disclaimer":{},"how_to_pay":{"type":"array","items":{"type":"string"}},"bind_series":{},"explanation":{},"x_next_bind":{},"http_endpoint":{"type":"string"},"payment_required":{"type":"boolean","description":"true when the call needs payment; how_to_pay explains x402 or card"}},"description":"Alert subscription result (id, secret, trial) or refusal","additionalProperties":{}},"annotations":{"title":"Register Change Alert","readOnlyHint":false,"openWorldHint":true,"idempotentHint":false,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T15:02:05.489Z"},{"name":"settlement_date","title":null,"description":"PAID ($0.02). Settlement/value date: the date n business days after a trade date, computed on the INTERSECTION of the calendars you name, with a per-day trail showing every skipped day and why, on which calendar. Supply business_days for a cycle you are trading under, or market + instrument_class to have a settlement cycle applied that we cite to its primary source (e.g. US equities T+1 under 17 CFR 240.15c6-1(a); UK gilts T+1 by DMO convention, which is NOT the T+2 equity cycle; Japan equities T+2 but JGBs T+1). Calendars are NATIONAL statutory holiday calendars with researched statutory weekend rules (Israel Saturday-only, Gulf Friday+Saturday, India Sundays plus the 2nd and 4th Saturday), NOT CSD or exchange calendars — each response states the basis and any known divergence. Use 'eu.t2' for the euro cash leg. We refuse FREE rather than guess: beyond published calendar coverage, no cited cycle for the instrument (government bonds never inherit an equity cycle), a cycle not in force on the trade date, or FX spot value dates. Free companion: GET /settlement-conventions. Optional receipt (boolean, default false): on a paid success, include an Ed25519 answer receipt at no extra USDC. An answer receipt is not a series certified extract (GET /v1/certified/{country}/{series} is $0.10 and is not an MCP tool) and is not legal advice. Verify with verify_answer_receipt against /certified/public-key.","input_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["trade_date","calendars"],"properties":{"market":{"type":"string","description":"ISO country of the market whose cited cycle should apply (with instrument_class)"},"api_key":{"type":"string","description":"API key (bypasses x402; metered for invoicing)"},"receipt":{"type":"boolean","default":false,"description":"Default false. When true, a paid success includes an Ed25519 answer receipt (kind answer_receipt) at no extra USDC. Unpaid 402 and free refusals do not include one. Not a series certified extract (GET /v1/certified/{country}/{series} at $0.10; that SKU is not an MCP tool)."},"calendars":{"type":"array","items":{"type":"string"},"maxItems":4,"minItems":1,"description":"Calendar ids to intersect: two-letter ISO country codes, plus 'eu.t2' for the euro cash leg"},"trade_date":{"type":"string","description":"Trade/reference date, YYYY-MM-DD. Day 0: never counted, never rolled."},"business_days":{"type":"integer","maximum":30,"minimum":0,"description":"The offset you are trading under (T+n)"},"instrument_class":{"enum":["cash_equity","etf","corporate_bond","government_bond","tbill","repo","primary_issuance","other"],"type":"string","description":"Instrument class — a government bond never inherits an equity cycle"}}},"output_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"basis":{},"error":{"description":"Present on a free refusal or error; no charge"},"status":{"type":"string","description":"Answer status, e.g. computed or an honest no-answer status"},"country":{"type":"string"},"receipt":{"description":"Ed25519 answer receipt when receipt=true on a paid success"},"question":{},"no_charge":{"type":"boolean"},"price_usd":{"type":"number"},"disclaimer":{},"how_to_pay":{"type":"array","items":{"type":"string"}},"provenance":{"description":"Cited official sources behind the answer"},"bind_series":{},"explanation":{},"label_basis":{"type":"object","properties":{"rules":{"type":"string"},"stale":{"type":"boolean"},"inputs":{"type":"array","items":{}},"source_type":{"type":["string","null"]},"rules_version":{"type":"string"},"coverage_reasons":{"type":"array","items":{"type":"string"}},"confidence_reasons":{"type":"array","items":{"type":"string"}},"verification_age_days":{"type":["number","null"]}},"description":"Inputs and the rule ids that produced the two labels","additionalProperties":{}},"x_next_bind":{},"http_endpoint":{"type":"string"},"coverage_label":{"enum":["ready","partial","gap"],"type":"string","description":"How much of the question is covered: ready = complete; partial = held with a disclosed limitation or default; gap = no number served. Rules at /label-rules"},"confidence_label":{"enum":["high","medium","low"],"type":"string","description":"Evidence verdict derived from source type, verification age and the stale flag (answers: the weakest series read). Rules at /label-rules"},"payment_required":{"type":"boolean","description":"true when the call needs payment; how_to_pay explains x402 or card"}},"description":"Settlement date on intersected calendars with per-day trail","additionalProperties":{}},"annotations":{"title":"Settlement Date","readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T15:02:05.489Z"},{"name":"validate_tax_id","title":null,"description":"PAID ($0.003). Offline format and check-digit validation of a business tax ID or VAT number for one country of this brand: valid/invalid, normalised form, id type, check level (checksum only where the authority publishes the algorithm) and why it failed, with official sources. Does not confirm registration; follow official_lookup for that. Countries without a sourced rule answer free with status 'unknown'. Pass api_key if you have one; otherwise the response explains how to pay via x402. After a 200, bind get_changes (free poll) or register_alert (HMAC push; Register: $0 · Delivery after trial: $0.05) on this series so a later gazette does not silently retire the value.","input_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["country","id"],"properties":{"id":{"type":"string","maxLength":40,"minLength":1,"description":"The tax ID / VAT number as written; spaces, dots, dashes and a VAT country prefix are accepted"},"api_key":{"type":"string","description":"API key"},"country":{"enum":["ae","bd","bh","cn","hk","id","il","in","iq","jo","jp","kr","kw","kz","lk","my","np","om","ph","pk","qa","sa","sg","th","tr","tw","uz","vn"],"type":"string","description":"ISO country code"}}},"output_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"as_of":{"type":"string"},"error":{"description":"Present on a free refusal or error; no charge"},"valid":{"type":["boolean","null"]},"reason":{"type":"string"},"status":{"type":"string"},"country":{"type":"string"},"id_type":{"type":"string"},"sources":{"type":"array","items":{}},"no_charge":{"type":"boolean"},"price_usd":{"type":"number"},"disclaimer":{},"how_to_pay":{"type":"array","items":{"type":"string"}},"normalised":{"type":["string","null"]},"bind_series":{},"check_level":{"type":"string"},"explanation":{},"reason_code":{"type":["string","null"]},"x_next_bind":{},"http_endpoint":{"type":"string"},"payment_required":{"type":"boolean","description":"true when the call needs payment; how_to_pay explains x402 or card"}},"description":"Tax-ID / VAT-number validation verdict with normalised form, reason and sources","additionalProperties":{}},"annotations":{"title":"Validate Tax ID / VAT Number","readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T15:02:05.489Z"},{"name":"verify_answer_receipt","title":null,"description":"FREE. Verify an answer receipt (kind answer_receipt) with the Ed25519 public key only. Pass the receipt object or its canonical JSON, signature_value when the signature is not inside the receipt, and public_key_pem to verify offline. If public_key_pem is omitted, the tool may GET signature.public_key (/certified/public-key) and read public_key_pem. Never send a private key. A valid signature shows this service issued that exact receipt. It does not turn the receipt into a series certified extract (GET /v1/certified/{country}/{series} at $0.10, not an MCP tool) and it is not legal advice. Same key and canonical-JSON rule as /certified/public-key.","input_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","required":["receipt"],"properties":{"receipt":{"anyOf":[{"type":"string"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}],"description":"Answer receipt object (signature may be nested) or the canonical JSON of that object. A canonical JSON string of the signed body (signature omitted) is accepted when signature_value is also passed."},"public_key_pem":{"type":"string","description":"SPKI public key PEM from GET /certified/public-key (field public_key_pem). Required for offline verify. A private key PEM is refused."},"public_key_url":{"type":"string","description":"Optional GET /certified/public-key URL used only when public_key_pem is omitted. Ignored when the PEM is present."},"signature_value":{"type":"string","description":"Base64 Ed25519 signature. Required when the receipt object or JSON string does not already include signature.value. Overrides a nested signature when both are sent."}}},"output_schema":{"type":"object","$schema":"http://json-schema.org/draft-07/schema#","properties":{"ok":{"type":"boolean"},"why":{"type":"string"},"error":{"description":"Present on a free refusal or error; no charge"},"no_charge":{"type":"boolean"},"price_usd":{"type":"number"},"disclaimer":{},"how_to_pay":{"type":"array","items":{"type":"string"}},"bind_series":{},"explanation":{},"x_next_bind":{},"http_endpoint":{"type":"string"},"payment_required":{"type":"boolean","description":"true when the call needs payment; how_to_pay explains x402 or card"}},"description":"Receipt verification result","additionalProperties":{}},"annotations":{"title":"Verify Answer Receipt","readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-19T15:02:05.489Z"}],"next_cursor":null,"next_actions":[{"action":"get_connection","description":"Connection block to call these tools","href":"/v1/servers/dev.asiaref%2Freference-data/connection?target=mcpServers","arguments":{"name":"dev.asiaref/reference-data","target":"mcpServers"}},{"action":"get_server","description":"Full descriptor with trust and connectability","href":"/v1/servers/dev.asiaref%2Freference-data","arguments":{"name":"dev.asiaref/reference-data"}}]}