Escape the Week

com.escapetheweekPublished by escapetheweek.comOfficial publisherv1.0.0Updated Oct 31, 2026

Plan and price Friday-to-Monday city weekends in 42 cities, then get a booking plan.

VerifiedStreamable HTTPWeb executableLocation & LifestyleFinance

Overview

AI-generated overview

Plans and prices Friday-to-Monday city weekends in 42 cities, with itineraries, budget estimates and an ordered booking plan.

What you can do
  • Discover cities, personas, origins, pricing tiers and multipliers, and the index of published itineraries
  • Read a full published itinerary with days, steps, local times, costs, reserve lead times and venue coordinates
  • Estimate budgets per itinerary or across all itineraries by tier, month and group size, and look up cached return fares between airports
  • Export an itinerary as iCalendar text
  • Get a booking checklist and manifest with partner links ordered by scarcity
  • Submit a tip about a city for editor review
When to use it
Useful when someone wants help choosing a city weekend, comparing costs across cities and personas, or turning a published itinerary into a concrete booking order. It suits travel planning conversations rather than general-purpose use.
Requirements
A remote streamable HTTP endpoint; no package, environment variables or headers are declared. No authentication is declared. Network access to the endpoint is needed.
Before you install
Booking links are affiliate-tracked partner URLs, and the server states it never takes payment, so any purchase happens on a partner site and needs the person's approval. Fare data is cached from a third party. submit_tip sends content to the provider for editor review and is rate limited per sender.

Installation

In SourceWeft

  1. Open Escape the Week in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.escapetheweek%2Fpublic/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "escape-the-week": {
      "type": "http",
      "url": "https://escapetheweek.com/mcp/public"
    }
  }
}

Tools

16

list_cities

List the cities that have published weekends, with their slug, IATA airport code, currency and the twelve monthly season factors (1.0 = shoulder season; higher is dearer). Start here to discover city slugs for every other tool. Paged.

Parameterslanglimitoffsetstatus

get_city

Fetch one city by its slug (from list_cities): name, country, region, coordinates, IATA code, currency and the twelve monthly season factors.

Parameterslangslugrequired

list_personas

List the personas (the kind of traveller an itinerary is written for, e.g. foodie or collector) with their slug and audience: party_shapes (solo, couple, friends, family, multigen), children (boolean) and pace (relaxed, steady, brisk). Persona slugs are used with city slugs to name an itinerary. Paged.

Parameterslanglimitoffsetstatus

get_persona

Fetch one persona by its slug (from list_personas), with its audience.

Parameterslangslugrequired

list_origins

List the origins a trip can start from: slug (pass as origin to the pricing and booking tools), name and IATA airport code. Unpaged.

Takes no parameters.

list_pricing_tiers

List the budget tiers in display order (cheap, modest, expensive, luxury, ultra). Pass the name as tier.

Takes no parameters.

list_pricing_multipliers

List every price multiplier: for each (tier, dimension) the factor applied to the modest-tier price. Dimensions are sight, culture, dining, lodging, transport and flight.

Takes no parameters.

list_published_itineraries

The public index: every published itinerary with its city and persona slugs, title, summary, names, step counts and the sum of its steps' costs in integer cents (currency EUR unless the city says otherwise). Use it to discover which (city, persona) weekends exist.

Parameterslang

get_published_itinerary

The full published itinerary for one (city, persona): its days and steps with local times (HH:MM), kind, notes, cost_cents per person at the modest tier (integer cents), reserve_days (how many days ahead a hard step must be booked, or null), a fallback, and each step's venue with coordinates and offers. Day 0 is Friday.

Parameterscityrequiredlangpersonarequired

itinerary_calendar

The published itinerary as iCalendar text for one weekend (Friday = day 0): one event per step at floating local times, no time zone. friday is a YYYY-MM-DD date.

Parameterscityrequiredlangfridayrequiredpersonarequired

estimate_itinerary

Budget estimate (integer cents) for a published itinerary: activities, lodging, transport and flights for a tier, a month or the year average, and a group.

Parameterscityrequiredlangtiermonthfridayoriginpersonarequiredtravellers

estimate_all

Every published itinerary priced at once (integer cents): total, per person and flights per (city, persona), plus the cheapest persona per city, for a tier, a month or the year average, a group and an optional origin; each estimate carries the persona's party_shapes. Estimates only, no fare lookups; cached for a minute per parameter set.

Parameterstiermonthfridayorigintravellers

get_fare

Cheapest known return fare per person between two IATA codes for a Friday-to-Monday weekend (cached from Travelpayouts).

Parameterstorequiredfromrequiredfridayrequired

booking_checklist

Booking links and checklist for a weekend, ordered by scarcity: first the steps that must be booked ahead (longest lead time first, each with reserve_days, a book_by date YYYY-MM-DD and an easier fallback), then flights, the hotel and the other bookable steps. Book in list order. An item's alternatives [{provider, url}] are other sites that book the same thing (the hotel on Klook beside Booking.com): compare them and book one, not both. For a plan an agent can execute (dates, costs, what to ask the person) use booking_manifest instead.

Parameterscityrequiredlangtierfridayrequiredoriginpersonarequiredtravellers

booking_manifest

Everything an agent needs to book one weekend, in the order to book it. Returns items (flights, hotel and bookable steps; scarcest first) each with kind, title, when (date YYYY-MM-DD and local time HH:MM), the affiliate-tracked partner url with dates, party size and time prefilled where the partner supports it, provider, estimated_cost {cents, currency} for the whole party, reserve_days, book_by (YYYY-MM-DD), fallback and alternatives [{provider, url}]: other sites that book the same item (the hotel on Klook beside Booking.com), to compare, booking one of them, never both; plus needs_from_user (traveller names, contact, payment approval), a sequence_note, the total estimate in integer cents, cancellation_advice and a disclosure that the links are affiliate links. Escape the Week never takes payment: open each url in a browser and have the person approve every payment on the partner's site. Prices are estimates, not quotes.

Parameterscityrequiredlangtierpartyfridayrequiredoriginpersonarequiredtravellers

submit_tip

Send a tip about a city: a place to add, a closed place, somewhere nearly impossible to book, or a wrong fact. Public. A tip is never published; an editor reviews it first. Rate limited per sender.

Parametersbodyrequiredcityrequiredkindrequiredlocalecontactpersonastep_ref

Version history

1
  1. v1.0.0LatestOct 31, 2026

Score

83% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.