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

> Operate Akua with your coding agent through the CLI and optional MCP servers

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/akua-0b861dc6/o-ywDlh24ZayP_tj/images/heros/ai-index-light.svg?fit=max&auto=format&n=o-ywDlh24ZayP_tj&q=85&s=6ac2acbb6b6d6f7c006ed5dfe9502a2c" 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-0b861dc6/o-ywDlh24ZayP_tj/images/heros/ai-index-dark.svg?fit=max&auto=format&n=o-ywDlh24ZayP_tj&q=85&s=ce489b2b8cc9c261600ab9692c7a9ef3" 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 supports coding agents through the public CLI and optional
[Model Context Protocol (MCP)](https://modelcontextprotocol.io) servers.
These interfaces use the same platform API and workspace access
controls. Start external coding-agent onboarding through the CLI; add MCP when
another tool surface helps the task.

## What you can do

<CardGroup cols={2}>
  <Card title="Agent setup" icon="rocket" href="/agent-setup">
    Install, authenticate, and operate the CLI with optional MCP context.
  </Card>

  <Card title="Hosted agents" icon="robot" href="/agents">
    Check hosted-agent availability before planning an integration.
  </Card>

  <Card title="Documentation MCP" icon="book" href="/ai/docs-mcp">
    Search current Akua docs without authentication from compatible MCP clients.
  </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 drive the CLI quickstart:

```text theme={null}
Fetch https://docs.akua.dev/agent-setup/prompt and complete the Akua CLI
quickstart with me.
```

The prompt tells the agent to ask for your goal, install or update `akua`,
complete browser sign-in, confirm workspace context, and request approval before
consequential actions. Optional MCP setup comes after the CLI path works.

<Tip>
  See [Agent Setup](/agent-setup) for the CLI flow and optional MCP servers.
</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">
    Start with the CLI and add MCP only when useful.
  </Card>

  <Card title="Hosted agents" icon="robot" href="/agents">
    Current availability and supported ways to use your own agent.
  </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>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.