$HEADLESS SYSTEMS
03 / Scorecard / Content Management

Directus

C
Headless Index
59/100
denominator 80
JAIRF
85.3/100
AI-Ready
Verified
MAY 21, 2026
Methodology v1 · JAIRF v1.0.0

Powered by JAIRF v1.0.0 by Jentic · open methodology at /the-headless-index/methodology

Editorial verdict
Directus is partially headless and partly UI-led. The Headless Index thesis-fit score of 59/100 puts it mid-table on the index, and JAIRF v1.0.0 puts it at 85.3/100 (Level 3, AI-Ready). In practice, vendors at this tier are partly machine-consumable: the core flows are reachable through code but several adjacent surfaces still expect a human at a dashboard, and the rest of this verdict explains where Directus lands inside that pattern. On the API surface, the question is whether the API is the product or a layer beneath the dashboard. On API-first posture, the structured collectors did not surface an OpenAPI spec, GraphQL endpoint, or SDK ecosystem strong enough to score this criterion automatically. Editorial follow-up should confirm whether an API spec exists behind authentication or in unindexed documentation.[1] Schema observability is the related test: can an agent introspect the contract from cold, or does it have to read prose documentation to do so? REST and GraphQL are auto-generated; GraphQL introspection is supported. The schema is the underlying database schema, exposed through Directus. Schema discoverability is reference-class for database-driven CMS.[2] An agent can drive parts of this product, but not all of it: integrators should plan for human-in-the-loop checkpoints where the headless surface stops short. On headless operability: Schema, items, collections, permissions, users, roles, presets, and flows are all programmable. The Directus app is the admin UI consuming the same API. Flows (workflow automations) extend the platform with event-driven actions.[3] On the MCP and agent-integration axis, which is the fastest-moving criterion in the index: No first-party Directus MCP server has been published. The architecture would make MCP integration straightforward; community work exists.[4] Event posture closes the loop: an agent that cannot react to state changes is reduced to polling. Webhooks deliver collection events with HMAC signing options. Flows extend the event-driven model with composable triggers and actions, which is unusual for a CMS. Net assessment: integrators can build agent flows against Directus, but the rough edge to plan around is schema observability[5]. Expect to wrap missing pieces in bespoke glue or accept human-in-the-loop checkpoints. Workable but requires scaffolding.
Verdict by Headless Index pipeline (auto)
// AI-drafted from the evidence layer. Editorial review pending.
Scores

Scorecard detail

Headless Index · 5 sub-criteria
API-first design intentUnknown
Unknown

Directus is open-source data platform with auto-generated REST and GraphQL APIs over any SQL database. The product turns existing databases into headless content platforms. SDKs in JavaScript and others. The directus binary plus Docker plus Kubernetes Helm chart give deployment paths.

signals (4)
  • +AI review appliedReviewer: Editorial review on 2026-05-20
  • +OpenAPI specPublished, 0 operations
  • GraphQL endpointNot discovered (5 probes; project-scoped endpoints require a real project ID)
  • SDKs maintainedNone detected in vendor org
cite (3)
  • openapi.probes_tried@2026-05-19
  • graphql.probes_tried@2026-05-19
  • github.sdks@2026-05-19
Headless operation12/20
scored

Schema, items, collections, permissions, users, roles, presets, and flows are all programmable. The Directus app is the admin UI consuming the same API. Flows (workflow automations) extend the platform with event-driven actions.

signals (9)
  • +AI review appliedReviewer: Editorial review on 2026-05-20
  • API operations exposedOpenAPI present but operations could not be counted
  • ·Docs pages crawled57 pages (crawler: cheerio)
  • +Auth schemes documentedAuth page reached but schemes not detected by parser
  • +Setup / quickstart docsFound: https://directus.io/docs/tutorials/getting-started, https://directus.io/docs/getting-started/use-the-api
  • +Billing docsFound: https://directus.io/docs/guides/realtime/subscriptions
  • +Teams / org docsFound: https://directus.io/docs/api/users#register-a-new-user
  • ·CLI docsNot reached by crawler
  • +Schema / data model docsFound: https://directus.io/docs/guides/data-model/collections, https://directus.io/docs/guides/data-model/relationships
cite (8)
  • openapi.operations_count@2026-05-19
  • docs.pages_crawled@2026-05-19
  • docs.auth_evidence.docs_url@2026-05-19
  • docs.topics_found.setup@2026-05-19
  • docs.topics_found.billing@2026-05-19
  • docs.topics_found.teams@2026-05-19
  • docs.topics_found.cli@2026-05-19
  • docs.topics_found.schema@2026-05-19
MCP & agent posture20/20
scored

No first-party Directus MCP server has been published. The architecture would make MCP integration straightforward; community work exists.

signals (4)
  • +AI review appliedReviewer: Editorial review on 2026-05-20
  • +Official MCP serverhttps://github.com/directus/mcp (77 stars, last commit 105 days ago)
  • Community MCP serversNone found
  • Agent-friendly SDKsNo TypeScript/JavaScript SDK published (agents commonly run in TS/JS)
cite (2)
  • github://directus/mcp@2026-05-19
  • ai_review.answers.mcp_check.evidence_url@2026-05-19
Schema observability5/20
scored

REST and GraphQL are auto-generated; GraphQL introspection is supported. The schema is the underlying database schema, exposed through Directus. Schema discoverability is reference-class for database-driven CMS.

signals (3)
  • +AI review appliedReviewer: Editorial review on 2026-05-20
  • +OpenAPIPublished at https://github.com/directus/openapi (bundled via @redocly/cli) (OpenAPI undefined, 0 operations)
  • GraphQL introspectionNo GraphQL endpoint discovered (5 probes; some vendors use project-scoped endpoints that require a real project handle)
cite (2)
  • openapi.probes_tried@2026-05-19
  • graphql.probes_tried@2026-05-19
Webhooks & events10/20
scored

Webhooks deliver collection events with HMAC signing options. Flows extend the event-driven model with composable triggers and actions, which is unusual for a CMS.

signals (5)
  • +AI review appliedReviewer: Editorial review on 2026-05-20
  • ·Webhook docs URLhttps://directus.io/docs/guides/realtime/subscriptions
  • ·Signing schemeNot detected by parser (does not necessarily mean unsigned; may be a parsing gap)
  • ·Declared events3 candidate events extracted (sample: query.fields, message.data, data.type)
  • ·Retry policy signalsNone detected in webhook page text
cite (4)
  • docs.webhook_evidence.docs_url@2026-05-19
  • docs.webhook_evidence.signing_scheme@2026-05-19
  • docs.webhook_evidence.declared_events@2026-05-19
  • docs.webhook_evidence.retry_policy_keywords@2026-05-19
JAIRF · 6 dimensions
FCFoundational Compliance
100/100

Structural validity, standards conformance, and parsability of the OpenAPI specification.

DXJDeveloper Experience & Tooling Compatibility
75.7/100

Documentation clarity, example coverage, response completeness, and ingestion health.

ARAXAI-Readiness & Agent Experience
86.3/100

Semantic clarity, intent expression, datatype specificity, and error standardization.

AUAgent Usability
75/100

Operational composability, complexity comfort, navigation affordances, and safety patterns.

SECSecurity
77.9/100

Authentication strength, transport security, secret hygiene, and OWASP risk posture.

AIDAI Discoverability
99.8/100

Descriptive richness, intent phrasing, workflow context, and registry signals.

Band rationale:C band: scores 40-75 range

04 / Embed

Show Directus's score on your site.

Drop a live badge into your README, footer, or marketing page. It updates automatically when we re-score, and every embed is a dofollow link back here.