MCP Tools Advanced Example

AgentOS handles the lifespan of the MCPTools internally.

This example uses the deprecated @modelcontextprotocol/server-brave-search package in its active and commented MCP configurations. Replace both occurrences with Brave’s maintained MCP server before running. See Brave Search MCP Server.

mcp_tools_advanced_example.py

"""
Example AgentOS app where the agent has MCPTools.

AgentOS handles the lifespan of the MCPTools internally.
"""

from os import getenv

from agno.agent import Agent
from agno.db.sqlite import SqliteDb
from agno.models.anthropic import Claude
from agno.os import AgentOS
from agno.tools.mcp import MCPTools  # noqa: F401

# ---------------------------------------------------------------------------
# Create Example
# ---------------------------------------------------------------------------

# Setup the database
db = SqliteDb(db_file="tmp/agentos.db")

agno_mcp_tools = MCPTools(transport="streamable-http", url="https://docs.agno.com/mcp")

# Example: Brave Search MCP server
brave_mcp_tools = MCPTools(
    command="npx -y @modelcontextprotocol/server-brave-search",
    env={
        "BRAVE_API_KEY": getenv("BRAVE_API_KEY"),
    },
    timeout_seconds=60,
)

# You can also use MultiMCPTools to connect to multiple MCP servers at once:
#
# from agno.tools.mcp import MultiMCPTools
# mcp_tools = MultiMCPTools(
#     commands=["npx -y @modelcontextprotocol/server-brave-search"],
#     urls=["https://docs.agno.com/mcp"],
#     env={"BRAVE_API_KEY": getenv("BRAVE_API_KEY")},
# )

# Setup ai framework agent
ai_framework_agent = Agent(
    id="agno-support-agent",
    name="Agno Support Agent",
    model=Claude(id="claude-sonnet-4-5"),
    db=db,
    tools=[brave_mcp_tools, agno_mcp_tools],
    add_history_to_context=True,
    num_history_runs=3,
    markdown=True,
)

agent_os = AgentOS(
    description="Example app with MCP Tools",
    agents=[ai_framework_agent],
)


app = agent_os.get_app()

# ---------------------------------------------------------------------------
# Run Example
# ---------------------------------------------------------------------------

if __name__ == "__main__":
    """Run your AgentOS.

    You can see test your AgentOS at:
    http://localhost:7777/docs

    """
    # Don't use reload=True here, this can cause issues with the lifespan
    agent_os.serve(app="mcp_tools_advanced_example:app")

Run the Example

Set up your virtual environment

uv venv --python 3.12
source .venv/bin/activate

uv venv --python 3.12
.venv\Scripts\activate

Install dependencies

uv pip install -U "agno[mcp,os]" anthropic

Prepare Node.js

The maintained Brave MCP server requires Node.js 22 or later. Install it, then confirm node --version reports v22 or later and npx is available:

node --version
npx --version

Export your API keys

export ANTHROPIC_API_KEY="your_anthropic_api_key_here"
export BRAVE_API_KEY="your_brave_api_key_here"

$Env:ANTHROPIC_API_KEY="your_anthropic_api_key_here"
$Env:BRAVE_API_KEY="your_brave_api_key_here"

Update both Brave MCP commands

Replace both occurrences of npx -y @modelcontextprotocol/server-brave-search with npx -y @brave/brave-search-mcp-server --transport stdio in the saved file.

Run the example

Save the code above as mcp_tools_advanced_example.py, then run:

python mcp_tools_advanced_example.py

Full source: cookbook/05_agent_os/mcp_demo/mcp_tools_advanced_example.py

Examples

Primitives

Context

Models

Tools

More

MCP Tools Advanced Example

Run the Example

​Run the Example

Run the Example