Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
67 changes: 67 additions & 0 deletions references/integrations/lightdash-mcp.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -300,6 +300,73 @@ To get the most value from MCP, ensure your Lightdash data is well-organized and
- Optimizing for AI assistant performance
- Security and permissions considerations

## Lightdash Docs MCP

In addition to the Lightdash data MCP above, we also offer a **Docs MCP endpoint** that gives AI coding agents access to the complete Lightdash documentation. This is free for everyone—including open source users and all cloud tiers.

### Benefits

The Docs MCP helps AI agents:

- Understand Lightdash concepts, configuration, and best practices
- Generate accurate YAML configurations for metrics and dimensions
- Troubleshoot issues using official documentation
- Stay up-to-date with the latest Lightdash features

<Tip>
For the best experience building and maintaining your semantic layer, we recommend using [agent skills](/guides/developer/agent-skills) instead. Skills provide more targeted context for AI coding agents and are optimized for code generation tasks.
</Tip>

### Setup

The Docs MCP endpoint is available at `https://docs.lightdash.com/mcp`. Add it to your AI coding tool:

<Tabs>
<Tab title="Cursor">
Add to your `.cursor/mcp.json`:

```json
{
"mcpServers": {
"lightdash-docs": {
"url": "https://docs.lightdash.com/mcp"
}
}
}
```
</Tab>
<Tab title="Claude Code">
Run the following command:

```bash
claude mcp add lightdash-docs https://docs.lightdash.com/mcp -t http
```
</Tab>
<Tab title="Windsurf">
Add to your `~/.codeium/windsurf/mcp_config.json`:

```json
{
"mcpServers": {
"lightdash-docs": {
"serverUrl": "https://docs.lightdash.com/mcp"
}
}
}
```
</Tab>
</Tabs>

### Availability

The Docs MCP is free for everyone:

- Open source users
- Cloud Pro
- Cloud Enterprise

No authentication required.

## FAQ

**Q: Does Lightdash MCP store my data or query results?**
Expand Down