Loading

MCP server

docs-builder includes an MCP (Model Context Protocol) server that allows AI assistants and coding agents to interact with Elastic documentation directly.

The MCP server is deployed as a stateless HTTP service and exposes all tools through a single Streamable HTTP endpoint at https://www.elastic.co/docs/_mcp/.

Add the docs-builder MCP server to your editor or AI assistant using one of the options below.

To install automatically, copy and paste the following link into your browser's address bar:

cursor://anysphere.cursor-deeplink/mcp/install?name=elastic-docs&config=eyJ1cmwiOiJodHRwczovL3d3dy5lbGFzdGljLmNvL2RvY3MvX21jcC8ifQ==

Cursor will prompt you to install the elastic-docs MCP server.

Or configure manually. Create or edit .cursor/mcp.json in your workspace:

{
  "mcpServers": {
    "elastic-docs": {
      "url": "https://www.elastic.co/docs/_mcp/"
    }
  }
}

Then restart Cursor or reload the window. The tools will be available in Agent mode.

Run the following command to add the server to your current project:

claude mcp add --transport http elastic-docs https://www.elastic.co/docs/_mcp/

To make it available across all your projects, add the --scope user flag:

claude mcp add --scope user --transport http elastic-docs https://www.elastic.co/docs/_mcp/

Or add it manually to your project's .mcp.json file:

{
  "mcpServers": {
    "elastic-docs": {
      "type": "http",
      "url": "https://www.elastic.co/docs/_mcp/"
    }
  }
}

To install automatically (requires VS Code 1.99+), copy and paste the following link into your browser's address bar:

vscode:mcp/install?%7B%22name%22%3A%22elastic-docs%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fwww.elastic.co%2Fdocs%2F_mcp%2F%22%7D

VS Code will prompt you to install the elastic-docs MCP server.

Or configure manually. Create or edit .vscode/mcp.json in your workspace:

{
  "servers": {
    "elastic-docs": {
      "type": "http",
      "url": "https://www.elastic.co/docs/_mcp/"
    }
  }
}

Requires GitHub Copilot with agent mode enabled.

Configure the server through the IDE settings:

  1. Open Settings → Tools → AI Assistant → Model Context Protocol.
  2. Click Add and select HTTP as the connection type.
  3. Enter https://www.elastic.co/docs/_mcp/ as the server URL, and elastic-docs as the name.
  4. Click OK and apply the settings.

Or configure it directly via JSON by adding the following to your MCP settings file:

{
  "mcpServers": {
    "elastic-docs": {
      "url": "https://www.elastic.co/docs/_mcp/"
    }
  }
}

Requires JetBrains AI Assistant plugin version 2025.2 or later.

Tool Description
search_docs Searches all published Elastic documentation by meaning. Returns relevant documents with AI summaries, relevance scores, and navigation context. Supports filtering by product and navigation section.
find_related_docs Finds Elastic documentation pages related to a given topic. Useful for exploring what documentation exists around a subject and discovering related content.
Tool Description
get_document_by_url Retrieves a specific Elastic documentation page by its URL. Accepts a full URL or a path. Returns title, AI summaries, headings, navigation context, and optionally the full body.
analyze_document_structure Analyzes the structure of an Elastic documentation page. Accepts a full URL or a path. Returns heading count, link count, parent pages, and AI enrichment status.
Tool Description
check_docs_coherence Checks how coherently a topic is covered across all Elastic documentation by finding related documents and analyzing their coverage across products and sections.
find_docs_inconsistencies Finds potential inconsistencies across Elastic documentation pages covering the same topic. Identifies overlapping content within a product area.

You can test the MCP server using the MCP Inspector:

npx @modelcontextprotocol/inspector --url https://www.elastic.co/docs/_mcp/

This opens a web UI where you can browse all available tools and invoke them manually.