Skip to main content

​
What is MCP?

The Model Context Protocol (MCP) 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

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

​
Adding a server

akio mcp add --name <NAME> --command <COMMAND> --args <ARGS...>
FlagDescription
--nameA unique friendly name for the server
--commandThe executable used to start the server
--argsArguments 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: 
akio mcp add --name 'browser' --command 'uvx' --args --from 'browser-use[cli]' browser-use --mcp

​
Removing a server

akio mcp remove --name <NAME>
Example: 
akio mcp remove --name browser

​
Example: adding a Node-based MCP server

# 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

See the full akio mcp command reference.