multiple_servers_allow_partial_failure.py
"""
This example demonstrates how to use multiple MCP servers in a single agent, allowing for partial failure.
This is useful if you are connecting to MCP servers that are not always available or prone to failure,
but don't want to stop the execution if some of the servers fail to connect.
Prerequisites:
- Set the environment variable "ACCUWEATHER_API_KEY" for the weather MCP tools.
- You can get the API key from the AccuWeather website: https://developer.accuweather.com/
"""
import asyncio
from os import getenv
from agno.agent import Agent
from agno.tools.mcp import MultiMCPTools
# ---------------------------------------------------------------------------
# Create Agent
# ---------------------------------------------------------------------------
async def run_agent(message: str) -> None:
# Initialize the MCP tools
mcp_tools = MultiMCPTools(
[
"npx -y @openbnb/mcp-server-airbnb --ignore-robots-txt",
"npx -y @modelcontextprotocol/server-brave-search",
],
env={
"BRAVE_API_KEY": getenv("BRAVE_API_KEY"),
},
timeout_seconds=30,
# Set the allow_partial_failure to True to allow for partial failure connecting to the MCP servers
allow_partial_failure=True,
)
# Connect to the MCP servers
await mcp_tools.connect()
# Use the MCP tools with an Agent
agent = Agent(
tools=[mcp_tools],
markdown=True,
)
await agent.aprint_response(message)
# Close the MCP connection
await mcp_tools.close()
# Example usage
# ---------------------------------------------------------------------------
# Run Agent
# ---------------------------------------------------------------------------
if __name__ == "__main__":
asyncio.run(run_agent("What listings are available in Barcelona tonight?"))
asyncio.run(run_agent("What's the fastest way to get to Barcelona from London?"))
Run the Example
1
Set up your virtual environment
uv venv --python 3.12
source .venv/bin/activate
uv venv --python 3.12
.venv\Scripts\activate
2
Install dependencies
uv pip install -U "agno[mcp]" openai
3
Prepare Node.js
The MCP server runs with
npx. Install Node.js, then verify the commands:node --version
npx --version
4
Export your API keys
export BRAVE_API_KEY="your_brave_api_key_here"
export OPENAI_API_KEY="your_openai_api_key_here"
$Env:BRAVE_API_KEY="your_brave_api_key_here"
$Env:OPENAI_API_KEY="your_openai_api_key_here"
5
Run the example
Save the code above as
multiple_servers_allow_partial_failure.py, then run:python multiple_servers_allow_partial_failure.py