CA, NY (incl. NYC), IL, NC & MI · federal coverage growing

Deterministic tax compute. Never a guess.

A deterministic tax-compute API for teams building AI products that need a real tax engine underneath. No LLM in the compute path — every call returns a computed result or an honest, reasoned decline. Billing and retry behavior are explicit; an idempotent retry replays the same response instead of charging twice.

COMPUTED
Request — federal, W-2 wages
curl https://tax-mcp.com/api/mcp/tax-compute/federal \
  -H "Authorization: Bearer $TAX_MCP_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"year":2025,"filingStatus":"single",
       "canBeClaimedAsDependent":false,
       "noForeignOrTerritoryExclusionAffirmed":true,
       "wages":85000,"medicareWages":85000,
       "federalWithholding":9500}'
Response — HTTP 200
{
  "computed": true,

  "taxableIncome": 69250,

  "totalTax": 10155,

  "next_action": "none"

}
DECLINE
Request — Schedule C, missing affirmation
curl https://tax-mcp.com/api/mcp/tax-compute/federal \
  -H "Authorization: Bearer $TAX_MCP_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"year":2025,"filingStatus":"single",
       "canBeClaimedAsDependent":false,
       "noForeignOrTerritoryExclusionAffirmed":true,
       "wages":40000,"medicareWages":40000,
       "scheduleCIncome":30000}'
Response — HTTP 200
{
  "computed": false,

  "code": "schedule_c_needs_review",

  "next_action": "review_inputs"

}

Real engine output, regenerated from the current engine on every build. Both are billable, final 200s — a decline is never a wrong-but-plausible number, and it's never something you blind-retry.

How it behaves

Deterministic, not generative

No model in the loop — a table-driven, §6694-disciplined engine, not an LLM. Every figure is primary-source-backed and carries its own derivation; ambiguous cases decline with a reason instead of a wrong-but-plausible guess.

Idempotent billing

Send an Idempotency-Key and retries replay the byte-identical response, billed exactly once. Quota and per-minute rate limits fail closed.

Coverage-bounded by design

Supported today: selected federal, CA, NY, NYC, IL, NC, MI, no-income-tax-state, reconcile, what-if, and review-packet paths with a machine-readable envelope before any taxpayer payload. Unsupported facts decline deterministically or return needs_review — see the supported-vs-not-modeled reference.

Published, not discovered at runtime

What's in the supported envelope

Anything on the right returns a deterministic 200 decline (a reason + next_action), never a wrong-but-plausible number. Machine-readable at /api/mcp/tax-capabilities.

Supported today

  • Federal 1040 — ordinary tax, NIIT (8960), Additional Medicare (8959), preferential LTCG / QDIV bands
  • Standard or itemized deduction (Schedule A: SALT with OBBBA cap + mortgage interest + attested medical, charitable, gambling losses and investment interest, greater-of), plus 2025–2026 qualified disaster losses (Form 4684)
  • Selected credits, Schedule C/E, pension, Social Security, capital-loss carryover, Schedule D / 8949, and §1256 paths when documented facts and affirmations are supplied
  • CA 540 + selected NY / NYC 2025 compute paths, and IL-1040, NC D-400 and MI-1040 2020–2026
  • Non-mutating CA reconcile against a filed return

Declines deterministically

  • Full-return preparation or filing; broad credits / Schedule A / Form 1116 beyond the documented slices
  • Missing or contradictory affirmations; over-threshold QBI; broad K-1, partnership, and S-corp income
  • Dirty, noncovered, unsupported, or source-conflicted Schedule D / Form 8949 facts
  • States beyond CA / NY / IL / NC / MI and the no-income-tax states; unmodeled years; broad document upload-to-compute workflows

Needs review

  • Reconcile returns needs_review when computed source facts and filed-return oracles differ
  • Source documents are evidence for review, not promoted into compute without caller assertions
  • Public one-click marketplace connectors remain planned, not shipped
Not a spec. A running engine.

plio-practice runs on this exact API.

plio-practice is a tax-preparation product built on the Tax MCP engine — not a demo account. Every return it drafts calls the same deterministic core available through this API.

See plio-practice →
Independent software. Not affiliated with the IRS or any state tax agency.
pliioai.com
Screenshot pending — see redesign plan T11

Deterministic, §6694-disciplined US tax compute. An HTTP 200 is billable whether the engine computed a result or honestly declined. Full spec: /api/openapi.json. See pricing for plan limits.