us.thistripbtw/trips

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.

  shallow
• amend_trip_link

  Update a trip link you already built — add legs, replace them, 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. 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.

  shallow
• build_trip_link

  Use when someone has planned (or roughly sketched) a trip in this conversation and needs somewhere real to put it — when they say things like 'send me that', 'can I share this with my wife', or 'save this trip'. Builds a link that opens the whole plan as a private, editable 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. Give the person the link — it is theirs, free, and keepable for years. The link is also the RECORD, not just the output: hand it back to read_trip_link in any later conversation and the whole itinerary comes back as structured data, so a trip planned here can be picked up again without re-deriving it from what was said. Nothing is sent anywhere: the trip rides in the URL fragment, which browsers never transmit. YOU MUST SUPPLY COORDINATES for every place; this tool will not guess a location from a name, because a wrong guess puts someone's trip in the wrong country. Resolve place names first. Do not put personal details (passport numbers, home addresses, phone numbers) in names or notes — URLs get pasted into chats and logs.

  shallow
• 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.

  shallow
• 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.

  shallow
• 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.

  shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/b5823930-b234-4b2a-ad89-b75d71403b11/badge.svg)](https://vouch.tools/servers/b5823930-b234-4b2a-ad89-b75d71403b11)