Goliath docs

Goliath is a free, read-only remote MCP server for travel. One connection gives an assistant or agent reviewed travel sources, award-program and transfer rules, and exact arithmetic for comparing quotes.

Server URL
https://goliath.travel/mcp
Authorization
OAuth, approved in your browser. No account, email or API key.
Cost
Free, with a daily search allowance per workspace.
Writes
None. It never books, pays, transfers points or holds a seat.

Connect

Add a remote MCP server in your assistant with this URL, then approve the connection in the browser window it opens.

Server URL
https://goliath.travel/mcp

From a terminal

Codex:

Terminal
codex mcp add goliath --url https://goliath.travel/mcp
codex mcp login goliath

Claude Code:

Terminal
claude mcp add --transport http --scope user goliath https://goliath.travel/mcp

From a config file

Cursor reads ~/.cursor/mcp.json. Merge this entry and keep your other servers:

~/.cursor/mcp.json
{
  "mcpServers": {
    "goliath": {
      "url": "https://goliath.travel/mcp"
    }
  }
}

In the browser

Browser agents that support WebMCP can call three read-only tools on this site: find_travel_sources, get_source_coverage and get_connection_setup. They list sources, coverage and setup steps; searches run through the MCP server.

Guides for each assistant

Each guide has a setup prompt you can paste into the assistant and the manual steps.

To check the connection, ask your assistant to call get_service_status. The Codex connection has been tested from start to finish; the other guides follow each assistant’s published instructions.

Tools

Goliath exposes five read-only tools and one prompt. Nothing here books, pays, transfers points or holds a seat.

ToolWhat it doesCalls out to
get_service_statusLimits, storage policy and a summary of supplier healthNothing
find_sourcesThe reviewed catalogue, award-program coverage, booking guidance, or MCP Registry candidatesRegistry mode only
get_supplier_toolsOne installed supplier’s current tool names and input schemasThat supplier
search_travelA planned search from requirements, a flexible award search, or one to four explicit supplier requestsSuppliers
compare_quotesExact arithmetic on quotes the assistant already hasNothing

The plan_trip prompt is a full planning walkthrough. A sixth tool, connect_seats_aero, appears only when the operator has registered a Seats.aero app; it links or unlinks the traveler’s own Seats.aero account.

The assistant keeps the planning context. There are no trip, saved-search or result-polling tools.

Replies and offers

Every tool returns one JSON text block; parse content[0].text. A search_travel reply holds status, results, warnings, planned_requests, omitted_requests, next_offset and result_budget.

Each result names its supplier_id, the native tool, the exact request, and a status of completed, failed or skipped. Failures stay in the reply. For suppliers whose response shape has been reviewed, a result also carries offers in one common shape:

goliath.offer.v1
{
  "schema": "goliath.offer.v1",
  "count": 1,
  "recognized_rows": 1,
  "items": [{
    "kind": "cash_flight", "basis": "itinerary",
    "origin": "JFK", "destination": "LIS",
    "departure": "2026-11-20T18:05", "return_date": null,
    "trip_type": "one_way", "cabin": "economy", "stops": 0, "flights": ["TP202"],
    "cash": { "amount": 412, "currency": "USD", "taxes_included": true },
    "points": null,
    "price_scope": "whole_party", "passengers": 2,
    "freshness": "live", "link": "https://...", "link_kind": "search",
    "source_pointer": "/flights/0"
  }]
}
  • basis is an itinerary, one calendar_day of a fare calendar, or a published_fare card.
  • Amounts are exactly as the source reported them: never converted, summed or checked at checkout. null means the source didn’t state it.
  • link opens the page where the option is booked or checked, and link_kind says which page it is: booking (the seller’s own booking page with the route and date filled in), search (a search page that lists it) or source (the source’s page about the fare).
  • source_pointer locates the original row in the supplier response, which is kept alongside the offers.
  • A reply’s status is completed, partial, failed, needs_requirements, unavailable or exhausted. completed means the calls answered, not that coverage was complete.

Interactive results

In assistants that support MCP Apps, such as Claude and ChatGPT, search_travel also shows its reply as a table: the ui://goliath/search-results.html resource, named in the tool’s _meta.ui.resourceUri. Each option sits on one row with its source and freshness, the rows sort by price, points, duration or departure, and each row’s Book or View button opens its link in the traveler’s browser: Book for a seller’s booking page, View for any other page. The table reads the same JSON reply and adds nothing to it; assistants without MCP Apps get the JSON alone.

Freshness

Every price carries one of three labels.

Live
Asked just now, while your assistant waited.
Cached
Seen earlier, with its age. Used when a live search isn’t possible.
Published
An award chart, transfer table or rules page the program publishes itself.
  • prefer_live, the default, tries the source first. If that fails with an availability, timeout, rate-limit or response error, an unexpired public snapshot may come back with an explicit fallback label.
  • live_only never reads or writes Goliath’s fallback cache, and reports what it couldn’t search instead.
  • The shared fallback store holds at most 200 entries. Cached award snapshots expire after 36 hours and public references after 72 hours.
  • checked_at is when Goliath retrieved a result. It never replaces a supplier’s own timestamps.
  • Empty cached results and unavailable providers don’t prove that no award seats exist.

Comparing quotes

compare_quotes does exact arithmetic on quotes your assistant already has: total cost, value per point with your own point values, and journeys that mix trains, flights and other legs.

It checks route continuity, timestamps, passenger scope, freshness and connection requirements. A candidate with unknown facts is left out of the ranking rather than filled in with guesses. It never makes a points transfer.

Limits

  • Each workspace can make 20 search_travel calls a day, and each call makes at most four supplier requests. A page with nothing left to search uses no allowance.
  • Each source has its own quotas, and your assistant’s plan still applies.
  • Live award coverage is limited. Confirm the seat, taxes and transfer eligibility with the airline before you move points; transfers usually can’t be undone.

Errors

Errors use the same single JSON block with isError: true:

Error
{ "error": { "code": "VALIDATION_ERROR", "message": "Invalid input",
  "issues": [{ "path": ["searches", 0, "tool"], "message": "..." }] } }

Unexpected failures return INTERNAL_ERROR with a reference that matches a log line. No internal detail is returned.

Privacy

Goliath keeps a random workspace ID, sign-in tokens for your assistant, usage counters and supplier health. It keeps no record of your trips. Some search details and results go into shared caches of public prices, with nothing that says who asked.

Selected suppliers receive the search arguments meant for them. Your assistant and each supplier have their own data policies. The privacy page lists everything Goliath stores and for how long.