Trips logo

Trips

Creates private, editable trip-map links from conversational travel plans, with tools to build, update, decode, and read itineraries.

Install Trips

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "trips": {
      "command": "npx",
      "args": [
        "-y",
        "thistripbtw-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 6 tools correctly (4d ago).

Overview

The trips MCP server turns conversational travel plans into private, editable map links. It provides tools to resolve places, build and amend draft itinerary URLs, decode them, and read or update kept trips. Draft-link operations work without a network connection, while place lookup and kept-trip access use thistripbtw.us. Reach for it when an agent needs to give someone a shareable itinerary without requiring an account.

Use cases

  • Build a shareable map from an origin and destination
  • Update an itinerary as plans change
  • Resolve place names before creating trip legs
  • Read a draft or kept trip into structured itinerary data
  • Add a stop to a kept trip with an edit phrase

Key features

  • Private editable trip-map links
  • Place lookup with coordinates
  • Draft link creation and amendment
  • Itinerary decoding
  • Kept-trip reading and editing
  • Offline draft-link operations

Tools6

What Trips lets your agent do. Expand a tool for its parameters.

Verified live~3.6k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

6/6 checks healthy over the last 44d

What it can do

From the 6 tools this server returned when we ran it; 6 declare their own safety hints.

Handles credentials · 4Makes network requests · 4Read-only tools · 6
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age78 days
Maintainers1

Observed 2026-10-19 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 7d ago via OSV.dev · thistripbtw-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads834Package downloads in the last 30 days.
Last commit23d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed6Callable tools this server registers over MCP.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How Trips works

What trips MCP server does

The trips MCP server gives an AI assistant a way to turn an itinerary into a private map URL. A draft can start as soon as the assistant knows an origin and one destination, then be updated as the conversation adds dates, transport, travelers, lodging, notes, or additional legs. The recipient can open and edit the resulting map without creating an account.

The server exposes six tools: find_place, build_trip_link, amend_trip_link, read_trip_link, read_kept_trip, and add_to_kept_trip. Together, they cover both draft itineraries stored in a URL and trips that a person has kept on the service.

Tools and capabilities

  • find_place returns up to six candidate places with names, coordinates, and location context. It accepts place names, airports, IATA codes, parks, towns, and cities.
  • build_trip_link creates a URL from an origin and ordered legs. Coordinates are required; the tool does not infer them.
  • amend_trip_link changes an existing draft by appending, updating, replacing, or removing legs, or changing the trip name and origin.
  • read_trip_link decodes a draft URL into the itinerary shape accepted by build_trip_link.
  • read_kept_trip retrieves the itinerary associated with a kept-trip URL and its edit or view phrase.
  • add_to_kept_trip adds a stop to a kept trip when the caller supplies the required edit phrase.

Legs can include transport mode, date, note, travelers, subtype, craft, flight number, lodging, and a lodging note. Supported modes include driving, flying, trains, ferries, water travel, cycling, and walking. A leg can also identify the track for a particular vehicle or person when a trip separates and later rejoins.

How it works

Draft trips carry their data in the URL, so building, amending, and reading a draft does not require a network request. read_trip_link returns structured itinerary data rather than asking the assistant to parse the URL itself. Draft links use the #d= form.

Place resolution is the network-dependent lookup for draft workflows. It queries thistripbtw.us, which uses a cache in front of a paced OpenStreetMap lookup. The service states that place lookup does not send personal information.

Kept trips work differently: their contents remain on the service, while the #k= fragment acts as a credential. Reading or modifying one sends the phrase to thistripbtw.us over TLS. A kept link should therefore be treated as a secret, and phrases should not be guessed. The server makes one attempt for a refused phrase and reports the refusal.

Setup and configuration

The hosted endpoint is https://thistripbtw.us/mcp and uses Streamable HTTP. It requires no API key or sign-up. A client that accepts an MCP URL can connect directly.

For local use, the package requires Node.js 18 or newer and can be started through npm without additional dependencies:

Terminal
claude mcp add thistripbtw -- npx -y thistripbtw-mcp

The standalone thistripbtw-mcp.mjs file can also be downloaded and run with Node. Claude Desktop can use either the npm command or the downloaded file in its MCP configuration. Run npx -y thistripbtw-mcp --selftest to perform the local self-test; it does not use the network or require configuration.

The local and hosted forms expose the same six tools and produce byte-identical links. When privacy from an intermediary matters, connect to the hosted URL directly rather than through a gateway, or run the file locally.

Limitations and notes

Coordinates must be supplied to build_trip_link; use find_place when they are not already known. On a leg, lodging and stayNote are flat fields, not a nested stay object. The tool assembles the URL payload format itself.

A kept-trip view phrase can read but cannot write. add_to_kept_trip requires an edit phrase. Kept-trip responses omit the service's basemap token and member roster, returning itinerary information instead. Content sealed for another person can return with empty text.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Trips

trips is an MCP server that connects AI assistants to thistripbtw.us for private, editable travel maps. Its main tools resolve places, build and amend draft trip links, decode itineraries, read kept trips, and add stops to kept trips. Draft links store itinerary data in the URL and need no account.

Install it with Node.js 18 or newer by running `npx -y thistripbtw-mcp`, or connect to `https://thistripbtw.us/mcp` from a client that accepts an MCP URL. Claude Desktop can use the provided npm command or a downloaded standalone `.mjs` file.

Draft-link creation, amendment, and reading work offline because the itinerary is stored in the URL. `find_place` needs the network for place resolution, and kept-trip reading or editing needs the service because kept-trip contents are stored remotely.

Use `read_kept_trip` with the kept-trip URL and its view or edit phrase. The tool sends the phrase to thistripbtw.us over TLS and returns stops, dates, modes, lodging, notes, hand-drawn paths, and track assignments.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewTrips AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/trips?style=directory)](https://allmcps.com/mcp/trips)
HTML Embed
<a href="https://allmcps.com/mcp/trips"><img src="https://allmcps.com/api/badge/trips?style=directory" alt="Trips on AllMCPs" /></a>