Guides

Fields marked * are required. Updates keep every field they are not given. An AI app can ask vritto_describe for the same details, filtered to what its connection may use.

Guide`guide`

A private per-city or per-trip guide assembled from the user's visits.

guides_queryGuidesFindthrough vritto_find

List all guides with status (draft/published), entry counts, and share slugs. Use before any other guides tool. Rows are compact summaries with NO entries; pass detail 'full' when you need a guide's entries (e.g. before a guides_updateGuide edit).

Field	Type	Description
detail	one of summary, full	Row shape: "summary" (default, counts + id/slug/title/status/entryCount) or "full" (whole guide docs incl. all embedded entries and sections).

guides_assembleGuideCreatethrough vritto_create

Assemble a DRAFT guide from the user's real visits: scope {kind:'city', label} or {kind:'trip', label, tripId}. Fails when no visits match, never compensate with invented places.

Note: Guides stay private drafts over MCP; publishing happens in the app.

Field	Type	Description
scope*	object
scope.kind*	one of city, trip
scope.label*	string	City name, or the trip's name.
scope.tripId	string	Required when kind is 'trip'.
title	string	Defaults to the scope label.

Example input

{
  "scope": {
    "kind": "city",
    "label": "Chicago"
  },
  "title": "My Chicago"
}

guides_updateGuideUpdatethrough vritto_update

Update a guide's curation: title, sections, entries (blurbs in the USER'S voice from their own notes), showDates, display name. Sent fields merge; include record.id.

Field	Type	Description
record*	object	Guide fields to merge; pass sections/entries whole when editing them.
record.id*	string	Guide ID from a prior guides_queryGuides result, never invented.
record.title	string
record.showDates	boolean
record.authorDisplayName	string
record.sections	list of object	FULL replacement: send every section back, not just the changed one.
record.entries	list of object	FULL replacement: send every entry back, not just the changed one.
record.dismissed	boolean	true dismisses an auto-drafted Suggested guide (hides it and blocks re-drafting of that scope); false restores it.
record.dedicationPersonId	string	People ID for a private 'made for ⟨person⟩' dedication: never rendered publicly.

guides_deleteGuideDeletethrough vritto_delete

Delete (archive) a guide, also kills its share link if published. Only for explicit removals.

Field	Type	Description
guideId*	string	Guide ID from a prior guides_queryGuides result, never invented.

Kept in the Vritto app

guides_publishGuide: Makes something public on the web; the app shows exactly what goes out first.
guides_unpublishGuide: Makes something public on the web; the app shows exactly what goes out first.

Guides

Guideguide

Kept in the Vritto app

Guide`guide`