From 50cba9532d2fd30a21b3d02d75856c334ae9818a Mon Sep 17 00:00:00 2001
From: Tim Holm <timothy.j.holm@gmail.com>
Date: Tue, 21 Oct 2025 13:32:07 +1100
Subject: [PATCH 1/2] docs(docs): add mcp integration guide for suga docs mcp
 server

---
 docs/docs.json                  |   1 +
 docs/guides.mdx                 |   8 ++
 docs/guides/mcp-integration.mdx | 145 ++++++++++++++++++++++++++++++++
 3 files changed, 154 insertions(+)
 create mode 100644 docs/guides/mcp-integration.mdx

diff --git a/docs/docs.json b/docs/docs.json
index 5d7eb2ee..43767fbd 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -30,6 +30,7 @@
             "pages": [
               "guides",
               "guides/add-suga",
+              "guides/mcp-integration",
               "guides/build-platform",
               "guides/database-migration",
               "guides/terraform-backend-config",
diff --git a/docs/guides.mdx b/docs/guides.mdx
index 885ca1a1..aa4fb9b8 100644
--- a/docs/guides.mdx
+++ b/docs/guides.mdx
@@ -18,6 +18,14 @@ These guides provide practical, hands-on instructions for implementing common in
     Step-by-step guide to add Suga infrastructure management to your existing
     applications.
   </Card>
+  <Card
+    title="Add Suga Docs to Your AI Agent"
+    icon="robot"
+    href="/guides/mcp-integration"
+  >
+    Connect the Suga documentation MCP server to your coding agents for real-time
+    documentation access.
+  </Card>
   <Card
     title="Database Migrations"
     icon="database"
diff --git a/docs/guides/mcp-integration.mdx b/docs/guides/mcp-integration.mdx
new file mode 100644
index 00000000..0422513f
--- /dev/null
+++ b/docs/guides/mcp-integration.mdx
@@ -0,0 +1,145 @@
+---
+title: 'Add Suga Docs to Your AI Agent'
+description: 'Connect the Suga documentation MCP server to your coding agents for real-time documentation access'
+---
+
+## Overview
+
+Suga's documentation is available through a [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server, enabling AI coding agents to query our documentation in real-time. This integration allows your AI tools to provide accurate, up-to-date information about Suga without manually copying documentation into context windows.
+
+## MCP Server URL
+
+The Suga documentation MCP server is hosted at:
+
+```
+https://docs.addsuga.com/mcp
+```
+
+This server provides:
+- **Documentation Search**: Query all Suga documentation, guides, and CLI references
+- **Real-time Access**: Always get the latest documentation without manual updates
+
+## Integration Guides
+
+Follow the instructions below for your preferred coding agent:
+
+<Tabs>
+<Tab title="Claude Code">
+
+Claude Code supports MCP servers through a simple CLI command:
+
+```bash
+claude mcp add --transport http suga-docs https://docs.addsuga.com/mcp
+```
+
+This adds the Suga documentation server to your Claude Code configuration.
+
+**Verify Installation**
+
+Check that the server was added successfully:
+
+```bash
+claude mcp list
+```
+
+You should see `suga-docs` in the list of available MCP servers.
+
+**Usage**
+
+Once configured, Claude Code can automatically query Suga documentation when you ask questions about Suga features, CLI commands, or implementation patterns.
+
+Example queries:
+- "How do I set up database migrations in Suga?"
+- "What are the available Suga CLI commands for managing environments?"
+- "Show me how to configure a custom platform in Suga"
+
+**Project-Specific Configuration**
+
+To share this configuration with your team, add it to your project's `.mcp.json` file:
+
+```json
+{
+  "mcpServers": {
+    "suga-docs": {
+      "url": "https://docs.addsuga.com/mcp"
+    }
+  }
+}
+```
+
+Commit this file to your repository so all team members can access the Suga documentation MCP server.
+
+**Documentation**: [Claude Code MCP Guide](https://docs.claude.com/en/docs/claude-code/mcp)
+
+</Tab>
+
+<Tab title="Cursor">
+
+**Adding to Cursor**
+
+1. Open Cursor Settings (`Cmd/Ctrl + ,`)
+2. Navigate to **Features** > **Model Context Protocol**
+3. Click **Add MCP Server**
+4. Configure the server:
+
+```json
+{
+  "mcpServers": {
+    "suga-docs": {
+      "url": "https://docs.addsuga.com/mcp"
+    }
+  }
+}
+```
+
+5. Save and restart Cursor
+
+**Usage in Cursor**
+
+Once configured, you can reference Suga documentation in your Cursor conversations:
+
+- Use `Cmd+K` or `Ctrl+K` to open the composer
+- Ask questions about Suga features and the AI will query the documentation
+- The MCP server provides context automatically when relevant
+
+**Documentation**: [Cursor MCP Guide](https://docs.cursor.com/context/model-context-protocol)
+
+</Tab>
+
+
+<Tab title="Windsurf">
+
+**Adding to Windsurf**
+
+1. Open Windsurf Settings
+2. Navigate to **MCP Servers**
+3. Click **Add Server**
+4. Enter the configuration:
+
+```json
+{
+  "mcpServers": {
+    "suga-docs": {
+      "serverUrl": "https://docs.addsuga.com/mcp"
+    }
+  }
+}
+```
+
+5. Save and restart Windsurf
+
+**Usage in Windsurf**
+
+Windsurf's Cascade AI will automatically query the Suga documentation when you ask about Suga-related topics.
+
+**Documentation**: [Windsurf MCP Integration Guide](https://docs.windsurf.com/windsurf/cascade/mcp)
+
+</Tab>
+
+</Tabs>
+
+## Learn More
+
+- [Model Context Protocol Documentation](https://modelcontextprotocol.io)
+- [Suga CLI Reference](/cli)
+- [Suga Quickstart Guide](/quickstart)

From 9739bb770eff79882dbea34568ebfe8d4b3fc3eb Mon Sep 17 00:00:00 2001
From: Tim Holm <timothy.j.holm@gmail.com>
Date: Wed, 22 Oct 2025 08:53:55 +1100
Subject: [PATCH 2/2] chore(docs): add mcpServers as accepted spelling for vale

---
 docs/.vale/styles/config/vocabularies/Suga/accept.txt | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/.vale/styles/config/vocabularies/Suga/accept.txt b/docs/.vale/styles/config/vocabularies/Suga/accept.txt
index d74d8430..053cd61e 100644
--- a/docs/.vale/styles/config/vocabularies/Suga/accept.txt
+++ b/docs/.vale/styles/config/vocabularies/Suga/accept.txt
@@ -32,6 +32,7 @@ resource_group_name
 storage_account_name
 container_name
 tfstatestorage
+mcpServers
 
 # Defaults from mintlify
 Mintlify