Developers

Connect via MCP

A Day Done Well exposes its 390-itinerary library via the Model Context Protocol. Connect from Claude Desktop, ChatGPT desktop, or any MCP client. Sign up free for an API key — 500 calls/month included.

Get started

Sign up free for an API key — 500 calls/month included, no card required.

Connection

Server URL: https://adaydonewell.com/api/mcp

Transport: Streamable HTTP. Legacy SSE also available at /api/sse.

Pass your API key in the Authorization header. Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "adaydonewell": {
      "url": "https://adaydonewell.com/api/mcp",
      "headers": {
        "Authorization": "Bearer addw_YOUR_KEY_HERE"
      }
    }
  }
}

Tools

list_countries(tag?)
Browse countries, optionally filter by theme.
list_cities(country?, tag?)
Browse cities, optionally filter by country and theme.
search_itineraries(city, themes?, sort?, limit?, offset?)
Find itineraries in a city. Sort by votes or recency. Paginated.
get_itinerary(id)
Full plan with stops, addresses, ratings, walking routes, and affiliate links.
get_featured(count?)
Top picks (votes + freshness boost). Max 1 per city for variety.
get_city(slug)
City detail with image, top 3 itineraries, and aggregated tags.
get_country(slug)
Country detail with image, city list, aggregated tags, and total upvotes.

Examples

  • "What's a good day in Tokyo?"

    → search_itineraries({ city: "Tokyo" })

  • "Find food-focused city days in Italy"

    → list_cities({ country: "italy", tag: "food" })

  • "Give me the full Lisbon bakery itinerary"

    → get_itinerary({ id: "..." })

Learn more