> ## Documentation Index
> Fetch the complete documentation index at: https://0xcat.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Client

> Extend Akio with Model Context Protocol servers.

## What is MCP?

The [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) is an open standard for connecting AI agents to external tools and data sources. Akio can connect to any MCP-compatible server, giving the LLM access to additional capabilities like browser automation, database queries, or custom APIs.

***

## Listing registered servers

```bash theme={null}
akio mcp list
```

This shows all registered MCP servers and the tools each one exposes to the model.

***

## Adding a server

```bash theme={null}
akio mcp add --name <NAME> --command <COMMAND> --args <ARGS...>
```

| Flag | Description |
| - | - |
| `--name` | A unique friendly name for the server |
| `--command` | The executable used to start the server |
| `--args` | Arguments passed to the command |

Akio spawns the server process when starting a session and communicates over stdin/stdout using the MCP protocol.

**Example — browser automation via `browser-use`:**

```bash theme={null}
akio mcp add --name 'browser' --command 'uvx' --args --from 'browser-use[cli]' browser-use --mcp
```

***

## Removing a server

```bash theme={null}
akio mcp remove --name <NAME>
```

**Example:**

```bash theme={null}
akio mcp remove --name browser
```

***

## Example: adding a Node-based MCP server

```bash theme={null}
# Add a server that runs via npx
akio mcp add --name my-server --command npx --args "-y" "my-mcp-package"

# Verify it appears with its tools
akio mcp list

# Start a session — the server's tools are now available to the agent
akio run -m Qwen3-8B-Q4_K_M.gguf
```

***

## Notes

* MCP servers are persisted across sessions — you only need to `add` once.
* Multiple servers can be registered simultaneously; all their tools are merged into the agent's tool set.
* Akio launches each server process fresh at the start of every `akio run` session.

> **[CLI Reference](https://0xcat.mintlify.site/cli.md)**
>
> See the full `akio mcp` command reference.


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