Discover the supported envelope
A public, free description of everything the engine models and declines. Read it before you send taxpayer data, and record its version with your tests.
Machine-readable supported-envelope discovery (public, no auth, no payloads).
Returns the supported envelope (jurisdictions, years, filing statuses, modeled income fields, out-of-scope list, decline codes, review states, uniform response fields, billing semantics, docs links) so a client can discover what is modeled vs declined WITHOUT sending taxpayer payloads or learning boundaries only from runtime declines.
Request
No key, no body, no quota. Ask for JSON explicitly; a browser gets a readable HTML view of the same data.
curl https://tax-mcp.com/api/mcp/tax-capabilities -H "Accept: application/json"
# or: curl "https://tax-mcp.com/api/mcp/tax-capabilities?format=json"Response
A JSON object. Current version: 2026-10-25.27. Its top-level sections:
| Key | Contents |
|---|---|
| container_scalar_contract | Which fields assert a schedule's existence when present (omitted means absent, not $0). |
| capability_version | Version of this manifest. Record it with your integration tests. |
| product | Product name. |
| summary | One-paragraph description of the engine's posture. |
| document_intake | Where the document-read endpoint lives (its own host), what it reads, and that its output is unconfirmed evidence. |
| supported_envelope | Routes, and per jurisdiction: tax years, filing statuses, modeled fields, and modeled surfaces. |
| out_of_scope | What declines deterministically. |
| decline_codes | Every federal decline code, and how state and reconcile declines are reported. |
| preparer_routing | Per decline code, the forms a preparer must handle at minimum (non-exhaustive). |
| review_states | Reconcile statuses: match, mismatch, unsupported, needs_review. |
| response_uniform_fields | The contract fields every response carries. |
| billing_semantics | Which outcomes are billed, idempotent billing, and the hard quota cap. |
| docs | Links to these docs, the OpenAPI spec, and the roadmap. |
| affirmations | Every affirmation field the engine consumes. |
| not_modeled | Named residual situations the engine does not model and cannot detect. |
| commercial_and_retry_semantics | Retry, idempotency, and commercial rules in machine-readable form. |
| legal_notice | The computation-support notice carried by successful responses. |
| decline_binding | How decline codes are bound to the engine's own code lists. |
A readable rendering of the coverage parts is on What it covers, and the browser view is at /api/mcp/tax-capabilities.
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.
| Capability | Status |
|---|---|
| Machine-readable capabilities discovery (GET /api/mcp/tax-capabilities)Machine-readable discovery of what the engine supports, served at GET /api/mcp/tax-capabilities. | ✅ shipped & certified |