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

# Documentation MCP

> Search and query Akua documentation in real-time from any MCP-compatible AI tool

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/akua-1dce587a/3H5lVc027NQakOso/images/heros/docs-mcp-light.svg?fit=max&auto=format&n=3H5lVc027NQakOso&q=85&s=c3fab5f4d57f72b8cf7d2e362222a4de" alt="A question flows into a searchable documentation corpus that needs no authentication, returning an answer grounded in cited documentation pages" width="1536" height="864" data-path="images/heros/docs-mcp-light.svg" />

  <img className="hidden dark:block" src="https://mintcdn.com/akua-1dce587a/3H5lVc027NQakOso/images/heros/docs-mcp-dark.svg?fit=max&auto=format&n=3H5lVc027NQakOso&q=85&s=85bae20957f64954e62dca0cf82044d2" alt="A question flows into a searchable documentation corpus that needs no authentication, returning an answer grounded in cited documentation pages" width="1536" height="864" data-path="images/heros/docs-mcp-dark.svg" />
</Frame>

Agents operating on Akua need context: how products work, what API endpoints are available, how to configure installs. The documentation MCP server gives them real-time access to the full Akua docs, with no authentication required.

```
https://docs.akua.dev/mcp
```

<Info>
  This is the **documentation** MCP server for searching docs. It does not manage your Akua resources and does not require authentication.
</Info>

## What it does

* **Real-time search**: AI tools query Akua documentation as you chat, returning up-to-date answers
* **Zero configuration**: no API keys, no OAuth, no auth at all
* **Any MCP client**: works with Claude, Cursor, VS Code, and any tool that supports MCP

## Try it

Once connected, ask your AI assistant:

```text Example prompts theme={null}
How do I create a new product in Akua?
What's the difference between managed and imported clusters?
How do I set up pricing for my products?
```

<Tip>
  The MCP server returns real-time data from the latest documentation. No stale training data.
</Tip>

For a complete coding-agent setup path, use [Agent Setup](/agent-setup). It connects this documentation server with the authenticated Platform MCP server.

## Other ways AI tools access docs

Beyond the MCP server, Akua provides multiple channels for AI tools:

### Contextual menu

Every documentation page includes a contextual menu with quick actions:

* **Copy page**: copy content as Markdown for pasting into AI tools
* **View as Markdown**: open a Markdown version when the docs host exposes one
* **Open in AI tools**: start a conversation in ChatGPT, Claude, or Perplexity with page context
* **Connect to editors**: one-click MCP setup for Cursor or VS Code

### LLMs.txt files

Industry-standard files for AI indexing:

* **`llms.txt`**: all pages with descriptions for quick reference
* **`llms-full.txt`**: complete documentation in one file

## Troubleshooting

<AccordionGroup>
  <Accordion title="MCP Server Not Connecting">
    * Verify URL: `https://docs.akua.dev/mcp`
    * Check internet connection
    * Ensure your AI tool supports the MCP protocol
    * Try the contextual menu on any doc page for automatic setup
  </Accordion>

  <Accordion title="Configuration Not Loading">
    * Check JSON syntax in config files
    * Verify file permissions and correct file location
    * Restart your AI application after config changes
  </Accordion>

  <Accordion title="Outdated Information">
    * The MCP server always returns real-time data
    * Restart the MCP connection in your tool
    * Clear cached responses in your AI app
  </Accordion>
</AccordionGroup>

## Related topics

<CardGroup cols={2}>
  <Card title="Agent setup" icon="rocket" href="/agent-setup">
    Connect docs and platform context for coding agents.
  </Card>

  <Card title="Platform MCP" icon="server" href="/ai/platform-mcp">
    Give agents authenticated workspace access.
  </Card>

  <Card title="API overview" icon="code" href="/apis/introduction">
    Learn how Akua API authentication, workspace context, and resources fit together.
  </Card>

  <Card title="OpenAPI" icon="file-code" href="/apis/openapi">
    Download the OpenAPI spec used by SDKs, docs, and API explorers.
  </Card>
</CardGroup>
