> ## Documentation Index
> Fetch the complete documentation index at: https://docs.celeryroot.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP server

> Expose a read-only MCP server for Celery Root data.

## What it does

Celery Root ships with an optional MCP server that exposes read-only tools over HTTP. It lets MCP clients inspect the Celery Root SQLite store without write access.

## Enable MCP

Set `mcp` in your config and provide an auth token:

```python theme={null}
from celery_root import CeleryRootConfig, McpConfig

config = CeleryRootConfig(
    mcp=McpConfig(
        host="127.0.0.1",
        port=9100,
        path="/mcp/",
        auth_key="your-secret-token",
    ),
)
```

You can also set environment variables used by the web UI settings page:

* `CELERY_ROOT_MCP_ENABLED` (derived from config)
* `CELERY_ROOT_MCP_HOST`
* `CELERY_ROOT_MCP_PORT`
* `CELERY_ROOT_MCP_PATH`
* `CELERY_ROOT_MCP_AUTH_KEY`

## Read-only database access

For SQLite, the MCP server opens the database in read-only mode. For non-SQLite databases, provide a read-only URL:

```bash theme={null}
export CELERY_ROOT_MCP_READONLY_DB_URL="postgresql://readonly:..."
```

## Client snippets

The Settings page in the UI renders JSON snippets and CLI commands for Codex and Claude. Visit `/settings/` after enabling MCP to copy them.