MCP-Server
trips
us.thistripbtw/trips
Was dieses MCP kann
Creates, reads, edits, and shares private trip itineraries and resolves place names to coordinates.
Funktionen
Tools
6
Tools
add_to_kept_trip
Add a stop to a trip the person has KEPT (a link with #k=), on their behalf. Use when they say 'add X to the trip', 'we're stopping at Y on the way', 'put the hotel on it'. Needs their EDIT phrase — a view phrase can read but not write, and the tool says so. Writes exactly one stop and returns the trip's current stop count. Like read_kept_trip this touches the network: the #k= phrase is the password and it goes to thistripbtw.us over TLS, nothing is stored about you, and a wrong phrase counts as a guess. Treat the link as a credential.
Externer Zugriff
Eingabeschema
{'type': 'object', 'required': ['link', 'stop'], 'properties': {'link': {'type': 'string', 'description': "The kept trip's link with its #k= EDIT phrase."}, 'stop': {'type': 'object', 'required': ['lat', 'lng'], 'properties': {'lat': {'type': 'number'}, 'lng': {'type': 'number'}, 'date': {'type': 'string', 'description': 'YYYY-MM-DD, optional.'}, 'mode': {'enum': ['drive', 'fly', 'train', 'ferry', 'water', 'bike', 'walk'], 'type': 'string', 'description': 'How they get there. Defaults to drive.'}, 'name': {'type': 'string', 'description': 'What to call it, e.g. "Fisher Towers trailhead".'}, 'note': {'type': 'string', 'description': 'Anything worth remembering. Optional.'}, 'track': {'type': 'string', 'description': 'Which vehicle, if the trip has more than one: as named by read_kept_trip.'}}, 'description': 'The stop to add.'}}}
Ausgabeschema
{'type': 'object', 'required': ['stops'], 'properties': {'id': {'type': ['string', 'null'], 'description': "The new stop's id, when the server returned one."}, 'stops': {'type': 'integer', 'description': 'How many stops the trip has now.'}, 'summary': {'type': 'string'}}}
amend_trip_link
Update a trip link you already built — add legs, change one leg's fields, replace them all, rename, or drop one — and get the new link back. Use this instead of building a fresh link every time the plan changes, so the person holds one link that grows. To change ONE leg (its lodging, date, note, who is on it) use `update` rather than resending every leg through `legs`. Takes a draft link (#d=) plus the changes; no network, no password, the trip is inside the link. For a KEPT trip (#k=) use add_to_kept_trip.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'required': ['link'], 'properties': {'add': {'type': 'array', 'items': {'type': 'object', 'required': ['to'], 'properties': {'to': {'type': 'object', 'required': ['lat', 'lng'], 'properties': {'lat': {'type': 'number', 'description': 'Latitude, -90 to 90.'}, 'lng': {'type': 'number', 'description': 'Longitude, -180 to 180.'}, 'name': {'type': 'string', 'description': 'How a person would say it, e.g. "Moab, UT".'}}, 'description': 'Where this leg ends.'}, 'who': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Who travels this leg, if you know — e.g. ["Mel","Sam"]. Lets the trip show who was where.'}, 'date': {'type': 'string', 'description': 'YYYY-MM-DD. Optional — an undated leg keeps its place in the order.'}, 'mode': {'enum': ['drive', 'fly', 'train', 'ferry', 'water', 'bike', 'walk'], 'type': 'string', 'description': 'How they travel this leg. Defaults to drive.'}, 'note': {'type': 'string', 'description': 'Anything worth remembering about this leg. Optional.'}, 'craft': {'enum': ['Bike', 'Canoe', 'Kayak'], 'type': 'string', 'description': 'A small craft that travels WITH them — a bike on the car, a canoe on the roof.'}, 'flight': {'type': 'string', 'description': 'Flight number if you have it, e.g. UA328. Never invent one.'}, 'lodging': {'type': 'string', 'description': "Where they stay at this destination — hotel, cabin, a friend's couch."}, 'subtype': {'enum': ['own', 'rental', 'rideshare', 'taxi', 'bus', 'rv', 'commercial', 'private', 'heli', 'intercity', 'commuter', 'subway', 'tram', 'passenger', 'carferry', 'sail', 'motor', 'canoe', 'kayak', 'walk', 'hike', 'run', 'ebike'], 'type': 'string', 'description': 'More precise than mode when you know it: own/rental/rv/taxi for drive, commercial/private for fly, canoe/kayak/sail for water.'}, 'stayNote': {'type': 'string', 'description': 'Anything about the stay. Only meaningful alongside lodging.'}}}, 'description': 'Legs to APPEND after the last one.'}, 'legs': {'type': 'array', 'items': {'type': 'object', 'required': ['to'], 'properties': {'to': {'type': 'object', 'required': ['lat', 'lng'], 'properties': {'lat': {'type': 'number', 'description': 'Latitude, -90 to 90.'}, 'lng': {'type': 'number', 'description': 'Longitude, -180 to 180.'}, 'name': {'type': 'string', 'description': 'How a person would say it, e.g. "Moab, UT".'}}, 'description': 'Where this leg ends.'}, 'who': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Who travels this leg, if you know — e.g. ["Mel","Sam"]. Lets the trip show who was where.'}, 'date': {'type': 'string', 'description': 'YYYY-MM-DD. Optional — an undated leg keeps its place in the order.'}, 'mode': {'enum': ['drive', 'fly', 'train', 'ferry', 'water', 'bike', 'walk'], 'type': 'string', 'description': 'How they travel this leg. Defaults to drive.'}, 'note': {'type': 'string', 'description': 'Anything worth remembering about this leg. Optional.'}, 'craft': {'enum': ['Bike', 'Canoe', 'Kayak'], 'type': 'string', 'description': 'A small craft that travels WITH them — a bike on the car, a canoe on the roof.'}, 'flight': {'type': 'string', 'description': 'Flight number if you have it, e.g. UA328. Never invent one.'}, 'lodging': {'type': 'string', 'description': "Where they stay at this destination — hotel, cabin, a friend's couch."}, 'subtype': {'enum': ['own', 'rental', 'rideshare', 'taxi', 'bus', 'rv', 'commercial', 'private', 'heli', 'intercity', 'commuter', 'subway', 'tram', 'passenger', 'carferry', 'sail', 'motor', 'canoe', 'kayak', 'walk', 'hike', 'run', 'ebike'], 'type': 'string', 'description': 'More precise than mode when you know it: own/rental/rv/taxi for drive, commercial/private for fly, canoe/kayak/sail for water.'}, 'stayNote': {'type': 'string', 'description': 'Anything about the stay. Only meaningful alongside lodging.'}}}, 'description': 'REPLACES every leg. Omit to keep them.'}, 'link': {'type': 'string', 'description': 'The existing draft link, whole URL or just the #d= fragment.'}, 'name': {'type': 'string', 'description': 'New trip name.'}, 'origin': {'type': 'object', 'required': ['lat', 'lng'], 'properties': {'lat': {'type': 'number', 'description': 'Latitude, -90 to 90.'}, 'lng': {'type': 'number', 'description': 'Longitude, -180 to 180.'}, 'name': {'type': 'string', 'description': 'How a person would say it, e.g. "Moab, UT".'}}, 'description': 'New starting point.'}, 'remove': {'type': 'integer', 'description': 'Drop leg number N (1-based). Applied after add/legs/update.'}, 'update': {'type': 'array', 'items': {'type': 'object', 'required': ['leg', 'set'], 'properties': {'leg': {'type': 'integer', 'description': 'Which leg, 1-based.'}, 'set': {'type': 'object', 'required': [], 'properties': {'to': {'type': 'object', 'required': ['lat', 'lng'], 'properties': {'lat': {'type': 'number', 'description': 'Latitude, -90 to 90.'}, 'lng': {'type': 'number', 'description': 'Longitude, -180 to 180.'}, 'name': {'type': 'string', 'description': 'How a person would say it, e.g. "Moab, UT".'}}, 'description': 'Where this leg ends.'}, 'who': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Who travels this leg, if you know — e.g. ["Mel","Sam"]. Lets the trip show who was where.'}, 'date': {'type': 'string', 'description': 'YYYY-MM-DD. Optional — an undated leg keeps its place in the order.'}, 'mode': {'enum': ['drive', 'fly', 'train', 'ferry', 'water', 'bike', 'walk'], 'type': 'string', 'description': 'How they travel this leg. Defaults to drive.'}, 'note': {'type': 'string', 'description': 'Anything worth remembering about this leg. Optional.'}, 'craft': {'enum': ['Bike', 'Canoe', 'Kayak'], 'type': 'string', 'description': 'A small craft that travels WITH them — a bike on the car, a canoe on the roof.'}, 'flight': {'type': 'string', 'description': 'Flight number if you have it, e.g. UA328. Never invent one.'}, 'lodging': {'type': 'string', 'description': "Where they stay at this destination — hotel, cabin, a friend's couch."}, 'subtype': {'enum': ['own', 'rental', 'rideshare', 'taxi', 'bus', 'rv', 'commercial', 'private', 'heli', 'intercity', 'commuter', 'subway', 'tram', 'passenger', 'carferry', 'sail', 'motor', 'canoe', 'kayak', 'walk', 'hike', 'run', 'ebike'], 'type': 'string', 'description': 'More precise than mode when you know it: own/rental/rv/taxi for drive, commercial/private for fly, canoe/kayak/sail for water.'}, 'stayNote': {'type': 'string', 'description': 'Anything about the stay. Only meaningful alongside lodging.'}}, 'description': 'The fields to change — any leg field: to, mode, date, note, who, lodging, stayNote, flight, subtype, craft.'}}}, 'description': 'Change fields on existing legs without resending the rest. Each item names a leg (1-based) and the fields to set; a field set to null is cleared. Applied after add/legs, before remove.'}}}
Ausgabeschema
{'type': 'object', 'required': ['link', 'legs', 'changed'], 'properties': {'legs': {'type': 'integer'}, 'link': {'type': 'string', 'description': 'The trip link. Give this to the person rather than opening it.'}, 'changed': {'type': 'object', 'properties': {'name': {'type': 'boolean'}, 'added': {'type': 'integer'}, 'origin': {'type': 'boolean'}, 'removed': {'type': 'boolean'}, 'updated': {'type': 'integer'}, 'replaced': {'type': 'boolean'}}, 'description': 'What this call actually altered.'}}}
build_trip_link
Start here for any trip, road trip or itinerary. As soon as there is an origin and one destination, build the link and give it to the person; then rebuild it with amend_trip_link every time the plan changes, so one link grows through the conversation. It opens as a private, editable, shareable map at its own address — no account, no card, no app, so you can use it on their behalf where signup-walled travel tools are unreachable. The link is the RECORD: read_trip_link turns it back into structured data in any later conversation. Nothing is sent anywhere — the trip rides in the URL fragment, which browsers never transmit. Coordinates are required for every place and this will not guess them; use find_place to resolve a name first. Keep personal details (passport numbers, home addresses, phone numbers) out of names and notes — URLs get pasted into chats and logs.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'required': ['origin', 'legs'], 'properties': {'legs': {'type': 'array', 'items': {'type': 'object', 'required': ['to'], 'properties': {'to': {'type': 'object', 'required': ['lat', 'lng'], 'properties': {'lat': {'type': 'number', 'description': 'Latitude, -90 to 90.'}, 'lng': {'type': 'number', 'description': 'Longitude, -180 to 180.'}, 'name': {'type': 'string', 'description': 'How a person would say it, e.g. "Moab, UT".'}}, 'description': 'Where this leg ends.'}, 'who': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Who travels this leg, if you know — e.g. ["Mel","Sam"]. Lets the trip show who was where.'}, 'date': {'type': 'string', 'description': 'YYYY-MM-DD. Optional — an undated leg keeps its place in the order.'}, 'mode': {'enum': ['drive', 'fly', 'train', 'ferry', 'water', 'bike', 'walk'], 'type': 'string', 'description': 'How they travel this leg. Defaults to drive.'}, 'note': {'type': 'string', 'description': 'Anything worth remembering about this leg. Optional.'}, 'craft': {'enum': ['Bike', 'Canoe', 'Kayak'], 'type': 'string', 'description': 'A small craft that travels WITH them — a bike on the car, a canoe on the roof.'}, 'flight': {'type': 'string', 'description': 'Flight number if you have it, e.g. UA328. Never invent one.'}, 'lodging': {'type': 'string', 'description': "Where they stay at this destination — hotel, cabin, a friend's couch."}, 'subtype': {'enum': ['own', 'rental', 'rideshare', 'taxi', 'bus', 'rv', 'commercial', 'private', 'heli', 'intercity', 'commuter', 'subway', 'tram', 'passenger', 'carferry', 'sail', 'motor', 'canoe', 'kayak', 'walk', 'hike', 'run', 'ebike'], 'type': 'string', 'description': 'More precise than mode when you know it: own/rental/rv/taxi for drive, commercial/private for fly, canoe/kayak/sail for water.'}, 'stayNote': {'type': 'string', 'description': 'Anything about the stay. Only meaningful alongside lodging.'}}}, 'description': 'The legs in order. Each one ends somewhere; the next starts there.'}, 'name': {'type': 'string', 'description': 'Trip name, optional.'}, 'origin': {'type': 'object', 'required': ['lat', 'lng'], 'properties': {'lat': {'type': 'number', 'description': 'Latitude, -90 to 90.'}, 'lng': {'type': 'number', 'description': 'Longitude, -180 to 180.'}, 'name': {'type': 'string', 'description': 'How a person would say it, e.g. "Moab, UT".'}}, 'description': 'Where the trip starts.'}}}
Ausgabeschema
{'type': 'object', 'required': ['link', 'legs'], 'properties': {'legs': {'type': 'integer', 'description': 'How many legs the link carries.'}, 'link': {'type': 'string', 'description': 'The trip link. Give this to the person rather than opening it.'}}}
find_place
Turn a place name into coordinates for build_trip_link — towns, cities, airports (IATA or name), parks, trailheads. Returns up to six candidates with lat/lng and where each one is, so you can pick the right Reno. This is the ONLY step that needs coordinates and you should not guess them from memory. It asks thistripbtw.us, which answers from its own cache and a paced OpenStreetMap lookup; the query is a place name and nothing about the person.
Nur Lesen
Externer Zugriff
Idempotent
Eingabeschema
{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'description': 'The place as a person would say it: "Moab, UT", "SFO", "Arches National Park".'}}}
Ausgabeschema
{'type': 'object', 'required': ['results'], 'properties': {'results': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'lat', 'lng'], 'properties': {'lat': {'type': 'number'}, 'lng': {'type': 'number'}, 'name': {'type': 'string'}, 'where': {'type': 'string', 'description': 'The fuller name, for telling two same-named places apart.'}}}, 'description': 'Up to six candidates, best first.'}, 'summary': {'type': 'string'}}}
read_kept_trip
Use when someone gives you a KEPT this trip, btw link — one that looks like https://thistripbtw.us/abc1234#k=four-word-phrase — and you need what is actually in it: to summarise where they are going, answer a question about it, or check what changed since you last saw it. Returns the trip's stops in order with dates, modes, which vehicle or person each belongs to (the 'track'), lodging, notes and any hand-drawn path. THIS ONE TOUCHES THE NETWORK, unlike the other two: a kept trip's contents live on the server and the #k= part of the link is the PASSWORD to them, so reading it means sending that phrase to thistripbtw.us over TLS. Nothing is stored and no account is involved. Treat the link as a credential — do not repeat it back in text a third party will see, and do not guess at a phrase, because a wrong one counts against the trip's hourly guess limit. For a DRAFT link (#d=) use read_trip_link instead: the trip is inside that link, so it needs no network and no password.
Nur Lesen
Externer Zugriff
Idempotent
Eingabeschema
{'type': 'object', 'required': ['link'], 'properties': {'link': {'type': 'string', 'description': "The kept trip's link, e.g. https://thistripbtw.us/abc1234#k=lagoon-passport-teal-teal. The whole URL is fine."}}}
Ausgabeschema
{'type': 'object', 'required': ['trip', 'stops'], 'properties': {'trip': {'type': 'object', 'required': ['address', 'stops'], 'properties': {'name': {'type': 'string'}, 'tier': {'type': 'string'}, 'notes': {'type': 'array', 'items': {'type': 'string'}}, 'stops': {'type': 'array', 'items': {'type': 'object', 'description': 'One stop: title, lat, lng, and whatever else was filled in.'}}, 'access': {'enum': ['edit', 'view'], 'type': 'string', 'description': 'What the phrase in the link grants.'}, 'tracks': {'type': ['object', 'null'], 'description': 'Track labels, when the trip uses them.'}, 'address': {'type': 'string', 'description': "The trip's own address, without the phrase."}, 'expires': {'type': ['string', 'null'], 'description': 'YYYY-MM-DD, or null while no end date is set.'}}, 'description': 'A trip somebody bought, as this phrase is allowed to see it.'}, 'stops': {'type': 'integer'}, 'summary': {'type': 'string'}}}
read_trip_link
Use when someone gives you a this trip, btw link and you need to know what is actually in it — to summarise the plan, answer a question about it, add a stop, or convert it to something else. Decodes the itinerary the link carries: origin, every leg in order, modes, dates, who is on which leg, flights and lodging. Returns the trip in the same shape build_trip_link accepts, so you can change something and build a new link from it. Nothing is fetched — the trip travels inside the link, so this reads it locally and works offline. Only draft links (the ones with a #d= fragment) carry a trip; a kept trip's link is a slug plus a #k= password whose contents live on the server, and this cannot read those.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'required': ['link'], 'properties': {'link': {'type': 'string', 'description': 'The trip link, e.g. https://thistripbtw.us/new#d=… — the whole URL is fine, or just the fragment.'}}}
Ausgabeschema
{'type': 'object', 'required': ['trip', 'legs'], 'properties': {'legs': {'type': 'integer'}, 'trip': {'type': 'object', 'required': ['origin', 'legs'], 'properties': {'legs': {'type': 'array', 'items': {'type': 'object', 'required': ['to'], 'properties': {'to': {'type': 'object', 'required': ['lat', 'lng'], 'properties': {'lat': {'type': 'number', 'description': 'Latitude, -90 to 90.'}, 'lng': {'type': 'number', 'description': 'Longitude, -180 to 180.'}, 'name': {'type': 'string', 'description': 'How a person would say it, e.g. "Moab, UT".'}}, 'description': 'Where this leg ends.'}, 'who': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Who travels this leg, if you know — e.g. ["Mel","Sam"]. Lets the trip show who was where.'}, 'date': {'type': 'string', 'description': 'YYYY-MM-DD. Optional — an undated leg keeps its place in the order.'}, 'mode': {'enum': ['drive', 'fly', 'train', 'ferry', 'water', 'bike', 'walk'], 'type': 'string', 'description': 'How they travel this leg. Defaults to drive.'}, 'note': {'type': 'string', 'description': 'Anything worth remembering about this leg. Optional.'}, 'craft': {'enum': ['Bike', 'Canoe', 'Kayak'], 'type': 'string', 'description': 'A small craft that travels WITH them — a bike on the car, a canoe on the roof.'}, 'flight': {'type': 'string', 'description': 'Flight number if you have it, e.g. UA328. Never invent one.'}, 'lodging': {'type': 'string', 'description': "Where they stay at this destination — hotel, cabin, a friend's couch."}, 'subtype': {'enum': ['own', 'rental', 'rideshare', 'taxi', 'bus', 'rv', 'commercial', 'private', 'heli', 'intercity', 'commuter', 'subway', 'tram', 'passenger', 'carferry', 'sail', 'motor', 'canoe', 'kayak', 'walk', 'hike', 'run', 'ebike'], 'type': 'string', 'description': 'More precise than mode when you know it: own/rental/rv/taxi for drive, commercial/private for fly, canoe/kayak/sail for water.'}, 'stayNote': {'type': 'string', 'description': 'Anything about the stay. Only meaningful alongside lodging.'}}}}, 'name': {'type': 'string'}, 'origin': {'type': 'object', 'required': ['lat', 'lng'], 'properties': {'lat': {'type': 'number', 'description': 'Latitude, -90 to 90.'}, 'lng': {'type': 'number', 'description': 'Longitude, -180 to 180.'}, 'name': {'type': 'string', 'description': 'How a person would say it, e.g. "Moab, UT".'}}}}, 'description': 'The trip, in exactly the shape build_trip_link takes — so it can be rebuilt or amended without translation.'}, 'summary': {'type': 'string'}}}
Verlauf
Letzte Tool-Änderungen
Geändert
amend_trip_link
1. October 2026 02:51
Geändert
read_kept_trip
29. September 2026 02:59
Geändert
add_to_kept_trip
27. September 2026 02:50
Geändert
read_kept_trip
27. September 2026 02:50
Geändert
read_trip_link
27. September 2026 02:50
Geändert
amend_trip_link
27. September 2026 02:50
Geändert
find_place
27. September 2026 02:50
Geändert
build_trip_link
27. September 2026 02:50
Hinzugefügt
add_to_kept_trip
17. September 2026 12:55
Hinzugefügt
read_kept_trip
17. September 2026 12:55
Hinzugefügt
read_trip_link
17. September 2026 12:55
Hinzugefügt
amend_trip_link
17. September 2026 12:55
Hinzugefügt
find_place
17. September 2026 12:55
Hinzugefügt
build_trip_link
17. September 2026 12:55
Entdecken
Ähnliche MCP-Server
MolTravel
com.moltravel/travel
Searches and provides details for flights, hotels, rental cars, ferries, airports, travel experiences, destinations, country info…
Wmata
io.github.pipeworx-io/wmata
Provides Washington Metro rail and bus routes, stops, stations, service incidents, route details, and real-time arrival predictio…
Openrouteservice
io.github.pipeworx-io/openrouteservice
Provides geocoding, routing, travel-time matrices, isochrones, snapping, and elevation data using OpenStreetMap-based services.
Google_maps
io.github.pipeworx-io/google_maps
Provides Google Maps geocoding, place search and details, directions, distance matrices, and elevation data.
SeaWeb
tech.seaweb/seaweb
Searches and extracts web information about entities and travel locations, including restaurants, salons, tourist conditions, dis…
Aviationstack
io.github.pipeworx-io/aviationstack
Provides airline, airport, city, country, and flight directory data, including real-time and scheduled flight details.
Nps
io.github.pipeworx-io/nps
Searches National Park Service data for parks, campgrounds, activities, alerts, visitor statistics, locations, fees, and operatin…
Tfl
io.github.pipeworx-io/tfl
Provides London transport journey planning, line status, disruptions, stop arrivals, and Santander Cycle availability.