Tool reference

This is the full tool catalog – 62 tools when every add-on is active. You never call these yourself: the AI picks them based on your question. Tool groups register only when their add-on is active, and each connection sees only the tools its user’s permissions and scopes allow.

Conventions

• Dates use the site timezone: Y-m-d for filters, Y-m-d H:i:s for datetimes. venuera_site_info tells the AI your timezone and currency up front.
• Recurring occurrence ids are numeric for stored dates or virtual:Y-m-d H:i:s for schedule dates that haven’t been booked yet.
• Lists paginate – up to 50 items per page (100 for occurrences); seat and answer lists cap at 200 rows.
• (write) marks tools that change data; (destructive) marks the ones flagged for extra client-side caution.

Always available – core

• venuera_site_info – site context: currency, timezone, active add-ons, event & ticket statuses, conventions. The AI calls this first to calibrate everything else.
• venuera_list_media – browse images in the media library.
• venuera_upload_media (write) – upload an image (JPEG/PNG/GIF/WebP, max 8 MB) from base64 data or a public URL.
• venuera_set_event_image (write) – set an event’s featured image.

Events & ticket types – core

• venuera_list_events – list events with basic sales numbers; filter by status, date range or search.
• venuera_get_event – full event details: dates, venue, ticket types with price and remaining availability, seating chart.
• venuera_create_event (write) – create an event as a draft; returns the wp-admin edit link for a human to review and publish.
• venuera_update_event (write, destructive) – change title, dates, venue, description or operational status; cancelling never refunds tickets by itself.
• venuera_delete_event (write, destructive) – move an event to the Trash (reversible); refuses if tickets are sold unless forced.
• venuera_create_ticket_type (write) – create a simple or variable ticket type as a draft product with price, capacity and per-order limits.
• venuera_update_ticket_type (write) – update label, price, capacity, status or variations.
• venuera_delete_ticket_type (write, destructive) – move a ticket type to the Trash; sold tickets stay valid.

Tickets, guests & reports – core

• venuera_get_event_stats – sold, checked in, refunded, revenue and per-type breakdown for one event or occurrence.
• venuera_list_tickets – tickets of an event: UID, status, type, seat, order.
• venuera_get_ticket – one ticket by UID: attendee, seat, entry history, and whether it would pass a scan right now.
• venuera_list_attendees – the guest list with check-in status; search by name, email or UID; filter to not-yet-arrived.
• venuera_lookup_order – a WooCommerce order by id or number, with its tickets.
• venuera_sales_overview – aggregate sales for all events in a date range (up to 25 events per call).
• venuera_export_tickets – generate a CSV or PDF attendee list; returns a download link that expires after 24 hours.

Check-in (Check-in app)

• venuera_checkin_scan (write) – scan a code and check the ticket in; peek mode evaluates the rules without recording. Returns the same statuses as the door app: ok, already used, max reached, wrong event…
• venuera_checkin_undo (write, destructive) – undo a ticket’s most recent entry (managers only).
• venuera_checkin_stats – live door counts: sold, checked in, remaining.
• venuera_checkin_history – every recorded entry of one ticket.

Occurrences (Recurring Events)

• venuera_list_occurrences – the dates of a series, stored and virtual, with per-date sales.
• venuera_get_occurrence_availability – remaining availability per ticket type for one date.
• venuera_preview_recurrence – preview the dates a rule would generate, without saving anything.
• venuera_set_recurrence_rule (write, destructive) – set or replace an event’s recurrence rule; booked dates are always kept.
• venuera_add_occurrence_exception (write, destructive) – add an extra or moved date, optionally excluding the original.
• venuera_delete_occurrence (write, destructive) – delete one stored date; refuses if tickets or seats reference it unless forced.

Seating (Venue Designer)

• venuera_list_venue_charts – all seating charts with seat counts and assigned events.
• venuera_get_chart_summary – zones and elements of one chart with per-element seat counts and ticket-type mapping.
• venuera_get_seat_availability – availability per zone/element for an event, optionally listing free seat labels.
• venuera_get_sold_seats – sold seats with their tickets and orders.
• venuera_assign_chart_to_event (write) – attach a chart to an event.
• venuera_block_seats / venuera_unblock_seats (write, destructive) – take seats off sale (and put them back) as operator blocks – sold seats are never touched.
• venuera_get_venue_design_reference – the authoring vocabulary for building charts (element kinds, numbering rules, coordinates).
• venuera_create_venue_chart (write) – build a whole seating chart from a description: rows, round and rectangular tables, standing areas, stages (up to 25,000 seats).
• venuera_update_venue_chart (write) – rename a chart or replace its layout; refuses to orphan sold seats unless forced.
• venuera_delete_venue_chart (write, destructive) – permanently delete a chart (no trash); refuses while assigned or with sold seats unless forced.

Attendee data (Custom Attendee Fields)

• venuera_list_attendee_fields – the fields collected per ticket for a product or a whole event.
• venuera_get_attendee_answers – aggregate answers (“how many vegetarian menus?”) or per-ticket answers for one field.
• venuera_set_attendee_fields (write, destructive) – define a product’s custom fields (nine types); replaces the field set, keeping answers of unchanged fields.

Ticket design (Ticket Designer – administrators only)

• venuera_list_ticket_templates – all PDF templates with size, status and assignments.
• venuera_get_ticket_design_reference – the complete designer vocabulary: elements, bindable data fields, fonts, sizes, barcode formats.
• venuera_create_ticket_template (write) – create a template from designer JSON – the AI can design a full ticket from a description.
• venuera_update_ticket_template (write, destructive) – update or fully replace a template’s design.
• venuera_duplicate_ticket_template (write) – copy a template as a starting point.
• venuera_delete_ticket_template (write, destructive) – permanently delete a template; the global default is protected.
• venuera_preview_ticket_template – render a preview with sample data and return its link.
• venuera_assign_ticket_template (write) – assign a template to an event or product.
• venuera_get_ticket_pdf_link – a secure, login-free PDF link for one ticket or a whole order (expires after 24 hours).

Point of Sale (POS)

• venuera_pos_sales_report – POS sales for a range: summary, by day, by cashier, top products or by event.
• venuera_pos_current_session – the open register session with live totals per payment method.
• venuera_pos_shift_report – a full X/Z report: float, cash, pay-ins/outs, expected vs counted, variance.
• venuera_pos_list_sessions – session history with cashiers and cash differences.
• venuera_pos_order_summary – a receipt-style view of one POS order.
• venuera_pos_prepare_order (write) → venuera_pos_confirm_order (write, destructive) – the two-step sale: prepare validates the cart and returns a summary plus a 10-minute confirmation token; nothing is charged until confirm.
• venuera_pos_prepare_refund (write) → venuera_pos_confirm_refund (write, destructive) – the two-step refund, with the same summary-then-confirm safety.