git clone https://github.com/agno-agi/agno-docs-mcp
cd agno-docs-mcp

python3 -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Upgrade pip first (required for pyproject.toml editable installs)
pip install --upgrade pip

# Install the package in editable mode with dev dependencies
pip install -e ".[dev]"

# Clone the agno-docs repository (adjust path as needed)
git clone https://github.com/agno-agi/agno-docs ~/Work/agno-docs

# Set the path to your agno-docs repository
export AGNO_DOCS_PATH=~/Work/agno-docs

# Run the preparation script to copy and index docs
python -m agno_docs_mcp.prepare

Preparing Agno documentation...
  Source: /Users/you/Work/agno-docs
  Output: /Users/you/Work/agno-docs-mcp/.docs

Copying documentation files...
  Copied 596 files from basics/
  Copied 148 files from reference/
  Copied 74 files from reference-api/
  ...
  Copied OpenAPI spec (openapi.json)

Building search index...
  Indexed 1851 files in 10 categories

Done!

{
  "mcpServers": {
    "agno-docs": {
      "command": "/path/to/agno-docs-mcp/.venv/bin/python",
      "args": ["-m", "agno_docs_mcp"]
    }
  }
}

{
  "mcpServers": {
    "agno-docs": {
      "command": "/path/to/agno-docs-mcp/.venv/bin/python",
      "args": ["-m", "agno_docs_mcp"]
    }
  }
}

{
  "mcpServers": {
    "agno-docs": {
      "url": "http://localhost:8000/mcp",
      "transport": "streamable-http"
    }
  }
}

# Test the server directly
python -c "from agno_docs_mcp.tools.api import agno_api; print(agno_api('memory')[:200])"

# Or start the HTTP server
python -m agno_docs_mcp --transport http --port 8000

# In another terminal, test with curl
curl -X POST http://localhost:8000/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

# Activate venv first
source .venv/bin/activate

# Run with stdio transport (for Claude Code, Cursor)
python -m agno_docs_mcp

# Run HTTP server on port 8000
python -m agno_docs_mcp --transport http --port 8000

# Server available at http://localhost:8000/mcp
# Health check at http://localhost:8000/health

# Using uvicorn directly
uvicorn agno_docs_mcp.app:app --host 0.0.0.0 --port 8000

# Using Docker
docker build -t agno-docs-mcp .
docker run -p 8000:8000 agno-docs-mcp

agno_api(resource="memory")

agno_docs(path="basics/agents/")

agno_reference(topic="agents")

agno_examples(category="agents")

agno_integrations(integration_type="database", name="postgres")

agno_agentos(path="features/memories")

agno_migration(topic="v2-migration")

agno-docs-mcp/
├── pyproject.toml
├── README.md
├── .venv/                      # Virtual environment
├── src/
│   └── agno_docs_mcp/
│       ├── __init__.py
│       ├── __main__.py
│       ├── server.py           # Main MCP server with tool registration
│       ├── app.py              # FastAPI/ASGI app for HTTP
│       ├── tools/              # Tool implementations
│       │   ├── docs.py
│       │   ├── reference.py
│       │   ├── examples.py
│       │   ├── integrations.py
│       │   ├── agentos.py
│       │   ├── api.py          # NEW: OpenAPI parser
│       │   └── migration.py
│       ├── utils/              # Utility modules
│       │   ├── search.py
│       │   ├── paths.py
│       │   └── content.py
│       └── prepare/            # Doc preparation
│           └── prepare_docs.py
├── .docs/                      # Preprocessed docs (generated)
│   ├── raw/                    # Copied MDX files
│   ├── snippets/               # Snippet files
│   ├── index.json              # Search index
│   └── openapi.json            # OpenAPI spec
└── tests/

# Pull latest docs
cd ~/Work/agno-docs
git pull

# Re-run preparation
cd ~/Work/agno-docs-mcp
source .venv/bin/activate
python -m agno_docs_mcp.prepare

export AGNO_DOCS_PATH=~/Work/agno-docs
python -m agno_docs_mcp.prepare

source .venv/bin/activate
which python  # Should show .venv/bin/python