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:

| Tool | Description | |------|-------------| | list_agno_sections | List all available documentation sections with their slugs and URLs | | get_agno_page | Fetch the full content of a documentation page by slug or URL | | search_agno_docs | Keyword search across the catalog — returns matching slugs without fetching pages |

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

License

MIT