Documentation

Reference

MCP server & tools

OpenAccountants runs a Model Context Protocol server that any MCP-compatible AI agent can call for tax data, rate lookups, cross-border planning, and requests to OpenAccountants for professional work. The catalogue below is generated from the live server, so it always matches what the agent can actually call.

Connect

  • Endpoint: POST /api/mcp , Streamable HTTP, JSON-RPC 2.0 (server openaccountants-mcp v1.4.0).
  • Install: add the connector from /connect , it works with any MCP-compatible agent.
  • Auth: the tool catalogue is public. Eligible read tools allow limited guest use, then require a free account. Contribution and verification require sign-in and the relevant permissions; an unauthenticated gated request returns a 401 with an OAuth challenge. The access tier is shown per tool below.
  • Limits: 60 requests/minute per IP; 1,000 requests/day per signed-in account.

12 tools, generated from the server catalogue. Eligible read tools allow limited guest use, then require a free account. Contribution and verification require sign-in and the relevant permissions. * marks a required parameter.

Orientation

Scope a request and discover what's covered.

startLimited guest access

Call this first for any tax, VAT/GST, payroll or filing question about a country or US state, such as "how much tax will I pay in Spain", "do I need to register for VAT", "when is my tax return due", "is this deductible", "how is a freelancer or a company taxed in Germany", "sales tax in Texas" or "what changes if I move to Portugal". Pass the user's question as `intent` and the country or US state as `jurisdiction` ('DE', 'US-TX', 'Florida'). If no place is named, start infers one when the question makes it clear and says so in `jurisdiction_source`. Returns the skills to read next (`skills_to_load`, open each with get_skill), or every skill for the place for you to choose from (`menu`), or what is still needed, usually the country. Covers 190+ jurisdictions; where no skill exists yet it returns a research_brief naming the official sources. Called with an empty intent (no question yet), it returns the topics and jurisdictions covered.

ParameterTypeDescription
intent *stringThe user's question or goal, in English; an empty string when there is no question yet. If the user wrote in another language, translate it and keep the local tax term in brackets, e.g. 'VAT return for a freelancer (btw-aangifte zzp)', 'small business VAT exemption (Kleinunternehmer)'.
jurisdictionstringCountry or US state: ISO 2-letter code, US state code or name (e.g. 'MT', 'GB', 'US-CA', 'Florida'). Omit if the user named none; start infers it when the question makes it clear.
acting_asstringOptional. Who the user is: 'self' = a taxpayer handling their own taxes; 'client' = a professional working on a client's behalf. Infer it from the conversation; omit it if unclear.
reasonstringOne sentence, in the user's own words, on what they actually asked for here — captured only to improve routing. E.g. 'user sold ETH and wants to know what to report'. Optional but helpful.
taxpayer_typestringThe taxpayer's occupation, when known. Some return-prep workflows fork by it (an employee's Form 1040 is a different guide from a freelancer's). Pass it if the conversation already makes it clear; otherwise omit — start() only asks for it (status:'needs_clarification', needs:['taxpayer_type']) when the guides for this jurisdiction/intent genuinely split by occupation. 'employee' = W-2 wages only; 'self-employed' = freelance / 1099 / sole-proprietor; 'both' = employed AND self-employed; 'company' = a corporate entity. Don't guess — ask the user one short question if unsure.
list_jurisdictionsLimited guest access

Answers 'which countries do you cover?' or 'what is there for [country]?'. Returns every jurisdiction with published skills (countries as ISO 2, US states as US-XX, Canadian provinces) with skill counts, accountant-reviewed counts and the named lead accountant where there is one.

list_verifiersLimited guest access

Answers 'who reviewed this?' or 'which accountants are behind this?'. Returns the named licensed accountants who have signed off on OpenAccountants jurisdictions, with their credentials and the jurisdictions they cover.

ParameterTypeDescription
jurisdictionstringOptional ISO code filter — only return verifiers for this jurisdiction.

Skills: discovery & retrieval

Find and load the cited rules an answer is built from.

search_skillsLimited guest access

Find or browse skills. With a `query`, finds the skill for a specific tax topic by keyword: a deduction, form, regime or rule such as 'home office deduction', 'Schedule C', 'reverse charge', 'crypto capital gains' or 'Beckham regime'. Without a query, lists the skills for a jurisdiction, domain or role (for example every skill for 'MT', or every 'payroll' skill), each with its current approval label, 100 at a time (limit up to 200; page with offset and next_offset). Optionally limit either to one jurisdiction or domain. Returns skill slugs to open with get_skill. Set content_type='method' to find step-by-step methods (run them via start), each tagged accountant-reviewed or source-cited.

ParameterTypeDescription
querystringSearch term in English, e.g. 'home office deduction', 'crypto capital gains', 'reverse charge'. If the user wrote in another language, translate it and add the local term, e.g. 'VAT return btw-aangifte'. With content_type='method', a broad term (or the domain word) lists the available methods. Omit it to list (browse) the skills for a jurisdiction, domain or role instead.
jurisdictionstringOptional ISO 2-letter country code to limit the search
domainstringOptional accounting domain to limit the search (e.g. 'vat-gst', 'payroll', 'income-tax', 'financial-reporting', 'audit-assurance').
content_typestringWhat kind of skill to find. 'method' = step-by-step procedures you EXECUTE via start() (formerly 'workflows'); 'fact' or omitted = reference material (rates/thresholds/rules). A skill can be either or both.
rolestringOptional, when browsing: foundation, compute, orchestrator or reference.
limitintegerWhen browsing: skills per page (default 100, max 200).
offsetintegerWhen browsing: skills to skip; pass next_offset from the previous page.
get_skillLimited guest access

Open a skill by slug (from start, search_skills or search_rules) to answer the user's question. Returns the skill's rules and method, its quality tier, the named accountant where one reviewed it, a `section_index` of sections not inlined, and a provenance footer to keep with the answer. To read sections it did not inline, call it again with `sections` (their index numbers) or `all_sections: true`.

ParameterTypeDescription
slug *stringSkill slug, e.g. 'us-schedule-c-and-se-computation'
reasonstringOne sentence on WHY you're making this call, in the user's terms (for routing analysis only). Optional.
sectionsarrayOptional. Return these sections in full instead of the compact core: their `index` numbers from section_index.
all_sectionsbooleanOptional. true = return every section in full, with its heading and markdown.

Rules & citations

Query individual facts/rules and check a citation.

search_rulesLimited guest access

Look up tax rates, thresholds and rules in one or many jurisdictions, such as 'VAT rates in MT, IE and DE', 'income tax brackets for 2025' or 'rules mentioning reverse charge'. Returns a bundled markdown rule set plus each jurisdiction's official source (`official_source`). For one specific figure in one jurisdiction a skill is often more complete (search_skills then get_skill): a figure can sit in a skill without being a separate rule here, and then this returns related guidance instead. Entries tagged `GUIDANCE` are text, not values. Figures are not certified current: confirm each against `official_source` and prefer it when they disagree. By default returns all matching rules, each tagged with its verification status; status:'verified' excludes draft, needs_update and unsure rules; it still includes research-verified (source-cited) rules, so it does not mean accountant-reviewed. Set `facets: true` to get the valid filter values instead of rules; a call that finds nothing returns `valid_values` for the filter that missed.

ParameterTypeDescription
jurisdictionsarrayISO codes to include, e.g. ['MT','US-CA']. Omit for all jurisdictions.
domainsarrayAccounting domains, e.g. ['vat-gst','income-tax']. facets: true lists them.
rolesarraySkill roles: foundation | compute | orchestrator | reference.
block_typesarrayRule kinds to include. Default = all of these (framing prose + workflow steps are excluded).
statusesarrayVerification statuses to include. Default = all (each rule is tagged).
statusstringShorthand for `statuses`: 'verified' = accountant- + research-verified only. Default 'all'.
tax_yearintegerLimit to a tax year, e.g. 2025.
topicstringFilter by a fact topic.
textstringFree-text search over each rule's label, value, and citation.
limitintegerMax rules to return (default 200, max 500).
offsetintegerPagination offset — pass the previous response's next_offset.
reasonstringOne sentence on WHY you're making this call, in the user's terms (for routing analysis only). Optional.
facetsbooleantrue = return the valid filter values (jurisdictions, domains, roles, rule kinds, statuses, tax years, sample topics) instead of rules. Other arguments are ignored.

Rates & cross-border

Indexed numbers and multi-country planning.

Share & optional review

One channel: send feedback, or submit a request for professional help when the user asks. Hosted requests are logged under the Privacy Policy.

share_with_openaccountantsLimited guest access

Only when the user asks: sends their feedback, or their request for a person to check or do the work, to OpenAccountants. Two modes. (1) `note`: an anonymized note about the guidance (a gap, a workaround you needed, or via `skill_slug` a bug in a specific skill). Anonymize hard: no names, amounts, or PII. (2) `request_review: true`: the user wants a person at OpenAccountants to check or do the work. Typical requests: 'can an accountant check this?', 'can someone file this for me?', 'can someone do this for me?', 'I want an accountant', 'can I talk to a person?'. A question about whether your own answer is right is not such a request; re-check it yourself. Also requires `working_paper` (complete), `jurisdiction`, `scenario`, and `contact_email`. The request is saved with OpenAccountants and the team is notified; the response returns an OpenAccountants booking link. The call is free. The work itself is paid and is done by a licensed accountant in your country, under their own licence and their own agreement with you, with what is done and the fee agreed before anything starts. Never describe the work itself as free. Call at most once per user request; not as a routine closing step.

ParameterTypeDescription
note *stringAnonymized improvement note: what the guidance covered vs what you added or worked around and why, or a bug in a specific skill. No names, amounts, or PII.
skill_slugstringOptional: set when the note is feedback about a SPECIFIC skill, by its slug (e.g. 'us-sales-tax').
request_reviewbooleantrue only when the user has asked for a person (an accountant or OpenAccountants) to check their result, file it or do the work. Requires working_paper + jurisdiction + scenario + contact_email. Omit/false = just the note.
jurisdictionstringReview only: ISO code or slug for the user's tax jurisdiction (e.g. 'US-CA').
scenariostringReview only: brief description of the situation to review.
contact_emailstringReview only, REQUIRED when request_review: the user's email, so OpenAccountants can reply. Ask for it first.
contact_namestringReview only: the user's name.
tax_yearintegerReview only: tax year, if relevant.
working_paperstringReview only: the COMPLETE working paper markdown — every line item and assumption, not a summary.

Workflows

Procedures that use skills together.

Verification & contribution

Contribute new skills and verify facts inline (approved accountants).

Other tools

get_deadlinesLimited guest access

Filing and payment deadlines for a country or US state: 'when is my tax return due', 'when do I file VAT', 'when is the next instalment'. Returns upcoming dates and recurring filing rhythms (monthly VAT, quarterly instalments) from the OpenAccountants tax calendar. Signed-in users with a saved home jurisdiction can omit `jurisdiction`; the response marks `jurisdiction_source`.

ParameterTypeDescription
jurisdictionstringISO code, slug, or name ('MT', 'US-CA', 'Malta'). Optional for signed-in users with a saved home jurisdiction.
horizon_daysintegerHow far ahead to look (default 120, max 366).
get_quoteLimited guest access

Returns OpenAccountants' two plans and how to reach the team. Free: 100 questions a month for individuals and teams of 5 or fewer, with every skill and calculator. Team: for finance teams, accounting firms and larger organisations; no monthly cap, team accounts and custom builds into existing workflows, including agents on the ledger and tools the team already uses (Xero, QuickBooks, Sage, NetSuite and others); priced for each team, so no amount is returned. Also returns the pricing page, the contact link and an email address. OpenAccountants does not provide accounting services.

ParameterTypeDescription
jurisdictionstringOptional. The country the enquiry concerns (ISO code or name). Logged as demand; it does not change the result.
entity_typestringOptional. Who is asking. Logged.
servicesarrayOptional. What the team wants built or covered, e.g. vat, payroll, bookkeeping. Logged.
monthly_volumestringOptional. One line on size, e.g. team size, entities or transactions. Logged.
current_feestringOptional. What they pay today, if they said. Logged.
reasonstringOne sentence on WHY you're making this call, in the user's terms (for routing analysis only). Optional.
validate_vat_numberLimited guest access

Check live whether an EU VAT number is valid and registered, for example before applying a B2B reverse charge, zero-rating an intra-EU sale or onboarding a supplier. Queries the European Commission's VIES registry and returns the verdict plus the registered business name and address where the authority discloses them. Coverage: the 27 EU member states plus 'XI' (Northern Ireland); use 'EL' for Greece. Other countries, including the UK, are not supported yet: say live validation is not available there rather than guessing. If the registry is down the response says so.

ParameterTypeDescription
country_codestring2-letter EU member-state code of the VAT number, e.g. 'DE', 'IE', 'FR'. Use 'EL' for Greece and 'XI' for Northern Ireland. May be omitted if the country prefix is already part of vat_number.
vat_number *stringThe VAT number, with or without the country prefix and spaces, e.g. 'IE6388047V', 'IE 6388047V', or '6388047V'.
check_audit_exemptionLimited guest access

Answers 'does my company need an audit?' for a private limited company in Malta (MT, Article 185(2) micro thresholds) or the UK (GB, small-company thresholds before and after 6 April 2025). A deterministic check of turnover, balance sheet total and average employees. Returns 'exempt' | 'review' | 'audit_required' | 'cannot_determine', the per-threshold table, the rule citation, and whether a named accountant has confirmed the thresholds ('draft' = no accountant has confirmed them yet; say which). Pass prior_year figures: most regimes are two-consecutive-year tests, so without them a qualifying year returns 'review'. 'cannot_determine' is a valid outcome (unsupported jurisdiction, wrong currency, a shape needing judgment). Use the determination as returned, not thresholds from memory.

ParameterTypeDescription
jurisdiction *stringISO-style code. MT and GB supported today.
financial_year_end *stringISO date the financial year ends, e.g. '2025-12-31'.
turnover *numberRevenue/turnover for the year, in the jurisdiction's currency.
balance_sheet_total *numberTotal assets at the balance sheet date.
employees_average *numberAverage number of employees during the year.
currency *stringCurrency of the figures — must match the regime (EUR for MT, GBP for GB); convert first, never guess a rate.
entity_typestringOptional. 'private_ltd' (default), 'plc', 'branch'. Non-private shapes route to a human.
group_memberbooleanOptional. True if the company is part of a group — group thresholds need a reviewer, so this forces 'review'.
prior_yearobjectPrior-year figures for the two-consecutive-years test.
computeLimited guest access

Computes a tax figure with fixed, tested code instead of mental arithmetic. Use this for any figure an engine below covers; never compute that figure yourself. Pass only the facts the user gave, using the exact fact names for that engine; unknown facts and invalid types are refused. The engine applies its supported tax rules (allowances, standard deductions, bands, caps); some inputs must already be classified, as their descriptions explain. Returns the result, calculation_scope, every step, each rate used with its skill, section and quoted line, the engine's assumptions, skills_used with each skill's approval label (state it exactly as given) and a receipt id. Every engine takes tax_year and refuses a year it has no figures for. Facts marked * are required; an optional fact you leave out takes its default, and the answer states that as an assumption. Present a conditional calculation as conditional, state its scope and conditions, and ask for confirmation of defaulted facts that could change the answer. An ok result does not verify the user's facts or tax classification. If the engine returns missing_rule or needs_input, tell the user exactly what is missing or ask them for the fact. Never call again with guessed or altered facts to get a number, and never compute the figure yourself instead. If the calculator is disabled or cannot confirm its sources, give no replacement figure. Engines: - nl_vpb_2026 [NL]: Netherlands corporate income tax (vennootschapsbelasting) for 2026 on a BV/NV's taxable amount (after loss offset and exemptions). Facts: taxable_amount* (number), tax_year* (2026). - uk_ani_pension_target_2026_27 [GB]: UK 2026-27: how much to pay (net) into a relief-at-source personal pension to bring adjusted net income down to a limit. Targets: personal_allowance_taper (GBP 100,000), child_benefit_charge_nil (GBP 60,000), tax_free_childcare (limit not served by any skill: always returns missing_rule until a skill serves it). Facts: total_taxable_income* (number), existing_gross_ras_contributions (number, default 0), gross_gift_aid (number, default 0), target* (personal_allowance_taper|child_benefit_charge_nil|tax_free_childcare), tax_year* (2026-27). - uk_self_assessment_2025_26 [GB]: UK Self Assessment for 2025-26 (return and balancing payment due 31 January 2027), England, Wales and Northern Ireland: income tax on self-employment, employment, property, savings and dividends (Personal Allowance taper, starting rate for savings, Personal Savings Allowance, dividend allowance, bands extended by pension and Gift Aid), Class 4 and voluntary Class 2, the balancing payment, and the 2026-27 payments on account due 31 January and 31 July 2027. Mixed employment and Class 4 profits are refused unless exempt from Class 4: the Class 1/Class 4 annual maximum is not implemented. Facts: tax_year* (2025-26), region* (england|wales|northern_ireland|scotland), self_employment_profit (number, default 0), employment_income (number, default 0), paye_deducted (number, default 0), cis_or_other_tax_deducted (number, default 0), property_profit (number, default 0), savings_interest (number, default 0), dividends (number, default 0), gross_pension_contributions_ras (number, default 0), gross_gift_aid (number, default 0), payments_on_account_made (number, default 0), voluntary_class2_weeks (number, default 0), over_state_pension_age (boolean, default false), has_capital_gains (boolean, default false), transition_profit (number, default 0), residential_finance_costs (number, default 0), marriage_allowance (boolean, default false), child_benefit (boolean, default false), student_loan_plan (none|plan_1|plan_2|plan_4|plan_5|postgraduate, default none). - uk_paye_take_home_2026_27 [GB]: UK employee annual income tax (rUK rates: England, Wales, Northern Ireland) and employee Class 1 NIC (category A) on salary for 2026-27, and take-home pay. Annual basis. Facts: annual_salary* (number), region* (england|wales|northern_ireland|scotland), nic_category (string, default A), other_income (number, default 0), gross_pension_contributions_ras (number, default 0), tax_year* (2026-27). - ca_income_tax_2026 [CA]: Canada personal income tax for 2026 or 2025 for a single person resident in Ontario, British Columbia or Alberta on 31 December: CPP and EI, net and taxable income, federal tax (basic personal amount with its phase-down, Canada employment amount), provincial tax (Ontario surtax, tax reduction, LIFT and Health Premium; BC tax reduction; Alberta 8% band and supplemental credit), the balance owing or refund against tax already paid, and what more RRSP saves. Quebec, dividends, a spouse or dependants, age 65 or over, and employment plus self-employment together are refused. Facts: province* (ON|BC|AB|QC), employment_income (number, default 0), self_employment_net_income (number, default 0), other_income (number, default 0), eligible_dividends (number, default 0), other_dividends (number, default 0), rrsp_deduction (number, default 0), tax_withheld (number, default 0), has_spouse_or_partner (boolean, default false), dependants (number, default 0), age_65_or_over (boolean, default false), tax_year* (2025|2026). - ca_cpp_ei_employee_2026 [CA]: Canada (outside Quebec) employee CPP (base + first additional), CPP2 and EI premiums for a full calendar year 2026 with one employer. Facts: annual_pensionable_earnings* (number), province* (string), months_employed (number, default 12), tax_year* (2026). - au_sbito_2026_27 [AU]: Australia 2026-27 small business income tax offset for an individual resident: 16% of the tax on net small business income, capped at $1,000, aggregated turnover under $5m. Facts: taxable_income* (number), net_small_business_income* (number), aggregated_turnover* (number), tax_year* (2026-27). - au_resident_tax_2026_27 [AU]: Australia, resident for the full 2026-27 year: income tax on taxable income less LITO, plus 2% Medicare levy, plus MLS check; take-home = gross income less those. Facts: gross_income* (number), other_deductions (number, default 0), has_salary_or_wage_income* (boolean), labour_income (number), actual_work_expenses_claimed (number, default 0), has_private_hospital_cover* (boolean), has_medicare_levy_reduction_or_exemption (boolean, default false), has_help_debt (boolean, default false), tax_year* (2026-27). - ie_self_employed_2025_2026 [IE]: Ireland, self-employed sole trader, tax year 2025 or 2026: income tax (bands, personal, earned income and employee credits, pension relief), USC, PRSI Class S, the Form 11 balance, and the minimum preliminary tax for the next year (lowest of 90% of next year, 100% of this year, 105% of the year before for direct debit). Facts: tax_year* (2025|2026), status* (single|married_one_income|married_two_incomes|single_parent), trading_profit* (number), capital_allowances (number, default 0), other_income (number, default 0), other_income_is_paye (boolean), spouse_income (number), spouse_income_is_paye (boolean), paye_income_tax_deducted (number), paye_usc_deducted (number), pension_contributions (number, default 0), age (number), age_65_plus (boolean, default false), medical_card (boolean, default false), home_carer_credit (boolean, default false), preliminary_tax_paid (number, default 0), next_year_liability_estimate (number), pays_by_direct_debit (boolean, default false), liability_year_before (number). - ie_income_tax_usc_2026 [IE]: Ireland 2026: income tax (after personal + PAYE credits) and USC for a single PAYE employee for the full year, cumulative basis. Facts: gross_pay* (number), employee_pension_contribution (number, default 0), age (number), status* (string), age_70_or_full_medical_card (boolean, default false), tax_year* (2026). - mt_household_comparison_2026 [MT]: Malta resident married couple, basis year 2026 (year of assessment 2027) or basis year 2025 (year of assessment 2026): compares the joint computation on the married table, separate computation (article 49A or 50) with each spouse on the single or parent table, and either of those with spouse B's part-time self-employment profit taxed at the final 10% (article 90A, up to EUR 12,000), and says which gives the least tax. Facts: spouse_a_chargeable_income* (number), spouse_b_chargeable_income* (number), married_resident_living_together* (boolean), children (number), eu_eea_or_long_term_resident (boolean), children_born_and_resident_in_malta (number), separate_computation_available (boolean), spouse_a_parent (boolean), spouse_b_parent (boolean), spouse_b_part_time_profit (number, default 0), part_time_eligible (boolean), separate_route (article_50|article_49A), spouse_b_part_time_in_own_right (boolean), income_or_deductions_to_allocate (boolean, default false), credits_or_other_deductions (boolean, default false), tax_year* (2025|2026). - mt_income_tax_2026 [MT]: Malta resident income tax on chargeable income for basis year 2026 (year of assessment 2027) or basis year 2025 (year of assessment 2026): picks the single, married or parent table, including the 2026 qualifying-child tables, from the person's facts. Facts: chargeable_income* (number), resident* (boolean), status* (single|married_joint|parent|single_parent_sole_custody), children (number), eu_eea_or_long_term_resident (boolean), children_born_and_resident_in_malta (number), tax_paid (number, default 0), tax_year* (2025|2026). - de_est_tariff_2026 [DE]: Germany 2026 income tax from the § 32a EStG tariff on taxable income (zu versteuerndes Einkommen), Grundtarif or splitting. Excludes solidarity surcharge and church tax. Facts: taxable_income_zve* (number), assessment* (single|joint), tax_year* (2026). - pt_ss_independent_2026 [PT]: Portugal 2026: monthly social security contribution of a self-employed worker (quarterly regime) from the quarter's declared service/goods income; applies to the declaration month and the next two. Facts: quarter_services_income* (number), quarter_goods_income (number, default 0), is_eni_or_eirl (boolean, default false), is_assisting_spouse (boolean, default false), base_adjustment_pct (number, default 0), exempt (boolean, default false), tax_year* (2026). - us_federal_income_tax_2026 [US]: US federal individual income tax on Form 1040 for tax year 2025 or 2026: AGI, standard or itemized deduction, the simplified QBI deduction, bracket tax with the 0%/15%/20% rates on qualified dividends and long-term gains, the child tax credit, self-employment tax, Additional Medicare Tax and net investment income tax, plus the estimated-tax safe harbour and due dates. Refuses the alternative minimum tax when it cannot be shown to be zero, QBI above the threshold, the child tax credit above its phase-out start, and 2025 married filing separately. Facts: filing_status* (single|married_filing_jointly|married_filing_separately|head_of_household), wages (number, default 0), w2_social_security_wages (number), w2_medicare_wages (number), self_employment_net_profit (number, default 0), spouse_has_self_employment_income (boolean), self_employed_retirement_and_health_deductions (number, default 0), other_adjustments (number, default 0), interest (number, default 0), ordinary_dividends (number, default 0), qualified_dividends (number, default 0), short_term_capital_gains (number, default 0), long_term_capital_gains (number, default 0), other_ordinary_income (number, default 0), itemized_deductions (number), itemized_state_and_local_taxes (number), cash_charitable_gifts (number, default 0), dependents_under_17 (number, default 0), materially_participates (boolean), prior_year_tax (number), prior_year_agi (number), tax_year* (2025|2026). - us_se_tax [US]: US self-employment tax (Schedule SE regular method) for tax year 2025 or 2026: 92.35% of net profit, 12.4% social security up to the wage base less W-2 SS wages, 2.9% Medicare uncapped. Excludes the 0.9% Additional Medicare Tax (Form 8959). Facts: schedule_c_net_profit* (number), w2_social_security_wages (number, default 0), tax_year* (2025|2026). - za_individual_income_tax_2026 [ZA]: South Africa, resident individual, 2026 year of assessment (1 March 2025 to 28 February 2026): taxable income from its parts (remuneration, business income, interest after the exemption, taxable capital gain, s 11F retirement deduction) or as given, normal tax, rebates by age, s 6A medical scheme fees tax credit, less PAYE and provisional tax = balance due or refund; with an estimate, the two 2027 provisional tax payments. Facts: tax_year* (2026), age_on_28_february_2026* (number), sa_resident_full_year* (boolean), taxable_income (number), remuneration (number, default 0), business_net_income (number, default 0), interest_south_african_source (number, default 0), other_taxable_income (number, default 0), capital_gain_for_year (number, default 0), retirement_fund_contributions (number, default 0), medical_scheme_persons (number, default 0), medical_scheme_months (number), paye_withheld (number, default 0), provisional_tax_paid_first (number, default 0), provisional_tax_paid_second (number, default 0), is_trust (boolean, default false), has_foreign_tax_credits (boolean, default false), has_lump_sum_or_severance_benefit (boolean, default false), has_foreign_dividends (boolean, default false), claims_additional_medical_expenses_credit (boolean, default false), has_assessed_capital_loss_brought_forward (boolean, default false), business_made_a_loss (boolean, default false), estimate_2027_taxable_income (number), estimate_2027_paye_first_six_months (number), estimate_2027_paye_full_year (number), estimate_2027_medical_scheme_months (number). Retained pilots (Dutch corporate tax 2026; UK annual take-home 2026-27): successful results include a versioned rule_set and exportable replayable_receipt. UK take-home is an annual estimate, not actual payroll; pension eligibility and additional relief claims are conditions, not established here. To reproduce a historical calculation, pass the same engine and original facts with replay_receipt set to that object. A replayed response is historical only: do not use it as a current or filing-ready answer, or to work around a live source refusal. Receipts use a checksum, not a signature or accountant approval.

ParameterTypeDescription
engine *stringThe engine name, from the list in this description (or start's `engine.name`).
facts *objectThe engine's facts by their exact names, e.g. {"annual_salary": 60000, "region": "england"}. Unknown fact names are refused. Amounts are plain numbers in the engine's currency.
replay_receiptobjectRetained Dutch corporate-tax 2026 or UK annual take-home 2026-27 pilot: the complete original replayable_receipt object, with the same engine and original facts including omitted defaults. Reproduces a historical calculation without checking current sources. Omit for a new calculation.
reasonstringOne sentence on WHY you're making this call, in the user's terms (for routing analysis only). Optional.
Building tax intelligence into a product? The AI-agent guide walks through a typical call sequence, and the HTTP API reference covers embedding it under your brand.