> ## 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.

# AI & Agents

> Connect coding agents to Akua through MCP servers, or use hosted agents for guided deployment and operations

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/akua-1dce587a/AEEz0U2s7Do2sYaM/images/heros/ai-index-light.svg?fit=max&auto=format&n=AEEz0U2s7Do2sYaM&q=85&s=3775032642860c30607d3092d49e896d" alt="An MCP client connecting through two servers — a no-auth documentation server and an OAuth platform server — that opens onto Akua clusters, Kubernetes, installation repositories, and dashboards" width="1536" height="864" data-path="images/heros/ai-index-light.svg" />

  <img className="hidden dark:block" src="https://mintcdn.com/akua-1dce587a/AEEz0U2s7Do2sYaM/images/heros/ai-index-dark.svg?fit=max&auto=format&n=AEEz0U2s7Do2sYaM&q=85&s=15b7af66357bdad113607a638d5ec10f" alt="An MCP client connecting through two servers — a no-auth documentation server and an OAuth platform server — that opens onto Akua clusters, Kubernetes, installation repositories, and dashboards" width="1536" height="864" data-path="images/heros/ai-index-dark.svg" />
</Frame>

Akua is built for agentic operations. You can use hosted agents for guided deployment and operations work, or connect your own coding agent through the [Model Context Protocol (MCP)](https://modelcontextprotocol.io). Both paths use the same platform API, workspace controls, and operational context.

## What you can do

<CardGroup cols={2}>
  <Card title="Agent setup" icon="rocket" href="/agent-setup">
    Configure docs and platform MCP context before changing workspace resources.
  </Card>

  <Card title="Hosted agents" icon="robot" href="/agents">
    Use the embedded dashboard agent or configure workspace agents that investigate, propose, and automate operations inside Akua.
  </Card>

  <Card title="Documentation MCP" icon="book" href="/ai/docs-mcp">
    Search and query Akua docs in real-time. No authentication required. Works out of the box with any MCP client.
  </Card>

  <Card title="Platform MCP" icon="server" href="/ai/platform-mcp">
    Manage clusters, products, and installs via the Akua API from external AI tools. Uses OAuth 2.1 and sandboxed Code Mode.
  </Card>

  <Card title="Installation repositories" icon="folder-tree" href="/ai/repo-agents">
    How agents read, prepare, and review changes to Akua installations through their git repositories.
  </Card>

  <Card title="Kubernetes access" icon="dharmachakra" href="/ai/kubernetes-access">
    Give agents direct access to cluster resources through the Kubernetes API proxy and command execution.
  </Card>
</CardGroup>

## Quick setup

Ask your coding agent to fetch the setup prompt:

```text theme={null}
Fetch https://docs.akua.dev/agent-setup/prompt and follow it for this workspace.
```

The prompt handles client-specific setup and tells the agent to start with read-only workspace discovery.

<Tip>
  See [Agent Setup](/agent-setup) for server details, manual setup, and the safe first workspace prompt.
</Tip>

## Beyond MCP

Akua's AI integration goes beyond MCP servers:

* **Contextual menu**: every doc page offers copy-as-markdown, open-in-AI, and one-click editor setup
* **llms.txt**: industry-standard files (`llms.txt` and `llms-full.txt`) for AI indexing
* **Agent setup prompt**: use [Agent Setup](/agent-setup) for agent-readable setup instructions

## Related topics

<CardGroup cols={2}>
  <Card title="Agent setup" icon="rocket" href="/agent-setup">
    Connect docs and platform MCP servers safely.
  </Card>

  <Card title="Hosted agents" icon="robot" href="/agents">
    The embedded dashboard agent and the full agent product model.
  </Card>

  <Card title="Platform MCP" icon="server" href="/ai/platform-mcp">
    How Code Mode gives agents full API access in a sandboxed V8 isolate.
  </Card>

  <Card title="Examples" icon="sparkles" href="/ai/examples/parallel-log-analysis">
    See agents in action: log analysis, security audits, and more.
  </Card>
</CardGroup>