mcp-agno

An MCP (Model Context Protocol) server that gives AI assistants direct access to the AGNO framework documentation.

Instead of crawling docs manually or relying on outdated training data, Claude and other MCP-compatible clients can browse, fetch, and search AGNO docs in real time.

What it does

Exposes three MCP tools:

On startup the server seeds a catalog of core sections (Introduction, Agents, Teams, Workflows, AgentOS) and auto-discovers additional pages from the live AGNO sitemap.

Requirements

• Python 3.11+

• uv (recommended) or pip

Installation

With uv (recommended)

git clone https://github.com/Attilio81/MCP_AGNO.git
cd MCP_AGNO
uv pip install -e .

With pip

git clone https://github.com/Attilio81/MCP_AGNO.git
cd MCP_AGNO
pip install -e .

This installs the mcp-agno command.

Usage with Claude Desktop

Add the server to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "agno-docs": {
      "command": "mcp-agno"
    }
  }
}

If you installed with uv in a virtual environment, use the full path:

{
  "mcpServers": {
    "agno-docs": {
      "command": "/path/to/venv/bin/mcp-agno"
    }
  }
}

Restart Claude Desktop. The three tools will appear automatically.

Usage with Claude Code (CLI)

claude mcp add agno-docs mcp-agno

Or add it to your project's .mcp.json:

{
  "mcpServers": {
    "agno-docs": {
      "command": "mcp-agno"
    }
  }
}

Running manually (for testing)

mcp-agno

The server runs over stdio and waits for MCP messages.

Development

git clone https://github.com/Attilio81/MCP_AGNO.git
cd MCP_AGNO
uv pip install -e ".[dev]"
pytest

Resources

• AGNO Documentation — official docs browsed by this server

• AGNO Cookbook — practical examples and ready-to-run recipes from the AGNO team

License

MIT