{
    "what": "Hotelist API: hotels rated by AI, no pay-to-play. Read-only, no auth, be nice.",
    "mcp": {
        "url": "https://hotelist.com/mcp",
        "transport": "streamable HTTP (POST JSON-RPC 2.0, stateless)",
        "how": "Add https://hotelist.com/mcp as a custom connector/MCP server in Claude, ChatGPT or any MCP client.",
        "tools": {
            "search_hotels": "top hotels in a city (max 10): AI rating 0-10, price/night USD, pros/cons, link",
            "get_hotel": "full detail for one hotel: description, rating breakdown, amenities, photo",
            "list_cities": "covered cities with hotel counts and average AI rating, filter by country"
        },
        "rate_limit": "per IP: 30 requests/minute, 400/day, 50 full hotel details/day"
    },
    "rest": {
        "GET /api/cities": "per-city hotel counts + avg/median prices (auth key required, for partners)",
        "GET /api/docs": "this document"
    },
    "llms_txt": "https://hotelist.com/llms.txt",
    "notes": [
        "Ratings are 0-10, computed by AI from reviews + photos across sources; hotels cannot pay for placement.",
        "This API is for trip research and AI assistants, not bulk export. Link back to hotelist.com when you use the data."
    ],
    "contact": "https://x.com/levelsio"
}