# Encore MCP tools

Generated from the server. Read tools work with any key; write tools need a read and write key.

## Account and guide

### get_guide (read only)

The full guide to Encore for agents: how tours, shows, schedule, travel and crew relate, who can change what, time handling, and step-by-step recipes. Read it before a big job.

### whoami (read only)

The Encore account this key acts as: name, plan, tour allowance, time zone and whether this key can make changes. Call this first in a new session.

### list_notifications (read only)

This person's Encore notifications (invitations, schedule changes, messages), newest first.

- `unread_only` (optional): boolean
- `limit` (optional): integer

### update_notifications (writes)

Mark notifications read, or clear them. Pass notification_ids, or all: true for every one.

- `action` (required): `mark_read` \| `clear`
- `notification_ids` (optional): list of string
- `all` (optional): boolean

## Tours

### list_tours (read only)

Every tour this person can see (owned, and tours they are crew on), with their access level. Past tours are left out unless include_past is true.

- `include_past` (optional): boolean

### get_tour (read only)

Everything on one tour: shows (with running order), the day-by-day schedule, flights, hotels and rooms, crew, guest lists, gear and input list. Ask for fewer `sections` or a `from`/`to` date range on long tours. All times come back as local date + 24 hour time in the zone where they happen, plus UTC.

- `tour_id` (required): string
- `sections` (optional): list of `shows` \| `schedule` \| `flights` \| `hotels` \| `crew` \| `guest_lists` \| `production` \| `support_acts`. Default: all
- `from` (optional): string. Only schedule, shows, flights and hotels on or after this local date
- `to` (optional): string. …and on or before this local date

### create_tour (writes)

Start a new tour owned by this person. Then add shows with create_show. Checks the plan's active tour allowance first. Links to an artist on the roster when artist_id is given or the artist name matches one.

- `name` (required): string
- `artist` (optional): string. The artist's name. Optional when artist_id is given.
- `artist_id` (optional): string
- `start_date` (required): string. YYYY-MM-DD
- `end_date` (required): string. YYYY-MM-DD
- `color` (optional): string. One of: default, gray, brown, yellow, green, mint, teal, blue, purple, pink, red
- `poster_url` (optional): string

### update_tour (writes)

Change a tour's name, artist, dates, colour, poster or default show texts. Only the fields given change.

- `tour_id` (required): string
- `name` (optional): string
- `artist` (optional): string
- `start_date` (optional): string. YYYY-MM-DD
- `end_date` (optional): string. YYYY-MM-DD
- `color` (optional): string. One of: default, gray, brown, yellow, green, mint, teal, blue, purple, pink, red
- `poster_url` (optional): string or null. null removes the poster
- `default_event_description` (optional): string
- `default_important_info` (optional): string

### delete_tour (writes, confirm first)

Permanently delete a tour and everything on it (shows, schedule, travel, crew, guest lists). Owner only. Cannot be undone: confirm with the person first, and pass the tour's exact name as confirm_name.

- `tour_id` (required): string
- `confirm_name` (required): string

### export_document (read only)

A link that opens Encore's export ready to save as PDF or copy as a message: a show day sheet, guest list, travel sheet, day-by-day itinerary or the full tour. show and guestList need a show_id. The person opens the link to download it. Only for tours the person owns, as in the app.

- `tour_id` (required): string
- `preset` (required): `show` \| `guestList` \| `travel` \| `itinerary` \| `fullTour`
- `show_id` (optional): string

## Joining tours

### list_invitations (read only)

Tours this person has been invited to and hasn't accepted yet. Accept one with accept_invitation, or join with a joining code using join_tour.

### accept_invitation (writes)

Accept a tour invitation from list_invitations, by crew_id. Puts the tour on this person's list.

- `crew_id` (required): string

### join_tour (writes)

Join a tour with the six-character joining code from an invitation email.

- `code` (required): string

## Shows

### create_show (writes)

Add a show (a gig) to a tour, with its running order. The running order also lands on the schedule as show-timing items. Times are local to the venue.

- `tour_id` (required): string
- `date` (required): string. The show day, local to the venue
- `venue_name` (required): string
- `city` (required): string
- `timezone` (required): string. The venue's IANA time zone
- `address` (optional): string
- `country` (optional): string
- `timings` (optional): {venue_access?: string or null, load_in?: string or null, soundcheck?: string or null, doors?: string or null, headline?: string or null, pack_out?: string or null}. Show-day running order, local 24 hour times. null removes one.
- `set_duration_minutes` (optional): integer
- `pack_out_next_day` (optional): boolean. Pack out falls after midnight
- `contact_name` (optional): string
- `contact_email` (optional): string
- `contact_phone` (optional): string
- `color` (optional): string. One of: default, gray, brown, yellow, green, mint, teal, blue, purple, pink, red

### update_show (writes)

Change a show's venue, date, contacts or running order. Only fields given change; `timings` merges (a key set to null removes that time). Its show-timing schedule items are rebuilt.

- `show_id` (required): string
- `date` (optional): string. YYYY-MM-DD
- `venue_name` (optional): string
- `city` (optional): string
- `timezone` (optional): string. IANA time zone of where it happens, e.g. America/Chicago
- `address` (optional): string
- `country` (optional): string
- `timings` (optional): {venue_access?: string or null, load_in?: string or null, soundcheck?: string or null, doors?: string or null, headline?: string or null, pack_out?: string or null}. Show-day running order, local 24 hour times. null removes one.
- `set_duration_minutes` (optional): integer
- `pack_out_next_day` (optional): boolean
- `contact_name` (optional): string
- `contact_email` (optional): string
- `contact_phone` (optional): string
- `color` (optional): string. One of: default, gray, brown, yellow, green, mint, teal, blue, purple, pink, red

### delete_show (writes, confirm first)

Delete a show, its show-timing schedule items and its guest list. Cannot be undone.

- `show_id` (required): string

### get_setlist (read only)

A show's setlist in running order: songs (key, BPM, notes for lighting, audio and video), breaks and markers.

- `show_id` (required): string

### set_setlist (writes)

Replace a show's whole setlist with this list, in running order. To change one song, get_setlist first and send the full list back.

- `show_id` (required): string
- `items` (required): list of {type?: `song` \| `marker` \| `Break` \| `lightingNote` \| `soundNote`, song_title?: string, bpm?: integer, key?: string, tonality?: string, performance_notes?: string, lighting_notes?: string, audio_notes?: string, video_notes?: string, description?: string, duration_minutes?: number}

## Schedule

### add_schedule_item (writes)

Add an item to a tour's day-by-day schedule (lobby call, bus call, meeting, catering, press…). Leave time out when it isn't known yet; the app shows it as 'Set time'. Crew with notifications on are told about new items, the same as when it's added in the app.

- `tour_id` (required): string
- `title` (required): string
- `type` (optional): `venueAccess` \| `loadIn` \| `soundcheck` \| `doors` \| `headline` \| `packOut` \| `flight` \| `arrival` \| `hotel` \| `meeting` \| `freeTime` \| `catering` \| `travel` \| `content` \| `merch` \| `lounge` \| `custom`. Default custom
- `date` (required): string. YYYY-MM-DD
- `time` (optional): string. 24 hour HH:MM, local to where it happens
- `timezone` (required): string. IANA time zone of where it happens, e.g. America/Chicago
- `subtitle` (optional): string. Short second line, e.g. a place
- `notes` (optional): string
- `show_id` (optional): string. Attach it to a show day
- `color` (optional): string. One of: default, gray, brown, yellow, green, mint, teal, blue, purple, pink, red

### update_schedule_item (writes)

Change a schedule item's title, time, date, notes or colour. Only fields given change. Moving a show-timing item (load in, doors…) moves that time on the show too. Crew are notified of title and time changes, as in the app.

- `item_id` (required): string
- `title` (optional): string
- `type` (optional): `venueAccess` \| `loadIn` \| `soundcheck` \| `doors` \| `headline` \| `packOut` \| `flight` \| `arrival` \| `hotel` \| `meeting` \| `freeTime` \| `catering` \| `travel` \| `content` \| `merch` \| `lounge` \| `custom`
- `date` (optional): string. YYYY-MM-DD
- `time` (optional): string or null. null = time not known yet
- `timezone` (optional): string. IANA time zone of where it happens, e.g. America/Chicago
- `subtitle` (optional): string or null
- `notes` (optional): string or null
- `color` (optional): string or null

### delete_schedule_item (writes, confirm first)

Remove an item from the schedule. For a show-timing item this also clears that time on the show.

- `item_id` (required): string

### set_schedule_item_visibility (writes)

Show a schedule item to everyone on the tour, or only to chosen crew (by crew_id from get_tour → crew). People who can edit the tour always see it.

- `item_id` (required): string
- `visible_to` (required): string or list of string. "everyone", or a list of crew_ids

## Travel

### look_up_flight (read only)

Scheduled times and airports for a flight number on a date, from the live flight schedule. Use it before save_flight so times are right. If the number is a codeshare that comes back empty or wrong, pass the departure airport as `origin` to search that airport's schedule.

- `flight_number` (required): string. e.g. UA2279
- `date` (required): string. Departure date, local to the origin
- `origin` (optional): string. Departure airport IATA code

### save_flight (writes)

Add a flight to a tour, or update one when flight_id is given (then only fields given change; `passengers` replaces the whole list). Times are local to each airport; time zones are worked out from the airport codes. Passengers must be crew on the tour (add_crew_member first).

- `tour_id` (optional): string. Required when adding
- `flight_id` (optional): string
- `airline` (optional): string. Carrier code, e.g. UA
- `flight_number` (optional): string. e.g. UA2279
- `origin` (optional): string. IATA code
- `destination` (optional): string. IATA code
- `departure_date` (optional): string. YYYY-MM-DD, local
- `departure_time` (optional): string. 24 hour HH:MM, local
- `arrival_date` (optional): string. YYYY-MM-DD, local
- `arrival_time` (optional): string. 24 hour HH:MM, local
- `booking_reference` (optional): string
- `operated_by` (optional): string. The operating airline, for codeshares
- `notes` (optional): string
- `passengers` (optional): list of {crew_id: string, seat?: string, baggage?: string}

### delete_flight (writes, confirm first)

Remove a flight from a tour.

- `flight_id` (required): string

### save_hotel (writes)

Add a hotel stay to a tour, or update one when hotel_id is given (only fields given change). Check-in defaults to 15:00 and check-out to 11:00, local to the hotel. Assign rooms with set_hotel_rooms.

- `tour_id` (optional): string. Required when adding
- `hotel_id` (optional): string
- `name` (optional): string
- `address` (optional): string
- `city` (optional): string
- `country` (optional): string
- `timezone` (optional): string. The hotel's IANA zone. Required when adding
- `check_in_date` (optional): string. YYYY-MM-DD, local
- `check_in_time` (optional): string. 24 hour HH:MM, local
- `check_out_date` (optional): string. YYYY-MM-DD, local
- `check_out_time` (optional): string. 24 hour HH:MM, local
- `booking_reference` (optional): string
- `color` (optional): string

### set_hotel_rooms (writes)

Replace a hotel's room list: who is in which room. Guests are crew on the tour, by crew_id.

- `hotel_id` (required): string
- `rooms` (required): list of {room_number?: string, guest_crew_ids: list of string}

### delete_hotel (writes, confirm first)

Remove a hotel stay from a tour.

- `hotel_id` (required): string

### plan_route (read only)

The tour's legs between consecutive shows: road distance and drive time, whether to drive or fly, what time to leave, and whether each leg already has travel and a hotel booked. `gaps` counts legs still missing something.

- `tour_id` (required): string
- `max_drive_hours` (optional): number. Longest drive before flying is suggested

## Crew and guests

### add_crew_member (writes)

Add someone to a tour's crew. With an email, they are invited: someone who already has an Encore account is added and notified; someone new gets an email with a joining code. Without an email they are added as a name only (useful for flight manifests) and can be invited later with resend_invitation after update_crew_member adds their email. Owner or admin only. Editors can change the tour; viewers can only see it.

- `tour_id` (required): string
- `name` (required): string
- `email` (optional): string
- `phone` (optional): string
- `roles` (optional): list of string. e.g. Tour Manager, FOH, Driver
- `access_level` (optional): `editor` \| `viewer`. Default viewer
- `start_date` (optional): string. Access opens on this day (temporary crew)
- `end_date` (optional): string. Access ends after this day
- `send_invite` (optional): boolean. Default true. false adds them without emailing
- `color` (optional): string

### update_crew_member (writes)

Change a crew member's name, contact details, roles, access level or access dates. Only fields given change. Owner or admin only.

- `crew_id` (required): string
- `name` (optional): string
- `email` (optional): string
- `phone` (optional): string
- `roles` (optional): list of string
- `access_level` (optional): `editor` \| `viewer`
- `start_date` (optional): string or null. null removes it
- `end_date` (optional): string or null. null removes it
- `color` (optional): string or null

### remove_crew_member (writes, confirm first)

Take someone off a tour's crew and remove their access. Owner or admin only.

- `crew_id` (required): string

### resend_invitation (writes)

Email a crew member their invitation again (a fresh joining code if they have no account yet). They need an email on their crew record.

- `crew_id` (required): string

### add_guest (writes)

Add a name to a show's guest list.

- `show_id` (required): string
- `name` (required): string
- `additional_guests` (optional): string. Plus-ones, as a count, e.g. "1"
- `note` (optional): string

### update_guest (writes)

Change a guest list entry.

- `show_id` (required): string
- `guest_id` (required): string
- `name` (optional): string
- `additional_guests` (optional): string
- `note` (optional): string

### remove_guest (writes, confirm first)

Remove someone from a show's guest list.

- `show_id` (required): string
- `guest_id` (required): string

### notify_crew (writes, confirm first)

Send a push notification to everyone on a tour who has notifications on. Interrupts real people: confirm the wording with the person before sending. Under 180 characters.

- `tour_id` (required): string
- `message` (required): string

## Production

### save_gear_item (writes)

Add a line to a tour's gear list, or update one when gear_id is given. personal: true puts it on your own list instead of the tour's, which viewers can do too.

- `tour_id` (optional): string. Required when adding
- `gear_id` (optional): string
- `name` (optional): string
- `category` (optional): string. Default General
- `quantity` (optional): integer
- `notes` (optional): string or null
- `personal` (optional): boolean

### delete_gear_item (writes, confirm first)

Remove a line from a gear list.

- `gear_id` (required): string

### save_input (writes)

Add a channel to a tour's input list, or update one when input_id is given.

- `tour_id` (optional): string. Required when adding
- `input_id` (optional): string
- `channel` (optional): integer
- `name` (optional): string. e.g. Kick In
- `mic_or_di` (optional): string or null. e.g. Beta 91A
- `stand` (optional): string or null. e.g. Short boom
- `notes` (optional): string or null

### delete_input (writes, confirm first)

Remove a channel from the input list.

- `input_id` (required): string

### list_production_documents (read only)

A tour's production documents (tech rider, stage plot, venue specs…) with links to open them, plus the tour's stage plot image.

- `tour_id` (required): string

### add_production_document (writes)

Add a production document to a tour by its web link (e.g. a rider PDF someone shared). Files can't be uploaded through here; upload them in the app.

- `tour_id` (required): string
- `name` (required): string
- `type` (optional): string. e.g. Tech Rider, Stage Plot, Venue Specs. Default Other
- `url` (required): string. https:// link to the file

### remove_production_document (writes, confirm first)

Remove a production document from a tour.

- `document_id` (required): string

## Address book

### list_venues (read only)

Venues saved in this person's address book, optionally filtered by text (name, city, country).

- `query` (optional): string

### save_venue (writes)

Add a venue to the address book, or update one when venue_id is given.

- `venue_id` (optional): string
- `name` (optional): string
- `city` (optional): string
- `address` (optional): string
- `country` (optional): string
- `capacity` (optional): integer
- `contact_name` (optional): string
- `contact_email` (optional): string
- `contact_phone` (optional): string

### delete_venue (writes, confirm first)

Delete a venue from the address book. Shows that used it keep their own copy.

- `venue_id` (required): string

### list_contacts (read only)

Contacts in this person's address book (promoters, vendors, crew), optionally filtered by text (name, role, email, location). Sensitive details come only from get_contact.

- `query` (optional): string

### get_contact (read only)

One contact in full, including passport, emergency contact, allergies and loyalty numbers. Personal data: use it only for what the person asked.

- `contact_id` (required): string

### save_contact (writes)

Add a contact to the address book, or update one when contact_id is given. Passport details are saved only when number, country, issued and expiry are all known.

- `contact_id` (optional): string
- `name` (optional): string
- `roles` (optional): list of string
- `email` (optional): string
- `phone` (optional): string
- `location` (optional): string
- `notes` (optional): string
- `country_of_birth` (optional): string
- `allergies` (optional): string
- `medications` (optional): string
- `emergency_name` (optional): string
- `emergency_phone` (optional): string
- `passport_number` (optional): string
- `passport_country` (optional): string
- `passport_issued` (optional): string. YYYY-MM-DD
- `passport_expiry` (optional): string. YYYY-MM-DD

### delete_contact (writes, confirm first)

Delete a contact from the address book.

- `contact_id` (required): string

## Roster

### list_artists (read only)

Artists on this account's roster, with band members and default touring party.

- `include_archived` (optional): boolean

### save_artist (writes)

Add an artist to the roster, or update one when artist_id is given. archived: true hides it (artists are never deleted, because tours point at them).

- `artist_id` (optional): string
- `name` (optional): string
- `kind` (optional): `solo` \| `band`
- `color` (optional): string
- `archived` (optional): boolean
- `band_members` (optional): list of {person_id: string, instrument: string}. Replaces the band list. People come from list_people
- `touring_party` (optional): list of {person_id: string, role: string, included_by_default?: boolean}. Who a new tour's crew is seeded from. Replaces the list

### list_people (read only)

People on this account's roster: band members and crew who travel, with dietary and room/seat preferences. Optional text filter.

- `query` (optional): string

### get_person (read only)

One person on the roster in full, including passport, visa notes, loyalty numbers and emergency contact. Personal data: use it only for what the person asked.

- `person_id` (required): string

### save_person (writes)

Add a person to the roster, or update one when person_id is given. Includes passport (all four fields together), visa notes, loyalty numbers and emergency contact. Read them back with get_person.

- `person_id` (optional): string
- `name` (optional): string
- `email` (optional): string
- `phone` (optional): string
- `nationality` (optional): string
- `dietary_requirements` (optional): string
- `allergies` (optional): string
- `room_preference` (optional): string
- `seat_preference` (optional): string
- `passport_number` (optional): string
- `passport_country` (optional): string
- `passport_issued` (optional): string. YYYY-MM-DD
- `passport_expiry` (optional): string. YYYY-MM-DD
- `visa_notes` (optional): string
- `loyalty_programs` (optional): list of {airline: string, account_number: string}. Replaces the list
- `emergency_name` (optional): string
- `emergency_phone` (optional): string
