# Documentation MCP Server

The DNSControl documentation site exposes an [MCP (Model Context Protocol)](https://modelcontextprotocol.io/introduction) server. This allows AI assistants such as Claude Code, Claude Desktop, and other MCP-compatible tools to search and query the DNSControl documentation directly.

## Endpoint

The MCP server is available at:

```
https://docs.dnscontrol.org/~gitbook/mcp
```

## Features

* **Read-only access** to all published documentation (never drafts or unpublished changes).
* **HTTP transport** only (stdio and SSE are not supported).
* **No authentication required** since the DNSControl docs are public.
* Provides a `searchDocumentation` tool that searches across all pages, code examples, API references, and guides.

## Adding to Claude Code

To connect the DNSControl docs MCP server to Claude Code, run:

```bash
claude mcp add --transport http dnscontrol-docs https://docs.dnscontrol.org/~gitbook/mcp
```

To share the configuration with your team via the project's `.mcp.json` file:

```bash
claude mcp add --transport http dnscontrol-docs --scope project https://docs.dnscontrol.org/~gitbook/mcp
```

Once configured, Claude Code gains access to a `searchDocumentation` tool that can find relevant information across the entire DNSControl documentation.

## Adding to other MCP clients

Any MCP client that supports HTTP transport can connect to the server. Add the following to your MCP configuration:

```json
{
  "mcpServers": {
    "dnscontrol-docs": {
      "type": "http",
      "url": "https://docs.dnscontrol.org/~gitbook/mcp"
    }
  }
}
```

## Further reading

* [Model Context Protocol](https://modelcontextprotocol.io/introduction)
* [Claude Code MCP Documentation](https://code.claude.com/docs/en/mcp)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dnscontrol.org/developer-info/mcp-server.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.