Для AI-агентов: markdown этой страницы — /docs/mcp-events.mdиндекс документации — /llms.txt
MCP: events
Обновлено
MCP: events
Это определения инструментов из текущего ToolRegistry, включая полные inputSchema/outputSchema, scope, required_scopes (ALL), risk и версию платформы. Наличие определения не означает, что инструмент уже установлен вашим хостом или разрешён вашим credential. Обновляйте tools/list после изменения бизнеса, readiness и прав. Progressive disclosure через load_domain/describe_tool и существующий meta-dispatch описаны в MCP-руководстве. Scopes и права применяются при вызове; risk не заменяет согласие и отдельные требования денежной операции. JSON ниже — схема, а не успешный результат вызова.
cancel_event_registration
Cancel a free event registration. A paid registration returns REFUND_REQUIRED and is not cancelled. idempotency_key is required.
{
"description": "Cancel a free event registration. A paid registration returns REFUND_REQUIRED and is not cancelled. idempotency_key is required.",
"domain": "events",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"idempotency_key": {
"description": "Value for idempotency key.",
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"registration_seq_num": {
"description": "Value for registration seq num.",
"exclusiveMinimum": 0,
"maximum": 2147483647,
"type": "integer"
}
},
"required": [
"registration_seq_num",
"idempotency_key"
],
"type": "object"
},
"name": "cancel_event_registration",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"events:write"
],
"risk": "write",
"scope": "events:write",
"title": "Cancel Event Registration"
}check_in_event_registration
Record operational check-in for an event registration. idempotency_key is required.
{
"description": "Record operational check-in for an event registration. idempotency_key is required.",
"domain": "events",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"idempotency_key": {
"description": "Value for idempotency key.",
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"registration_seq_num": {
"description": "Value for registration seq num.",
"exclusiveMinimum": 0,
"maximum": 2147483647,
"type": "integer"
}
},
"required": [
"registration_seq_num",
"idempotency_key"
],
"type": "object"
},
"name": "check_in_event_registration",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"events:write"
],
"risk": "write",
"scope": "events:write",
"title": "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.
{
"description": "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`.",
"domain": "events",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"auto_notify": {
"description": "Value for auto notify.",
"type": "boolean"
},
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"capacity": {
"anyOf": [
{
"description": "Value for capacity option.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
{
"description": "Value for capacity option.",
"type": "null"
}
],
"description": "Value for capacity."
},
"is_active": {
"description": "Value for is active.",
"type": "boolean"
},
"is_marketing_view": {
"description": "Value for is marketing view.",
"type": "boolean"
},
"is_online": {
"description": "Value for is online.",
"type": "boolean"
},
"is_public": {
"description": "Value for is public.",
"type": "boolean"
},
"target_registrations": {
"anyOf": [
{
"description": "Value for target registrations option.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
{
"description": "Value for target registrations option.",
"type": "null"
}
],
"description": "Value for target registrations."
},
"title": {
"description": "Value for title.",
"maxLength": 200,
"minLength": 1,
"type": "string"
}
},
"required": [
"title"
],
"type": "object"
},
"name": "create_event",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"events:write"
],
"risk": "write",
"scope": "events:write",
"title": "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.
{
"description": "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.",
"domain": "events",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"catalog_seq_num": {
"description": "Value for catalog seq num.",
"exclusiveMinimum": 0,
"maximum": 2147483647,
"type": "integer"
},
"event_seq_num": {
"description": "Value for event seq num.",
"exclusiveMinimum": 0,
"maximum": 2147483647,
"type": "integer"
},
"idempotency_key": {
"description": "Value for idempotency key.",
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"user_seq_num": {
"description": "Value for user seq num.",
"exclusiveMinimum": 0,
"maximum": 2147483647,
"type": "integer"
}
},
"required": [
"event_seq_num",
"user_seq_num",
"idempotency_key"
],
"type": "object"
},
"name": "create_event_registration",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"events:write"
],
"risk": "write",
"scope": "events:write",
"title": "Create Event Registration"
}delete_event
Soft-delete an event by seqNum. Idempotent (deleting an absent/already-deleted event returns deleted:true).
{
"description": "Soft-delete an event by `seqNum`. Idempotent (deleting an absent/already-deleted event returns deleted:true).",
"domain": "events",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"seq_num": {
"description": "Value for seq num.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
}
},
"required": [
"seq_num"
],
"type": "object"
},
"name": "delete_event",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"events:write"
],
"risk": "destructive",
"scope": "events:write",
"title": "Delete Event"
}get_event_registration
Read one event registration by its tenant-local registration_seq_num.
{
"description": "Read one event registration by its tenant-local registration_seq_num.",
"domain": "events",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"registration_seq_num": {
"description": "Value for registration seq num.",
"exclusiveMinimum": 0,
"maximum": 2147483647,
"type": "integer"
}
},
"required": [
"registration_seq_num"
],
"type": "object"
},
"name": "get_event_registration",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"events:read"
],
"risk": "read",
"scope": "events:read",
"title": "Get Event Registration"
}list_event_registrations
List event registrations with a bounded cursor. All identifiers are tenant-local seq_num values.
{
"description": "List event registrations with a bounded cursor. All identifiers are tenant-local seq_num values.",
"domain": "events",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"cursor": {
"description": "Value for cursor.",
"pattern": "^\\d+$",
"type": "string"
},
"event_seq_num": {
"description": "Value for event seq num.",
"exclusiveMinimum": 0,
"maximum": 2147483647,
"type": "integer"
},
"limit": {
"description": "Value for limit.",
"maximum": 100,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "list_event_registrations",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"events:read"
],
"risk": "read",
"scope": "events:read",
"title": "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.
{
"description": "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.",
"domain": "events",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "list_events",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"events:read"
],
"risk": "read",
"scope": "events:read",
"title": "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.
{
"description": "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.",
"domain": "events",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"chain_seq_nums": {
"description": "Value for chain seq nums.",
"items": {
"description": "Value for chain seq nums item.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"maxItems": 32,
"type": "array"
},
"event_id": {
"description": "Value for event id.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
}
},
"required": [
"event_id"
],
"type": "object"
},
"name": "test_funnel_pipeline",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"events:read"
],
"risk": "read",
"scope": "events:read",
"title": "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.
{
"description": "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.",
"domain": "events",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"auto_notify": {
"description": "Value for auto notify.",
"type": "boolean"
},
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"capacity": {
"anyOf": [
{
"description": "Value for capacity option.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
{
"description": "Value for capacity option.",
"type": "null"
}
],
"description": "Value for capacity."
},
"catalog_ids": {
"description": "Value for catalog ids.",
"items": {
"description": "Tenant Catalog.seq_num as a canonical positive decimal string in the inclusive range 1..2147483647; no leading zeros and never a Catalog primary key.",
"maxLength": 10,
"minLength": 1,
"pattern": "^(?:[1-9][0-9]{0,8}|1[0-9]{9}|20[0-9]{8}|21[0-3][0-9]{7}|214[0-6][0-9]{6}|2147[0-3][0-9]{5}|21474[0-7][0-9]{4}|214748[0-2][0-9]{3}|2147483[0-5][0-9]{2}|21474836[0-3][0-9]|214748364[0-7])$",
"type": "string"
},
"type": "array"
},
"checkin_chain_seq_num": {
"anyOf": [
{
"description": "Value for checkin chain seq num option.",
"pattern": "^\\d+$",
"type": "string"
},
{
"description": "Value for checkin chain seq num option.",
"type": "null"
}
],
"description": "Value for checkin chain seq num."
},
"checkin_chain_step_seq": {
"anyOf": [
{
"description": "Value for checkin chain step seq option.",
"pattern": "^\\d+$",
"type": "string"
},
{
"description": "Value for checkin chain step seq option.",
"type": "null"
}
],
"description": "Value for checkin chain step seq."
},
"checkin_mode": {
"description": "Value for checkin mode.",
"enum": [
"self_service",
"operator_only"
],
"type": "string"
},
"checkout_chain_seq_num": {
"anyOf": [
{
"description": "Value for checkout chain seq num option.",
"pattern": "^\\d+$",
"type": "string"
},
{
"description": "Value for checkout chain seq num option.",
"type": "null"
}
],
"description": "Value for checkout chain seq num."
},
"checkout_chain_step_seq": {
"anyOf": [
{
"description": "Value for checkout chain step seq option.",
"pattern": "^\\d+$",
"type": "string"
},
{
"description": "Value for checkout chain step seq option.",
"type": "null"
}
],
"description": "Value for checkout chain step seq."
},
"decline_chain_seq_num": {
"anyOf": [
{
"description": "Value for decline chain seq num option.",
"pattern": "^\\d+$",
"type": "string"
},
{
"description": "Value for decline chain seq num option.",
"type": "null"
}
],
"description": "Value for decline chain seq num."
},
"decline_chain_step_seq": {
"anyOf": [
{
"description": "Value for decline chain step seq option.",
"pattern": "^\\d+$",
"type": "string"
},
{
"description": "Value for decline chain step seq option.",
"type": "null"
}
],
"description": "Value for decline chain step seq."
},
"is_active": {
"description": "Value for is active.",
"type": "boolean"
},
"is_marketing_view": {
"description": "Value for is marketing view.",
"type": "boolean"
},
"is_online": {
"description": "Value for is online.",
"type": "boolean"
},
"is_public": {
"description": "Value for is public.",
"type": "boolean"
},
"no_show_chain_seq_num": {
"anyOf": [
{
"description": "Value for no show chain seq num option.",
"pattern": "^\\d+$",
"type": "string"
},
{
"description": "Value for no show chain seq num option.",
"type": "null"
}
],
"description": "Value for no show chain seq num."
},
"no_show_chain_step_seq": {
"anyOf": [
{
"description": "Value for no show chain step seq option.",
"pattern": "^\\d+$",
"type": "string"
},
{
"description": "Value for no show chain step seq option.",
"type": "null"
}
],
"description": "Value for no show chain step seq."
},
"post_event_chain_seq_num": {
"anyOf": [
{
"description": "Value for post event chain seq num option.",
"pattern": "^\\d+$",
"type": "string"
},
{
"description": "Value for post event chain seq num option.",
"type": "null"
}
],
"description": "Value for post event chain seq num."
},
"post_event_chain_step_seq": {
"anyOf": [
{
"description": "Value for post event chain step seq option.",
"pattern": "^\\d+$",
"type": "string"
},
{
"description": "Value for post event chain step seq option.",
"type": "null"
}
],
"description": "Value for post event chain step seq."
},
"registration_chain_seq_num": {
"anyOf": [
{
"description": "Value for registration chain seq num option.",
"pattern": "^\\d+$",
"type": "string"
},
{
"description": "Value for registration chain seq num option.",
"type": "null"
}
],
"description": "Value for registration chain seq num."
},
"registration_chain_step_seq": {
"anyOf": [
{
"description": "Value for registration chain step seq option.",
"pattern": "^\\d+$",
"type": "string"
},
{
"description": "Value for registration chain step seq option.",
"type": "null"
}
],
"description": "Value for registration chain step seq."
},
"reminder_24h_chain_seq_num": {
"anyOf": [
{
"description": "Value for reminder 24h chain seq num option.",
"pattern": "^\\d+$",
"type": "string"
},
{
"description": "Value for reminder 24h chain seq num option.",
"type": "null"
}
],
"description": "Value for reminder 24h chain seq num."
},
"reminder_24h_chain_step_seq": {
"anyOf": [
{
"description": "Value for reminder 24h chain step seq option.",
"pattern": "^\\d+$",
"type": "string"
},
{
"description": "Value for reminder 24h chain step seq option.",
"type": "null"
}
],
"description": "Value for reminder 24h chain step seq."
},
"seq_num": {
"description": "Value for seq num.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"start_event_chain_seq_num": {
"anyOf": [
{
"description": "Value for start event chain seq num option.",
"pattern": "^\\d+$",
"type": "string"
},
{
"description": "Value for start event chain seq num option.",
"type": "null"
}
],
"description": "Value for start event chain seq num."
},
"start_event_chain_step_seq": {
"anyOf": [
{
"description": "Value for start event chain step seq option.",
"pattern": "^\\d+$",
"type": "string"
},
{
"description": "Value for start event chain step seq option.",
"type": "null"
}
],
"description": "Value for start event chain step seq."
},
"target_registrations": {
"anyOf": [
{
"description": "Value for target registrations option.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
{
"description": "Value for target registrations option.",
"type": "null"
}
],
"description": "Value for target registrations."
},
"title": {
"description": "Value for title.",
"maxLength": 200,
"minLength": 1,
"type": "string"
}
},
"required": [
"seq_num"
],
"type": "object"
},
"name": "update_event",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"events:write"
],
"risk": "write",
"scope": "events:write",
"title": "Update Event"
}