# TaxSorted machine doorway
# Public orientation for UK tax data and bounded expert tools.

schema-version: taxsorted.agent-manifest/1
name: TaxSorted
what: sourced public data and bounded tools for UK tax, politics, charities and public funding
human-door: https://taxsorted.io/
agent-door: https://api.taxsorted.io/v1/wake
wake: GET https://api.taxsorted.io/v1/wake
open-data: GET https://api.taxsorted.io/v1/open-data
rights: GET https://api.taxsorted.io/v1/open-data/rights
openapi-public: GET https://api.taxsorted.io/openapi-public.json
openapi-full: GET https://api.taxsorted.io/openapi.json
why-graph-framework: GET https://api.taxsorted.io/v1/why-graph
why-graph-schema: GET https://api.taxsorted.io/v1/why-graph/schema
why-graph-openapi: GET https://api.taxsorted.io/openapi/why-graph.json
why-graph-writes: none; read-only framework with no ingestion route
health: GET https://api.taxsorted.io/v1/health
release-ledger: GET https://api.taxsorted.io/v1/open-data/releases
release-json-feed: GET https://api.taxsorted.io/v1/open-data/releases/feed.json
release-atom-feed: GET https://api.taxsorted.io/v1/open-data/releases/feed.atom
public-funding-changes: GET https://api.taxsorted.io/v1/public-funding/uk/changes
charity-accountability: GET https://api.taxsorted.io/v1/charities/uk/accountability
charity-accountability-schema: GET https://api.taxsorted.io/v1/charities/uk/accountability/schema
charity-accountability-status: schema-only-not-admitted
charity-accountability-records: none
observer-accountability: GET https://api.taxsorted.io/v1/accountability/uk
observer-accountability-schema: GET https://api.taxsorted.io/v1/accountability/uk/schema
observer-accountability-status: schema-only-not-admitted
observer-accountability-records: none
tax-expert-manifest: GET https://api.taxsorted.io/v1/uk/tax-expert
tax-expert-openapi: GET https://api.taxsorted.io/openapi/tax-expert-uk.json
tax-expert-assessment: POST https://api.taxsorted.io/v1/uk/tax-expert/mtd-income-tax/assessments
tax-expert-assessment-authentication: Bearer TaxSorted workspace key
tax-expert-assessment-required-scope: tax-expert:assess
tax-expert-assessment-availability: credentialed design partner; no public self-service key provisioning
tax-expert-assessment-kind: stateless computation
tax-expert-assessment-input-sensitivity: financial facts; no name, NINO, UTR or address requested
tax-expert-assessment-workspace-identity: the workspace key identifies the calling workspace
tax-expert-assessment-request-fact-storage: not written to application storage
tax-expert-assessment-generated-answer-storage: not written to application storage
tax-expert-assessment-used-for-training: false
tax-expert-assessment-effects: classification only; no signup, filing or external tax-state change
tax-expert-assessment-cache: no-store
tax-expert-assessment-cors: server-to-server; browser bearer calls are not supported
tax-expert-assessment-repeatability: same facts, trusted server evaluation date and admitted ruleset/source ledger
tax-expert-assessment-idempotency: not declared; do not assume automatic retries are safe
tax-expert-assessment-errors: follow the task OpenAPI TaxExpertApiError contract; request fact values are not echoed in errors
corrections: https://github.com/cambridgetcg/taxsorted.io/issues
authentication: none on this doorway and public read resources
authentication-scope: secured task tools declare authentication separately
corrections-account: a GitHub account is required to submit a public correction
wishes: https://github.com/cambridgetcg/taxsorted.io/issues/new?template=wish.yml
wishes-account: a GitHub account is required; wishes are public so anyone can see what was asked and what got built
account: none on this doorway
session: none on this doorway
cookies: none on this doorway
writes: none on this doorway
writes-scope: this doorway only; linked task tools declare effects separately
methods: GET, HEAD, OPTIONS
methods-scope: this doorway only; linked task tools declare methods separately
formats: application/json, application/x-ndjson, text/csv, application/feed+json, application/atom+xml
format-selection: follow each export index's explicit representation URLs; Accept does not switch graph formats
errors: RFC 9457 fields; application/problem+json by default, application/json when explicitly requested
errors-scope: this doorway only; task errors follow their task OpenAPI contract
error-instance: route path only; query values are never reflected
xenia-source: https://github.com/cambridgetcg/xenia
xenia-credit: XENIA by Yu and Fable
xenia-licence: https://creativecommons.org/licenses/by-sa/4.0/
xenia-licensed-content: response and manifest content; implementation source remains AGPL-3.0
xenia-conformance-claim: none
sibling-doors: https://taxsorted.io/from-the-builders/
sibling-agents-substrate: https://agenttool.dev (agent self-registration: POST https://api.agenttool.dev/v1/register/agent)
sibling-relationship: same builders; separate services; no shared data; no conformance or endorsement claims

# Walls kept by this doorway
wall: publication gates and emergency stops remain authoritative
wall: a public-data licence is not a blanket licence over linked source material
wall: private contacts, private communications and inferred personal ties do not belong here
wall: uncertainty, source limits and known gaps stay visible
wall: the charity map does not publish a people, personal-contact or inferred-belief graph
wall: attributed statements, reported action, official findings, TaxSorted analysis and unknowns stay labelled
wall: every observer needs a sourced accountability route or an explicit coverage gap
wall: a formal institutional relation is not proof of control, collusion, motive or character