diff --git a/references/integrations/lightdash-mcp.mdx b/references/integrations/lightdash-mcp.mdx
index 44ea0356..52699887 100644
--- a/references/integrations/lightdash-mcp.mdx
+++ b/references/integrations/lightdash-mcp.mdx
@@ -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?**