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.
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}'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}'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.
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.
Send an Idempotency-Key and retries replay the byte-identical response, billed exactly once. Quota and per-minute rate limits fail closed.
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.
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.
needs_review when computed source facts and filed-return oracles differplio-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 →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.