Stop Talking to AI.
Start Building With It.

curl -X POST "http://localhost:8000/message" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}'

async def get_random_fact(category: str = "general") -> Dict[str, Any]:
    """Because every AI needs useless trivia."""
    facts = {
        "general": [
            "Honey never spoils. 3000-year-old honey found in Egyptian tombs — still edible.",
            "Octopuses have three hearts."
        ],
        "space": [
            "A day on Venus is longer than its year.",
            "Neutron stars are so dense a teaspoon weighs 6 billion tons."
        ]
    }
    import random
    return {
        "category": category,
        "fact": random.choice(facts.get(category, facts["general"])),
        "timestamp": datetime.now().isoformat()
    }

{
    "name": "get_random_fact",
    "description": "Get a random interesting fact",
    "inputSchema": {
        "type": "object",
        "properties": {
            "category": {
                "type": "string",
                "enum": ["general", "space"],
                "description": "Category of fact"
            }
        },
        "required": ["category"]
    }
}

elif tool_name == "get_random_fact":
    result = await get_random_fact(arguments.get("category", "general"))
    return {
        "content": [{"type": "text", "text": json.dumps(result)}],
        "isError": False
    }

async def get_news(topic: str, language: str = "en") -> Dict[str, Any]:
    """Fetch real news from NewsAPI."""
    api_key = os.getenv("NEWS_API_KEY")
    if not api_key:
        return {"isError": True, "content": [{"type": "text", "text": "NEWS_API_KEY not set"}]}

    async with httpx.AsyncClient() as client:
        response = await client.get(
            "https://newsapi.org/v2/everything",
            params={"q": topic, "language": language, "apiKey": api_key},
            timeout=10.0
        )

    articles = response.json().get("articles", [])[:3]
    formatted = "\n".join([f"• {a['title']}\n  {a['url']}" for a in articles])

    return {
        "isError": False,
        "content": [{"type": "text", "text": f"Latest on '{topic}':\n\n{formatted}"}]
    }

curl http://localhost:8000/health  # MCP Server
curl http://localhost:8001/health  # Agent
curl http://localhost:8080/health  # Web

# Check if the agent loaded your tools
docker compose logs travel-agent | grep "tools"

# Remember user preferences
user_prefs = {}

async def set_preference(user_id: str, key: str, value: str):
    user_prefs.setdefault(user_id, {})[key] = value
    return {"status": "saved", "key": key, "value": value}

# Chain tools: weather → attractions → booking
async def plan_trip(destination: str):
    weather = await get_weather_forecast(destination)
    if weather["current"]["temp"] > 20:
        attractions = await get_outdoor_attractions(destination)
    else:
        attractions = await get_indoor_attractions(destination)
    return {"weather": weather, "suggestions": attractions}