mothermachine

Browse / Content publishing

Directus

Backend and Studio over any SQL database with a built-in MCP server; source-available, free under revenue caps.

AdaptableOperable Business appWeb app Hybrid TypeScript MCP server License: MSCL-1.0 (source-available; GitHub NOASSERTION)

Directus wraps a SQL database with REST and GraphQL APIs, a visual Studio for non-technical editors, flows for automation, and policy-based access control. Since v11.12 it includes a native MCP server switched on in Settings > AI, so an agent can manage items, collections, fields, relations, files, and flows under the same permissions as a human user. Configured entirely by env vars. Licensed MSCL 1.0, free for organizations under $5M revenue and 50 staff.

Use it when
  • I have a database already and want an admin UI and API on top that my agent can also write to
  • I want editors in a Studio and an agent creating collections and content under the same permission rules
Gotchas
  • MSCL 1.0 is source-available, not OSI open source; organizations over $5M revenue or 50 employees need a commercial license
  • Free Core tier caps at 3 seats, 25 collections, and 5 flows unless you apply for the Open Innovation Grant
  • Remote MCP requires v11.12+; older versions fall back to a Node.js MCP server
  • Create a dedicated MCP user and token rather than using an admin token
  • 398 open issues; large surface, expect upgrade notes between releases

Last activity Sep 2, 2026. Fit: adaptable 2, operable 3.

Editions

Core (self-hosted) · Free closed source

  • Clonegit clone https://github.com/directus/directus
  • ImageContainer
  • DeployDeploy

Open Innovation Grant (self-hosted) · Free closed source

closed source

Enterprise · Free closed source

No distribution recorded.

closed source

For agents: JSON · Markdown

Adaptable: what is yours to change

Make it yours

Config only18 things to editadmin-ui surface

The env surface (.env or CONFIG_PATH: KEY, SECRET, DB_*, PUBLIC_URL, ADMIN_*, storage, LICENSE_*) is deployment configuration; business adaptation lives in the Studio admin UI: Settings > Data Model, Flows, Access Policies and Roles, and Project Settings for branding. Custom email templates need EMAIL_TEMPLATES_PATH plus Liquid files, and anything beyond that is code in extensions/.

Env vars
KEY SECRET DB_CLIENT DB_CONNECTION_STRING HOST PORT PUBLIC_URL SERVE_APP ADMIN_EMAIL ADMIN_PASSWORD ADMIN_TOKEN CONFIG_PATH LICENSE_KEY LICENSE_TOKEN EMAIL_TEMPLATES_PATH
Config files
.env docker-compose.yml extensions/
Prompt files
none
Accounts you need
Directus (license key for Open Innovation Grant or commercial tiers)OpenAI, Anthropic, or Gemini (optional AI Assistant)

Source

Operable: what an agent can drive

Interface

OfficialMCP serverpublished by the builderremote or local

How an agent can drive an Operable Listing, in five levels: native (built for the agent as the primary interface), official (the Builder ships an agent interface), wrapped (a third party wraps the software's API), config (an agent can only drive it by editing files), gui (screen control only). An interface is official only when it is published by the same organization that ships the software. GUI-level Listings are allowed and sorted last.

Docs
directus.com/docs/guides/ai/mcp

Reach

Partial coverage. 6 of 10 jobs reachable through the stated interface.

JobThrough the interfaceEvidence
Create, read, update, and delete itemsReachableMCP docs: items create, edit, manage
Build collectionsReachableMCP docs: build and configure collections
Define fields and validationReachableMCP docs: field types and validation rules
Model relationsReachableMCP docs: M2O, O2M, M2M, M2A relationships
Manage file metadata and foldersReachableMCP docs: alt text, descriptions, tags, folder organization
Create automation flowsReachableMCP docs: generate flows triggered by database events
Upload binary filesUndeterminedmetadata management documented; binary upload over MCP not stated
Manage users, roles, and policiesUndeterminedMCP respects permissions; managing them is not listed
Translate contentUndeterminedAI Assistant runs translations in Studio; MCP tool not listed
Build Studio dashboards and insightsNot reachableStudio UI feature; no MCP tool

Code stack

Languages
TypeScript
Frameworks
Node.jsVue
Package manager
pnpm
Database
PostgreSQLMySQLMariaDBMS SQLSQLiteOracleDBCockroachDB
Hosting target
DockerRailway one-clickDirectus Cloud
Built
Human-written (recorded, never ranked)

Model stack

Providers
OpenAIAnthropicGoogle Gemini (AI Assistant, optional)
Models
none
Keys you need
none
Prompts live in
none

Evidence and confidence

FieldWhere it was seenConfidence
formFactorREADME: API layer plus visual Studio, self-host or cloud95%
executionModelcore is deterministic; README: embedded AI Assistant creates, translates, and takes actions with OpenAI, Anthropic, or Gemini70%
operabilityREADME and directus.com/docs/guides/ai/mcp: native MCP server enabled in Settings > AI with a token, published by Directus90%
effortdirectus.com/docs/configuration/general: env vars in .env through CONFIG_PATH; triage confirmed extensive documented env surface85%
editionsdirectus.com/pricing: Core free with caps, OIG free under thresholds, Team $499 per month annual, Enterprise custom, Cloud $99 per month add-on80%
activepushedAt 2026-09-02–
provenanceMonospace-built since 2004 lineage; no vibe-coded claim90%
reach75%

Open questions

  • Full MCP tool names (docs page describes capabilities without listing tool names)
  • Does the Core tier's 25-collection cap apply to collections created over MCP?
  • Confirm DB_CLIENT and DB_CONNECTION_STRING names on the database configuration page (general page fetched only)

Sources