Tonk

Search Tonk's maintained Nashville venue catalog by venue name or neighborhood, with optional area and category filters. Returns up to 10 matches and location IDs for display_data. Does not browse the web or save changes.

search_venues

Search the maintained Tonk artist catalog by name. Returns up to 10 matches, public music facts and artist IDs for display_data. Does not browse the web or save changes.

search_artists

Activate free Tonk access only when the user explicitly chooses to activate it. This does not purchase a subscription. Returns the authenticated account's current capabilities.

activate_free_access

Add a named artist to the linked user's Tonk favorites when requested. May research and add an unknown artist to the catalog. Saves the preference and records a change for any existing Tonk background agent.

add_favorite_artist

Cancel an existing Tonk agent task using its exact ID and current revision. Stops its future scheduled work. Does not recall messages already sent.

cancel_scheduled_task

Schedule a user-requested future Tonk agent task in the linked workspace. The task may send requested messages through enabled Tonk methods when due. Use recurrence only for an explicitly requested repeating task. Does not book shows or create external calendar events.

create_scheduled_task

Display cards for up to 10 show, artist or venue IDs returned by Tonk catalog search. Fetches current catalog details without saving changes.

display_data

Prepare an email draft for the authenticated user's enabled Tonk email method. Supply only the requested content and optional Tonk document attachments; Tonk resolves the recipient. Does not send.

draft_email

Prepare a text draft for the authenticated user's enabled, consented Tonk phone number. Tonk resolves the recipient. Does not send.

draft_text

Complete the linked user's Tonk setup after their communication choices have been reviewed and saved. Saves the short setup summary, updates setup status and optional Nashville relationship, and records account and party-workspace events that existing Tonk agents may act on through enabled communication methods. Does not purchase or activate a subscription.

finish_onboarding

Create and save a private PDF of the requested Nashville music report, itinerary or show picks from structured content blocks. Returns an authorized download. Does not send the document.

generate_document

List the linked workspace's current Tonk agent tasks and their revision timestamps. Does not change their schedule or run the tasks.

list_scheduled_tasks

Open the linked user's current Tonk email, text and phone communication settings for review. Reads current settings without saving changes. The user enters contact details and new consent in the form.

open_communication_settings

Prepare an account-bound review of the communication preferences selected in the Tonk component.

prepare_communication_review

Suggest up to 20 artists for the onboarding favorite picker from a brief description of the user's music taste. Uses public web research. Does not save favorites.

recommend_favorite_artists

Save one music preference or Nashville trip fact the user asked Tonk to remember. Appends a typed private account record; provide only that fact, not conversation history.

record_user_context

Save one shared Nashville trip fact, party preference or group constraint in the linked Tonk workspace. Appends a typed record; provide only the requested fact, not conversation history.

record_workspace_context

Remove a named artist from the linked user's active Tonk favorites when requested. Saves the removal and records a change for any existing Tonk background agent. Does not research or create artists.

remove_favorite_artist

Change when an existing Tonk agent task runs using its exact ID and current revision. The scheduled task may send requested messages through enabled Tonk methods. Specify occurrence to move its next run or series to change an explicitly requested recurrence.

reschedule_scheduled_task

Apply the communication choices reviewed in the Tonk component using its account-bound token. May replace contact details, enable or disable methods, record consent and send an introductory SMS when text consent is first granted.

save_communication_review

Send the reviewed email to the authenticated user's enabled Tonk email address after the user requests delivery. Tonk resolves the recipient. Supply the reviewed HTML body and authorized Tonk attachments. Delivery cannot be recalled; reuse the same idempotency key for the same send and inspect uncertain results before retrying.

send_email

Send the reviewed SMS to the authenticated user's enabled, consented Tonk phone number after the user requests delivery. Tonk resolves the recipient. Delivery cannot be recalled; reuse the same idempotency key for the same send and inspect uncertain results before retrying.

send_text

Enable or disable existing Tonk communication methods where current consent permits, at the user's request. Saves those settings. Contact changes and first-time consent require the communication settings form.

update_communication_preferences