# MCP: events Source: Locale: ru releaseGitSha: 0bb11ef116e17ec64c802d5476eaff442e53d252 sourceContentDigest: f2542d053f18f85aeb26e64389d6e10d558a3a5d5414abe4e0f0c6a6aa034505 Version: 9 # 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". [Вход, результат и права](https://telegafirst.com/docs/mcp-tool-cancel-event-registration) ## check\_in\_event\_registration Record operational check-in for an event registration. idempotency\_key is required. Scopes (ALL): \["events:write"]. Risk: "write". [Вход, результат и права](https://telegafirst.com/docs/mcp-tool-check-in-event-registration) ## 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". [Вход, результат и права](https://telegafirst.com/docs/mcp-tool-create-event) ## 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". [Вход, результат и права](https://telegafirst.com/docs/mcp-tool-create-event-registration) ## delete\_event Soft-delete an event by \`seqNum\`. Idempotent (deleting an absent/already-deleted event returns deleted:true). Scopes (ALL): \["events:write"]. Risk: "destructive". [Вход, результат и права](https://telegafirst.com/docs/mcp-tool-delete-event) ## get\_event\_registration Read one event registration by its tenant-local registration\_seq\_num. Scopes (ALL): \["events:read"]. Risk: "read". [Вход, результат и права](https://telegafirst.com/docs/mcp-tool-get-event-registration) ## list\_event\_registrations List event registrations with a bounded cursor. All identifiers are tenant-local seq\_num values. Scopes (ALL): \["events:read"]. Risk: "read". [Вход, результат и права](https://telegafirst.com/docs/mcp-tool-list-event-registrations) ## 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". [Вход, результат и права](https://telegafirst.com/docs/mcp-tool-list-events) ## 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". [Вход, результат и права](https://telegafirst.com/docs/mcp-tool-test-funnel-pipeline) ## 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". [Вход, результат и права](https://telegafirst.com/docs/mcp-tool-update-event)