{"name":"Roadbook","description":"Plan EV road trips: search real places, add stops with lodging and charging details, manage day-by-day itineraries, and keep a private trip logbook. Call a skill with the A2A SendMessage method: send one data part shaped {\"skill\": \"<skill id>\", \"arguments\": {...}}, where the skill id is one of the skills below and arguments match that tool's input schema at /docs/mcp#tools. The answer is a Task that is already finished: TASK_STATE_COMPLETED with the tool's result as one artifact, or TASK_STATE_FAILED with the error text in status.message. GetTask and ListTasks return your tasks for 7 days.","version":"1.0.0","provider":{"organization":"Roadbook","url":"https://roadbook.us"},"documentationUrl":"https://roadbook.us/docs/mcp#a2a","supportedInterfaces":[{"url":"https://roadbook.us/a2a","protocolBinding":"JSONRPC","protocolVersion":"1.0"}],"capabilities":{"streaming":false,"pushNotifications":false,"extendedAgentCard":false},"securitySchemes":{"oauth2":{"oauth2SecurityScheme":{"description":"OAuth 2.0 authorization code + PKCE (S256), with Dynamic Client Registration (RFC 7591). Send resource=https://roadbook.us/mcp (RFC 8707) on the authorization request. That is the audience of the one access token both /mcp and /a2a accept. A request with no resource, or with the /a2a URL as resource, is refused with invalid_target.","flows":{"authorizationCode":{"authorizationUrl":"https://roadbook.us/oauth/mcp/authorize","tokenUrl":"https://roadbook.us/oauth/mcp/token","refreshUrl":"https://roadbook.us/oauth/mcp/token","scopes":{"mcp":"Full access to your Roadbook trips, places, and logbook"},"pkceRequired":true}},"oauth2MetadataUrl":"https://roadbook.us/.well-known/oauth-authorization-server"}}},"securityRequirements":[{"schemes":{"oauth2":{"list":["mcp"]}}}],"defaultInputModes":["application/json"],"defaultOutputModes":["application/json","text/plain"],"skills":[{"id":"list_trips","name":"List trips","description":"List the trips you own, most recently updated first. Returns trips: [{id, name, slug, visibility, startDate, updatedAt}] (startDate can be null) and nextCursor, null on the last page. Up to 50 trips per page by default.","tags":["read"]},{"id":"read_trip","name":"Read trip","description":"Read one of your trips. Returns trip {id, name, slug, visibility, startDate, endDate, journal {hasBody, published}}; stops in order, each with id, role, nights, placeId, name, city, state, the public place lat/lon (not a private stop coordinate), its lodging records and your own chargingReport; drives, the recorded drives with labels, times, distance, duration and energy but no route or exact points (up to 200); lodgingBookingIssues, each night left unbooked (kind \"gap\") or booked twice (kind \"overlap\") between consecutive overnight stops, from booked check-in and check-out dates only; vehicle {make, model, trim, rangeKm, rangeKind} or null; and legs, one per pair of consecutive stops, with legKm (a straight-line estimate, not a route; null without place coordinates) and grade (the stored charger-availability letter, or \"not graded\"; stored grades expire after 24 hours).","tags":["read"]},{"id":"create_trip","name":"Create trip","description":"Create a new private trip you own, with no stops. Returns {id, name, slug}. name is required; startDate and endDate (YYYY-MM-DD) are optional, and a malformed date is rejected. Fails when your garage has no vehicle. Each call creates another trip.","tags":["write"]},{"id":"search_places","name":"Search places","description":"Search real places by name. Returns candidates: [{placeId, name, context, lat, lon, type, url, distanceKm?}]. A place Roadbook stores has its placeId and its public page url (null without a page); a geocoder match not stored yet has placeId and url null. With lat/lng, candidates within radiusKm (default 50) are ranked by distanceKm. type narrows to \"settlement\", \"poi\" or an exact type. Without sign-in: stored places only, up to 10, and a query of at least 2 characters.","tags":["read"]},{"id":"read_place","name":"Read place facts","description":"Read the stored facts for one place by placeId or slug: name, location, categories, a summary and quick facts when a listed source backs them, verified claims (charging, camping, seasonal, events, activities) and the list of sources. Every claim has a sourceUrl and checkedAt, the time it was stored; the quoted passage is not returned. Empty arrays mean no claims are stored. Stored data only: no live availability, no charging reports, no nearby-charger lookup.","tags":["read"]},{"id":"search","name":"Search place pages","description":"Find Roadbook place pages by name. Returns up to 10 results as {id, title, url}; the id reads the place with fetch. Matches stored place names only, with no geocoder call.","tags":["read"]},{"id":"fetch","name":"Fetch place page","description":"Read one place by an id from search. Returns {id, title, text, url, metadata}: text is the JSON of the place facts, the same object read_place returns, with a sourceUrl and checkedAt on every claim; url is the public Roadbook page, left out when the place has none.","tags":["read"]},{"id":"submit_place","name":"Submit a place","description":"Queue a place that is missing from search for a human moderator. Creates no live place: returns {submitted: true, submissionId, status: \"pending\"}. When the place already exists or the same submission is pending, nothing is queued and the match comes back with submitted: false. Fails while you have 10 submissions awaiting moderation.","tags":["write"]},{"id":"create_stop","name":"Create stop","description":"Add a stop to one of your trips by place query, by candidateRef, or by exact lat/lng. A coordinate resolves to the city or neighborhood around it: the trip shows that place and the exact point stays on the private stop. An ambiguous query creates nothing and returns candidates, each with a ref, coordinates, type and, when the trip has stops, distanceKm from the last stop; a ref passed as candidateRef adds that exact place. beforeWaypointId inserts the stop before that top-level stop and is not remembered between calls; without it the stop is appended. The lodging fields record one booking in the same call (lodgingName is required once any is set). Returns {created: true, waypointId, placeName, sortOrder}.","tags":["write"]},{"id":"update_stop","name":"Update stop","description":"Change the role, nights, and/or one lodging record of a stop on your trip. lodgingId names the record; it can be left out when the stop has at most one, and a stop with none gets a new record (lodgingName required). Omitted fields stay as they are; null or an empty string clears a lodging field, except lodgingName. Returns {updated: true}.","tags":["write"]},{"id":"delete_stop","name":"Delete stop","description":"Delete one top-level stop from your trip, with its sub-stops, and renumber the remaining stops. Cannot be undone. Returns {removed: true}; fails with \"Stop not found on this trip\" for an unknown id.","tags":["write"]},{"id":"reorder_stops","name":"Reorder stops","description":"Set the order of the top-level stops on your trip. waypointIds lists every top-level stop id exactly once, in the new order; a partial or foreign list is rejected and nothing changes. Returns {reordered: true}.","tags":["write"]},{"id":"delete_stop_lodging","name":"Delete stop lodging","description":"Delete one lodging record from a stop on your trip. The stop keeps its place, position, nights, charging report and logbook entries. lodgingId can be left out when the stop has exactly one record; a stop with several needs it, and a stop with none reports that there was nothing to remove. Cannot be undone. Returns {removed, lodgingId, remaining}.","tags":["write"]},{"id":"suggest_stop_candidates","name":"Suggest stop candidates","description":"Read up to 3 real places for one leg or one night of your trip, for the person to choose from. kind \"leg\" looks along the way from afterWaypointId to the next top-level stop; kind \"night\" looks near afterWaypointId. Each candidate has placeId, name, city, state, category, detourKm (a straight-line estimate, not a route) and charging: a stored fact with its source, or \"no charging data\". A leg also returns legKm (straight-line estimate) and rangeKm, the trip vehicle's rated range, or null without a vehicle. Returns no coordinates and changes nothing.","tags":["read"]},{"id":"propose_stop","name":"Propose stop","description":"File one pending stop proposal on your trip, after afterWaypointId, for a placeId from suggest_stop_candidates. The trip does not change: the proposal waits in Roadbook's planner, labeled as proposed by your assistant, until the owner accepts or dismisses it there. No tool accepts or dismisses a proposal. Refused when the place is unknown or not ready, already a stop or already pending on the trip, when afterWaypointId is not a top-level stop, or at 10 pending assistant proposals on the trip. reason is shown to the owner.","tags":["write"]},{"id":"import_drive","name":"Import recorded drives","description":"Add 1 to 50 recorded drives (roadbook.drive/1 payloads, as a vehicle connector exports them) to a trip. Without tripId it creates a new private trip; tripId must name one of your private trips. Start and end coordinates resolve to their city or neighborhood. Each drive becomes a departure stop, a destination stop and a drive record (distance, duration, max speed, elevation, energy, route); a drive that starts at the trip's last stop continues from it, which can change that stop's role and nights. A drive already imported (same source.system and source.id) is reported as \"exists\" and changes nothing. Exact points and the route stay on the private drive record; precision \"city\" keeps nothing finer than the city. Returns the trip, the stops created, each drive's id and status, and quality notes.","tags":["write"]},{"id":"read_logbook","name":"Read logbook","description":"Read the private logbook of one of your trips. Returns tripId, startDate, coverage and one page of entries, newest first, with nextCursor (null on the last page); startDate and coverage come on the first page only. coverage counts words and characters across all entries: trip totals, per-day averages over the planned span (nights + 1), and overnight stops ranked by words per night, thinnest first; it is a count with no judgement of quality. Each entry has id, entryDate, waypointId, scope, visibility, driveLegId and a body cut to 1000 characters (bodyTruncated is true when cut). With entryId it returns {tripId, entry}: that one entry with its full body.","tags":["read"]},{"id":"create_logbook_entries","name":"Create logbook entries","description":"Add 1 to 50 private dated logbook entries (markdown) to one of your trips. Each entry can tag a stop (waypointId) or an imported drive (driveId, which tags the drive's arrival stop with scope \"drive\"). Entries are created private. Each entry is validated alone: results lists every entry's outcome, its new id or its error. A created entry echoes the tagged stop's recorded lodging (name, type, charger type) as lodging, to compare with its text; an untagged entry carries a warning that it could not be checked. Marks a published journal stale.","tags":["write"]},{"id":"update_logbook_entry","name":"Update logbook entry","description":"Edit one logbook entry: body, entryDate, scope, and/or its stop tag (waypointId, or null to clear it). Omitted fields stay as they are; visibility does not change. Returns the entry with the tagged stop's recorded lodging as lodging, or a warning when it has no stop tag. Marks a published journal stale.","tags":["write"]},{"id":"delete_logbook_entry","name":"Delete logbook entry","description":"Delete one logbook entry from your trip. Cannot be undone. Returns {deleted: true}, or fails with \"Entry not found on this trip\". Marks a published journal stale.","tags":["write"]},{"id":"set_logbook_entry_visibility","name":"Set logbook entry visibility","description":"Make one logbook entry public or private. A public entry is shown publicly only while its trip is public; tripVisibility in the result is the trip's current visibility. Returns {id, visibility, tripVisibility}. Marks a published journal stale.","tags":["write"]},{"id":"read_journal","name":"Read journal","description":"Read the public trip journal of one of your trips, which is separate from the private logbook. Returns body (live), draftBody (the private pending draft), publishedAt, lastPublishedAt (set on every publish, kept on unpublish, null if never published), source, style, stale (the logbook changed since the last publish) and changedEntryCount (entries created or edited since lastPublishedAt; deletions are not counted, so stale is the reliable change signal).","tags":["read"]},{"id":"update_journal_draft","name":"Update journal draft","description":"Replace the private draft of the public trip journal (markdown). The live body and the publish state do not change, even on a published journal. Each call replaces the whole draft. Returns the journal state.","tags":["write"]},{"id":"set_journal_published","name":"Set journal published","description":"Publish or unpublish the public trip journal. published true makes the pending draft the live public body, sets publishedAt and lastPublishedAt, clears the draft and the stale flag, and records the source as an AI assistant; it fails when there is no draft. published false clears publishedAt only; the body, the draft and lastPublishedAt stay. Returns the journal state.","tags":["write"]},{"id":"read_trip_itinerary","name":"Read trip itinerary","description":"Read the day-view itinerary of one of your trips: each top-level stop's name, city, state, nights, dates and canAddItems, with its items by day. waypointId reads one stop, a sub-stop included; fromWaypointId and toWaypointId (both inclusive) narrow to a range; upcomingOnly keeps stops not yet arrived at. An unknown stop id fails with \"Stop not found on this trip\"; upcomingOnly with no upcoming stop returns stops: [] and itemCount: 0. Without a trip startDate no dates are derived and upcomingBasis is \"no-start-date\". The arrived/upcoming boundary uses the server's UTC day.","tags":["read"]},{"id":"create_itinerary_item","name":"Create itinerary item","description":"Add a day-view item (activity, dining, sightseeing, note, and more) to a stop with at least one night. Takes no coordinates. An invalid dayOffset, type or title is rejected with the app's own validation message. Returns the created item.","tags":["write"]},{"id":"update_itinerary_item","name":"Update itinerary item","description":"Edit a day-view item: title, description, url, timeOfDay, type and/or dayOffset; omitted fields stay as they are and null clears description, url or timeOfDay. toWaypointId moves the item to another stop with at least one night on the same trip, at the end of its day: the moved item gets a new id, previousItemId is the old one, and its approval status and author are kept. Returns {moved, item, previousItemId}. An empty change is rejected.","tags":["write"]},{"id":"delete_itinerary_item","name":"Delete itinerary item","description":"Delete one day-view item from your trip. Its stop must have at least one night. Cannot be undone. Returns {deleted: true}.","tags":["write"]},{"id":"request_stop_photo_upload","name":"Request stop photo upload","description":"Step 1 of 2 to attach a photo to a stop on your trip. Returns {uploadId, uploadUrl, method, expiresIn, maxSizeBytes}: a one-time URL valid for 15 minutes. Finishing needs a client that can send an HTTP PUT of the raw image bytes (jpeg, png, webp or heic, up to 10 MB) to uploadUrl with a matching Content-Type header, for example Claude Code; image data does not go through a tool call. The stored photo has its embedded date and location metadata stripped.","tags":["write"]},{"id":"finalize_stop_photo_upload","name":"Finalize stop photo upload","description":"Step 2 of 2: attach the image sent by HTTP PUT to the uploadUrl of step 1 to the stop. The photo is converted to WebP and stripped of metadata, as in the app; an image over 10 MB decoded, an unknown image type, or a caption over 280 characters is rejected. uploadId expires 15 minutes after step 1 and works once. caption is text the caller writes; the server generates none. Returns {photo}.","tags":["write"]}]}