API reference

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.

GEThttps://tax-mcp.com/api/mcp/tax-capabilities

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:

KeyContents
container_scalar_contractWhich fields assert a schedule's existence when present (omitted means absent, not $0).
capability_versionVersion of this manifest. Record it with your integration tests.
productProduct name.
summaryOne-paragraph description of the engine's posture.
document_intakeWhere the document-read endpoint lives (its own host), what it reads, and that its output is unconfirmed evidence.
supported_envelopeRoutes, and per jurisdiction: tax years, filing statuses, modeled fields, and modeled surfaces.
out_of_scopeWhat declines deterministically.
decline_codesEvery federal decline code, and how state and reconcile declines are reported.
preparer_routingPer decline code, the forms a preparer must handle at minimum (non-exhaustive).
review_statesReconcile statuses: match, mismatch, unsupported, needs_review.
response_uniform_fieldsThe contract fields every response carries.
billing_semanticsWhich outcomes are billed, idempotent billing, and the hard quota cap.
docsLinks to these docs, the OpenAPI spec, and the roadmap.
affirmationsEvery affirmation field the engine consumes.
not_modeledNamed residual situations the engine does not model and cannot detect.
commercial_and_retry_semanticsRetry, idempotency, and commercial rules in machine-readable form.
legal_noticeThe computation-support notice carried by successful responses.
decline_bindingHow 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.

Product-builder API, contract & trust surfaces
CapabilityStatus
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