Для AI-агентов: markdown этой страницы — /docs/mcp-events.mdиндекс документации — /llms.txt
MCP: events
Обновлено
Определения инструментов. Обновляйте tools/list после изменения прав. required_scopes: ALL.
cancel_event_registration
Cancel a free event registration. A paid registration returns REFUND_REQUIRED and is not cancelled. idempotency_key is required.
Scopes (ALL): ["events:write"]. Risk: "write".
check_in_event_registration
Record operational check-in for an event registration. idempotency_key is required.
Scopes (ALL): ["events:write"]. Risk: "write".
create_event
Create an event (declarative config — start/end TIMES are set separately in the Mini App, which also drives the phase machine). Provide a title; optionally a capacity, a target registration count, the reach pair (`is_active` = switched on at all, default false — a new event is a draft; `is_public` = shown in the Афиша, default true — an active event that is not public is still openable by its link), `is_online` for an online event, and notification flags. A deeplink code is generated automatically. Returns the created event (phase=draft) with its assigned `seqNum`.
Scopes (ALL): ["events:write"]. Risk: "write".
create_event_registration
Register a tenant user for an event. Paid tickets return payment_required and intentionally do not create an order or payment here. idempotency_key is required.
Scopes (ALL): ["events:write"]. Risk: "write".
delete_event
Soft-delete an event by `seqNum`. Idempotent (deleting an absent/already-deleted event returns deleted:true).
Scopes (ALL): ["events:write"]. Risk: "destructive".
get_event_registration
Read one event registration by its tenant-local registration_seq_num.
Scopes (ALL): ["events:read"]. Risk: "read".
list_event_registrations
List event registrations with a bounded cursor. All identifiers are tenant-local seq_num values.
Scopes (ALL): ["events:read"]. Risk: "read".
list_events
List the tenant events. Returns each with its `seqNum` (the id you pass to update/delete), title, engine-driven phase (draft/registration/…/completed — read-only), capacity, target, reach (`isActive`/`isPublic`), online format (`isOnline`), notification flags, deeplink code and start/end times (times are set in the Mini App). 0-cost read.
Scopes (ALL): ["events:read"]. Risk: "read".
test_funnel_pipeline
DRY-RUN an event funnel and report where it breaks, without sending anything. Pass `event_id` (the event `seqNum` from list_events); optionally `chain_seq_nums` for chains you are about to bind and want checked first — the event's own eight automation slots are always checked. Returns one row per pipeline stage (registration / qualifier / delay / tripwire / checkout / booking) with a status, plus machine-readable problem codes: a chain that belongs to nobody (CHAIN_NOT_OWNED), is deleted, inactive, has no steps or no entry point; a ticket that is not a ticket (CATALOG_WRONG_SCOPE — an event selling a shop product at the shop price), has no price or is switched off; a tenant selling booking with no live resource. Also reports the total delay in minutes a run would wait. NOTHING is enrolled, promoted, sent or written. `notChecked` names what this run did NOT verify — read it before treating ok:true as «the funnel works». 0-cost read.
Scopes (ALL): ["events:read"]. Risk: "read".
update_event
Update an event by its `seqNum` (a partial patch — send only the fields you change; phase + start/end times are NOT settable here). `is_online` marks an event as online. Also binds the event automation with seq addresses: `registration_chain_seq_num`, `checkin_chain_seq_num`, `checkout_chain_seq_num`, `post_event_chain_seq_num`, `decline_chain_seq_num`, `start_event_chain_seq_num`, `no_show_chain_seq_num`, `reminder_24h_chain_seq_num` — each a message-chain seq_num as a string (send `null` to unbind, omit to leave alone). Each binding also accepts an ENTRY STEP — `registration_chain_step_seq`, `checkin_chain_step_seq`, `checkout_chain_step_seq`, `post_event_chain_step_seq`, `decline_chain_step_seq`, `start_event_chain_step_seq`, `no_show_chain_step_seq`, `reminder_24h_chain_step_seq` — a step seq_num of THAT SAME chain, meaning «start the funnel at this step instead of at the beginning». A step is only accepted TOGETHER with its chain in the same call; sending a step without its chain is an error, and sending a chain without a step means «start from the beginning» (which is NOT the same as naming whichever step is first today — the first step can be edited). Plus `catalog_ids` containing tenant Catalog.seq_num positive int4 decimal strings for ticket tiers (whole list; `[]` unbinds); response `catalogIds` carries those same sequence strings, never Catalog primary keys. `capacity` may not exceed `target_registrations`. Idempotent. Returns the updated event. Errors NOT_FOUND if an event or catalog sequence does not exist for your tenant.
Scopes (ALL): ["events:write"]. Risk: "write".