Tax MCP documentation
A deterministic, §6694-disciplined tax-compute API for human-led product and engineering teams. You send a taxpayer's facts as JSON. You get back either a computed return, with the form lines behind its figures and the rule and authority behind the computed ones, or a reasoned decline when the case is outside what the engine models.
How every call is answered
There is no language model in the compute path. The same request always produces the same response, and the engine is designed to decline rather than fill a gap with a plausible guess. (IRC §6694 is the preparer-penalty section for understated tax, which is where that discipline comes from.) Known gaps are disclosed per capability, in the roadmap status at the end of the docs page that covers it. Every successful call ends in one of three ways:
Computed
computed: true with taxable income, total tax, balance due or refund, and the form lines behind them.
Declined
computed: false with a code and a reason naming what a preparer must handle. This is a final, correct answer, not an error.
Needs review
A reconcile found a difference against a filed return that a person has to resolve. The engine never decides which side is wrong.
Every response also says whether it was billed, whether it is retry_safe, and the next_action your code should take. See Responses & states.
Coverage at a glance
- Federal Form 1040, tax years 2020–2026: ordinary tax, NIIT, Additional Medicare Tax, preferential capital-gain rates, and bounded slices of itemized deductions, credits, Schedules C, D and E, pensions, and Social Security. For 2026, a return with taxable income above $0 and under $100,000 declines until the IRS publishes the 2026 Tax Table.
- California Form 540 (2025) and New York IT-201 with New York City resident tax (2025), and Illinois IL-1040 (2020–2026), North Carolina D-400 (2020–2026) and Michigan MI-1040 (2020–2026).
- Workflows: reconcile a California return against what was filed, project up to 25 federal scenarios, and assemble a review packet.
Coverage is bounded on purpose and published before you send any data. The full list, generated from the live capability manifest, is on What it covers.
How these docs are organized
The sidebar has four sections, in reading order:
| Section | Read it when you want to… |
|---|---|
| Get started | go from nothing to a first working call: account, API key, quickstart. |
| Using the API | understand how every call behaves: coverage, requests, responses, declines, billing. |
| Guides by outcome | reach a specific result, such as a state return or a reconcile, step by step. |
| API reference | look up an endpoint's exact fields, types, and responses. |
Who is responsible for the return
Computation support only
Tax MCP is not tax, legal, or financial advice, and it does not prepare or file returns. A person who relies on a computed line remains responsible for the return; the per-line derivation exists so that responsibility can be checked. The Terms govern every response.
Roadmap status for this page
Generated from the roadmap (updated 2026-10-30). Shipped & certified means live and independently checked against primary tax sources; certifying means live, with those checks still in progress. 1 related item is planned and not available yet; see the roadmap.