Hand someone a complete trip as a private, editable map link. No account, no API key, no card.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
The kept trip's link with its #k= EDIT phrase.
The stop to add.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
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.
| Argument | Type | Description |
|---|---|---|
| link* | string | The kept trip's link with its #k= EDIT phrase. |
| stop* | object | The stop to add. |
{
"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."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| add | array | Legs to APPEND after the last one. |
| legs | array | REPLACES every leg. Omit to keep them. |
| link* | string | The existing draft link, whole URL or just the #d= fragment. |
| name | string | New trip name. |
| origin | object | New starting point. |
| remove | integer | Drop leg number N (1-based). Applied after add/legs/update. |
| update | array | 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. |
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.
| Argument | Type | Description |
|---|---|---|
| legs* | array | The legs in order. Each one ends somewhere; the next starts there. |
| name | string | Trip name, optional. |
| origin* | object | Where the trip starts. |
{
"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."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| query* | string | The place as a person would say it: "Moab, UT", "SFO", "Arches National Park". |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "The place as a person would say it: \"Moab, UT\", \"SFO\", \"Arches National Park\"."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| link* | string | The kept trip's link, e.g. https://thistripbtw.us/abc1234#k=lagoon-passport-teal-teal. The whole URL is fine. |
{
"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."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| link* | string | The trip link, e.g. https://thistripbtw.us/new#d=… — the whole URL is fine, or just the fragment. |
{
"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."
}
}
}{
"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."
}
}
}