mirror of
https://github.com/mauriceboe/TREK.git
synced 2026-11-05 04:04:07 +00:00
docs(wiki): the journey MCP tools that answer what they replaced, and the photo link tools
update_journey takes show_trip_tracks and cover_gradient and answers previous, update_journey_entry answers previous, reorder_journey_entries answers previous_order, and the four photo link tools are listed.
This commit is contained in:
@@ -191,7 +191,7 @@ Requires `journey:read` or `journey:write` scope.
|
||||
| `get_journey_tracks` | The GPX tracks a journey's map draws, from the trips added to it: per track the place and trip it belongs to, its name, its kind, how many points it has and its length in km, plus `display_geometry`, the line thinned for drawing to at most 200 points per track and about 1000 for all tracks together, both ends always kept. Same journey access as the map. |
|
||||
| `get_journey_stats` | What a journey adds up to: distance travelled in metres, calendar days spanned, countries in visit order, the furthest point reached, and entry, photo and place counts. Entries switched off with `stats_excluded` count towards none of those and are listed under `excluded`. Pass `include_route` for the route itself, up to 400 stops with coordinates. |
|
||||
| `create_journey` | Create a new journey with title, optional subtitle, and an initial list of trip IDs. |
|
||||
| `update_journey` | Update a journey's title, subtitle, cover or status, and whether its entries offer a pros/cons list, a mood and a weather note (`show_verdict`, `show_mood`, `show_weather`). `status_override` sets the shown status by hand (`draft`, `live` or `completed`), `null` goes back to following the trip dates. `photo_location` lets an entry without a place take the position of its first geotagged photo. `auto_prepare_recordings` switches the preparation of its recorded days from Dawarich on or off. Owner only. |
|
||||
| `update_journey` | Update a journey's title, subtitle, cover or status, and whether its entries offer a pros/cons list, a mood and a weather note (`show_verdict`, `show_mood`, `show_weather`). `status_override` sets the shown status by hand (`draft`, `live` or `completed`), `null` goes back to following the trip dates. `photo_location` lets an entry without a place take the position of its first geotagged photo. `auto_prepare_recordings` switches the preparation of its recorded days from Dawarich on or off, `show_trip_tracks` draws the trips' GPX tracks on its map, and `cover_gradient` sets the cover's gradient; `null` clears the subtitle or the gradient. Answers with what the changed settings held before under `previous`. Owner only. |
|
||||
| `restore_journey_suggestions` | Bring back every trip-derived suggestion that was dismissed from a journey. Answers with how many came back. |
|
||||
| `delete_journey` | Delete a journey. |
|
||||
| `add_journey_trip` | Link an existing trip to a journey. |
|
||||
@@ -199,10 +199,14 @@ Requires `journey:read` or `journey:write` scope.
|
||||
| `list_journey_entries` | List the entries of a journey in reading order (date, text, mood, linked trip), with the journey's id and title. `from` and `to` (`YYYY-MM-DD`, both included) keep only the entries of those days. |
|
||||
| `get_journey_entry` | One journal entry by its id, as `list_journey_entries` answers it (photos included), with the id and title of its journey. |
|
||||
| `create_journey_entry` | Add an entry with date (required), optional title, story text, time of day, location name, mood, and sort order. `is_draft: true` creates it as a draft that the journey share link leaves out. |
|
||||
| `update_journey_entry` | Edit a journey entry's title, story, date, time of day, place, coordinates, weather, tags, mood, pros/cons list or visibility. `stats_excluded: true` keeps the entry but takes it off the route and out of `get_journey_stats`; `dismissed: true` waves a trip-derived suggestion away without deleting it, so the trip sync does not offer it again. `is_draft` turns the entry into a draft or publishes it. |
|
||||
| `update_journey_entry` | Edit a journey entry's title, story, date, time of day, place, coordinates, weather, tags, mood, pros/cons list or visibility. `stats_excluded: true` keeps the entry but takes it off the route and out of `get_journey_stats`; `dismissed: true` waves a trip-derived suggestion away without deleting it, so the trip sync does not offer it again. `is_draft` turns the entry into a draft or publishes it. Answers with what the changed fields held before under `previous`. |
|
||||
| `delete_journey_entry` | Remove an entry from a journey. |
|
||||
| `reorder_journey_entries` | Reorder entries by providing the new ordered list of entry IDs. |
|
||||
| `reorder_journey_entries` | Reorder entries by providing the new ordered list of entry IDs. Answers with the ids in their order before under `previous_order`. |
|
||||
| `reorder_journey_entry_photos` | Put the photos of one entry in a new order by passing every photo id of the entry once. The first photo is the entry's cover. |
|
||||
| `link_journey_photo` | Put a photo of the journey's gallery on one of its entries as well; it stays in the gallery and on any other entry. |
|
||||
| `unlink_journey_photo` | Take a photo off one entry. It stays in the gallery and on any other entry. |
|
||||
| `move_journey_photos` | Move photos of one entry to another entry of the same journey in one change. `keep_in_source: true` leaves them on the first entry too. A suggestion the photos land on becomes a written entry. |
|
||||
| `set_journey_photo_caption` | Set or clear (`null`) the caption of one gallery photo. Answers with the caption it replaced under `previous`. |
|
||||
| `list_journey_contributors` | List the contributors of a journey (owner and editors/viewers). |
|
||||
| `add_journey_contributor` | Invite a user to a journey with `editor` or `viewer` role. |
|
||||
| `update_journey_contributor_role` | Change a contributor's role between `editor` and `viewer`. |
|
||||
|
||||
Reference in New Issue
Block a user