SAIRYŌ

Copy explicitly selected safe settings from a manageable event at its observed version into a new private pending draft with sales off. Media, discounts, attendees, financial data and shared-pass relationships are excluded. Tier sale dates shift by the new event start-date difference; tiers remain paused. Requires ticket-tier write scope only when tiers are selected.

create_event_from_template

Use this tool when the user wants to add one ticket tier to an existing event, including its price, quantity, sale dates, visibility, bundle settings, and optional discounts. Existing tiers remain active.

create_ticket_tier

Delete an owned private event with sales off and no ticket, order or payment history, using the website's media cleanup flow. Requires explicit user confirmation. Events with history must be cancelled instead.

delete_event

Permanently delete a tier with no ticket, reward, fulfillment or pass history. Pause its sales or event sales first. Outstanding event orders block deletion; archive tiers with history instead. A reason is recorded.

delete_ticket_tier

Generate a UTF-8, formula-injection-safe CSV of authorized attendee personal data from the supplied filters and return a short-lived download. Requires attendee-read and export-create scopes.

export_event_attendees_csv

Generate a short-lived CSV containing the underlying computed metrics used by the grounded insight report.

export_event_insight_metrics_csv

Generate a server-side UTF-8 and formula-injection-safe CSV matching the exact authorized transaction filters.

export_event_transactions_csv

Create a copy of one active tier, including its advanced settings and discounts, with a distinct name.

duplicate_ticket_tier

Compute traceable sales, revenue, tier, check-in, no-show, refund, promo/referral, and anomaly insights from authorized structured aggregates with freshness and source counts.

generate_event_insights

Review paginated Ready, Needs Media and Errors rows. Present this snapshot to the user before requesting explicit start or cancel confirmation.

get_bulk_import_preview

Inspect owned background import progress, affected event IDs and actionable row errors without exposing raw CSV or media keys.

get_bulk_import_status

Read-only, ordered event recommendations grounded in stored settings, readiness and tier availability with version and timestamps. Ended-event insight evidence is included only with held insight scope and finance authorization. Every recommended write requires explicit invocation of an existing authorized tool.

get_event_action_plan

Use this tool when the user wants paginated ticket-based attendee records for one SAIRYO event. Ticket-attendee and ticketing-guest totals are returned separately.

get_event_attendees

Use this tool when the user wants up to 100 audit records for changes to one SAIRYO event, ordered from newest to oldest.

get_event_audit_log

Retrieve valid category IDs, checkout currencies, event types, cost types, media limits, and the current host payout readiness before creating an event.

get_event_creation_options

Use this tool when the user wants the stored details of one SAIRYO event they own or co-host and the event ID is known.

get_event_detail

Use this tool when the user is preparing changes to one SAIRYO event and needs its current version, edit permissions, ticket tiers, co-hosts, referrals, discount codes, validation rules, and warnings.

get_event_management_context

Return permanent event media URLs and promotional-video processing state without exposing temporary upload URLs.

get_event_media

Run the same complete blocking validation used by publish_event and return issues, warnings, ticket, media, and payout summaries.

get_event_publish_readiness

Use this tool when the user wants ticket and revenue totals for one event, including tickets sold, gross revenue, successful refunds, net revenue, and ticket-tier data. It does not return attendee identities.

get_event_sales_summary

Use this tool when the user wants the current ticket tiers for one SAIRYO event, including price, quantity, sold and available counts, sale dates, visibility, and archive eligibility.

get_event_ticket_tiers

Read-only paginated refund/payment discrepancies, missing payment references and required payout adjustments. Does not claim full provider settlement reconciliation where ledger links are missing.

get_financial_reconciliation

Compare currency-separated current and immediately preceding periods with exact decimal changes and order counts. Percentage change is unavailable when no exact denominator is provided.

get_financial_trends

Use the shared website Earnings by Event calculation for finance-authorized events and videos by native currency, with netRevenue (website totalEarnings) and hostNet (website totalArtistEarnings), resale collapse and caller proceeds, refunds, discounts, taxes and pending payments. Report unavailable settlement fees and payable ledger explicitly; payout totals cover only the caller account.

get_host_financial_overview

List accessible event IDs, caller roles and eventPermissions, plus capabilities intersected with the current request's grantedScopes and missingScopes per capability. A false capability can mean this token needs additional OAuth scopes; it does not prove the user lacks event permission or that another tool call using another token must fail. Does not grant authority. Delegated state alone does not grant access to existing MCP tools.

get_my_management_scope

Read caller period withdrawal activity and lifetime native-currency account balances using website payout rules, including product proceeds, ambassador holds and pending/in-transit reservations. Settlement fees remain unavailable; lifetime balances ignore event/date filters.

get_payout_summary

Break down authorized transaction revenue by event, video, month, payment method, recipient or referral with source denominators. Tier allocation is unavailable and returns an explicit error rather than inferred revenue.

get_revenue_breakdown

Use this tool when the user has an item ID returned by search_sairyo_events_and_reports and wants the corresponding event summary or report reference, including its URL and metadata.

get_sairyo_event_or_report_reference

Use this tool when the user wants aggregate tickets sold, gross revenue, successful refunds, and net revenue across their managed SAIRYO events for a specified date range. Totals are returned separately for each actual event currency and are not converted.

get_sales_metrics_for_date_range

Retrieve a current signed opaque QR token image for an existing ticket without embedding attendee PII or order details. Set includeToken to return the ticket credential for programmatic check-in. Use the version-checked regeneration tool if it is missing or expired.

get_ticket_qr_code

Return each active tier's manual pause state, sale window, inventory, and whether it is currently purchasable.

get_ticket_tier_sales_status

Report queued, running, ready, or failed state for a transaction export and return a download only when ready.

get_transaction_export_status

Inspect independently detected spatial profile, codecs, Apple validation, fallback and HLS verification. A hint is never proof of readiness. Returns no raw storage keys or paid playback URLs.

get_video_processing_status

Report authorized VIDEO purchase transactions, successful refund amounts and caller proceeds. Views are never counted as purchases.

get_video_revenue

Return a short lived PUT URL only for an owned active session. Do not log or share the URL.

get_video_upload_part_url

Initiate a resumable primary video multipart upload. The client must PUT bytes directly; if it cannot, present the returned private browser handoffUrl. Never send video bytes through MCP or fetch arbitrary remote URLs.

initiate_video_upload

Issue a zero-value ticket to a verified user against eligible inventory and record the issuer and reason.

issue_complimentary_ticket

Link an owned session with the exact requested media profile to an import item. Processing verifies the detected profile.

link_bulk_import_media

Read recorded platform withdrawals across all users for the connected ADMIN account. Includes manual and automated payout records in every status. Does not calculate future scheduled payouts or contact payment providers. Paginate using nextCursor with unchanged filters.

list_admin_payouts

Read all platform transaction recipient ledger rows for the connected ADMIN account. Paginate using nextCursor with unchanged filters. Includes all statuses by default. Customer totals repeat across recipient splits; do not sum them as platform revenue. No purchaser contact data, payment credentials or provider payloads are returned.

list_admin_transactions