Docs MCP Server

You landed here because you opened the Directus docs MCP server in a browser. The server itself speaks the Model Context Protocol. Connect a compatible AI client to it and your assistant can search and read these docs as a live tool.

This is the docs MCP server, which exposes this documentation site to AI clients. If you want to connect AI tools to your own Directus instance to manage content and schema, see the Directus product MCP guide instead.

Server URL

https://directus.com/docs/mcp

Transport: streamable HTTP. No authentication required.

Install in one click

Add to Cursor

Opens Cursor and registers the docs MCP server.

Add to VS Code

Opens VS Code and registers the docs MCP server.

Manual setup

For clients without a one-click installer, add the server to your MCP config.

Claude Code

claude mcp add --transport http directus-docs https://directus.com/docs/mcp

Claude Desktop

Edit claude_desktop_config.json:

{
  "mcpServers": {
    "directus-docs": {
      "type": "http",
      "url": "https://directus.com/docs/mcp"
    }
  }
}

Codex / Windsurf / other HTTP-MCP clients

Point them at https://directus.com/docs/mcp with transport set to http (sometimes called streamable-http).

Available tools

Tool	Inputs	Use it for
`list-docs`	`pathPrefix?`, `limit?`	Discover available docs pages when you do not know exact paths.
`get-doc`	`path`	Fetch a single page's full markdown by path (e.g. `/getting-started/overview`).
`search-docs`	`query`, `section?`, `framework?`, `limit?`	Full-text search across the docs. Returns ranked results with title, snippet, and section.
`search-directus-code`	`query`, `repo?`, `language?`, `path?`, `limit?`	Search source code across allowlisted Directus GitHub repos.
`get-directus-file`	`repo?`, `path`, `ref?`, `offset?`, `bytes?`	Fetch source files from allowlisted Directus GitHub repos.

Try it

After connecting, ask your AI client questions like:

"Search the Directus docs for OAuth setup."
"Get the docs page on configuring the SDK in Nuxt."
"List all guides in the data-model section."
"How do I create a flow in Directus? Use the docs MCP."

The assistant should call search-docs or list-docs, then get-doc to read the relevant page.

For deeper guidance while your agent builds, install the Directus Agent Skills as well. The skills cover the mistakes agents commonly make with Directus, and the docs MCP server fills in everything else.

Troubleshooting

Connection refused or 404 - confirm the URL is exactly https://directus.com/docs/mcp (note the /docs prefix).
Tools not showing up - restart your MCP client after adding the server. Some clients only load tools at startup.
Search returns nothing - search-docs is case-insensitive but does keyword match. Try fewer or broader terms.

Found a bug? Report it at github.com/directus/docs/issues.

Get once-a-month release notes & real‑world code tips...no fluff. 🐰

Open Innovation Grant

Who qualifies for the Open Innovation Grant, what it includes, and how its activations apply to multiple environments, CI pipelines, and database restores.

Releases

Releases are how we roll out new features, updates, and fixes to Directus.