Для AI-агентов: markdown этой страницы — /docs/mcp-marketing.mdиндекс документации — /llms.txt
MCP: marketing
Обновлено
MCP: marketing
Это определения инструментов из текущего ToolRegistry, включая полные inputSchema/outputSchema, scope, required_scopes (ALL), risk и версию платформы. Наличие определения не означает, что инструмент уже установлен вашим хостом или разрешён вашим credential. Обновляйте tools/list после изменения бизнеса, readiness и прав. Progressive disclosure через load_domain/describe_tool и существующий meta-dispatch описаны в MCP-руководстве. Scopes и права применяются при вызове; risk не заменяет согласие и отдельные требования денежной операции. JSON ниже — схема, а не успешный результат вызова.
create_marketing_campaign
Create a campaign atomically with its mandatory first source link. Provide a destination target and first_link; a campaign without a source does not exist. A source is either link or code_word; pass code_word only for the latter. The platform owns public addressing. Returns the campaign and its tenant-local seqNum values.
{
"description": "Create a campaign atomically with its mandatory first source link. Provide a destination `target` and `first_link`; a campaign without a source does not exist. A source is either `link` or `code_word`; pass `code_word` only for the latter. The platform owns public addressing. Returns the campaign and its tenant-local `seqNum` values.",
"domain": "marketing",
"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"
},
"button_target": {
"description": "Value for button target.",
"oneOf": [
{
"additionalProperties": false,
"description": "Value for button target option.",
"properties": {
"kind": {
"const": "delivery_message",
"description": "Value for kind.",
"type": "string"
}
},
"required": [
"kind"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for button target option.",
"properties": {
"kind": {
"const": "url",
"description": "Value for kind.",
"type": "string"
},
"url": {
"description": "Value for url.",
"format": "uri",
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for button target option.",
"properties": {
"kind": {
"const": "web_app",
"description": "Value for kind.",
"type": "string"
},
"web_app_url": {
"description": "Value for web app url.",
"format": "uri",
"type": "string"
}
},
"required": [
"kind",
"web_app_url"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for button target option.",
"properties": {
"kind": {
"const": "section_root",
"description": "Value for kind.",
"type": "string"
},
"section": {
"description": "Value for section.",
"enum": [
"catalog",
"booking",
"events"
],
"type": "string"
}
},
"required": [
"kind",
"section"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for button target option.",
"properties": {
"entity_seq": {
"description": "Value for entity seq.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"entity_type": {
"description": "Value for entity type.",
"enum": [
"product",
"catalog_group",
"menu_group",
"event",
"resource",
"chain_step",
"marketing_campaign",
"marketing_link",
"form"
],
"type": "string"
},
"kind": {
"const": "deeplink",
"description": "Value for kind.",
"type": "string"
}
},
"required": [
"kind",
"entity_type",
"entity_seq"
],
"type": "object"
}
]
},
"button_title": {
"description": "Value for button title.",
"maxLength": 100,
"type": "string"
},
"display_name": {
"description": "Value for display name.",
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"first_link": {
"additionalProperties": false,
"description": "Value for first link.",
"properties": {
"code_word": {
"description": "Value for code word.",
"maxLength": 100,
"minLength": 4,
"pattern": "^\\S+$",
"type": "string"
},
"comment": {
"anyOf": [
{
"description": "Value for comment option.",
"maxLength": 255,
"type": "string"
},
{
"description": "Value for comment option.",
"type": "null"
}
],
"description": "Value for comment."
},
"is_active": {
"description": "Value for is active.",
"type": "boolean"
},
"kind": {
"description": "Value for kind.",
"enum": [
"link",
"code_word"
],
"type": "string"
},
"title": {
"description": "Value for title.",
"maxLength": 64,
"minLength": 1,
"type": "string"
}
},
"required": [
"kind",
"title"
],
"type": "object"
},
"is_active": {
"description": "Value for is active.",
"type": "boolean"
},
"target": {
"description": "Value for target.",
"oneOf": [
{
"additionalProperties": false,
"description": "Value for target option.",
"properties": {
"kind": {
"const": "delivery_message",
"description": "Value for kind.",
"type": "string"
}
},
"required": [
"kind"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for target option.",
"properties": {
"kind": {
"const": "url",
"description": "Value for kind.",
"type": "string"
},
"url": {
"description": "Value for url.",
"format": "uri",
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for target option.",
"properties": {
"kind": {
"const": "web_app",
"description": "Value for kind.",
"type": "string"
},
"web_app_url": {
"description": "Value for web app url.",
"format": "uri",
"type": "string"
}
},
"required": [
"kind",
"web_app_url"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for target option.",
"properties": {
"kind": {
"const": "section_root",
"description": "Value for kind.",
"type": "string"
},
"section": {
"description": "Value for section.",
"enum": [
"catalog",
"booking",
"events"
],
"type": "string"
}
},
"required": [
"kind",
"section"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for target option.",
"properties": {
"entity_seq": {
"description": "Value for entity seq.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"entity_type": {
"description": "Value for entity type.",
"enum": [
"product",
"catalog_group",
"menu_group",
"event",
"resource",
"chain_step",
"marketing_campaign",
"marketing_link",
"form"
],
"type": "string"
},
"kind": {
"const": "deeplink",
"description": "Value for kind.",
"type": "string"
}
},
"required": [
"kind",
"entity_type",
"entity_seq"
],
"type": "object"
}
]
}
},
"required": [
"display_name",
"target",
"first_link"
],
"type": "object"
},
"name": "create_marketing_campaign",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"marketing:write"
],
"risk": "write",
"scope": "marketing:write",
"title": "Create Marketing Campaign"
}create_marketing_link
Create a source link under a campaign addressed by campaign_seq_num. Use kind:"link" for a normal source or kind:"code_word" with code_word for text matching. The link receives its own tenant-local seqNum; raw ids and public registry codes are never accepted.
{
"description": "Create a source link under a campaign addressed by `campaign_seq_num`. Use `kind:\"link\"` for a normal source or `kind:\"code_word\"` with `code_word` for text matching. The link receives its own tenant-local `seqNum`; raw ids and public registry codes are never accepted.",
"domain": "marketing",
"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"
},
"campaign_seq_num": {
"description": "Value for campaign seq num.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"code_word": {
"description": "Value for code word.",
"maxLength": 100,
"minLength": 4,
"pattern": "^\\S+$",
"type": "string"
},
"comment": {
"anyOf": [
{
"description": "Value for comment option.",
"maxLength": 255,
"type": "string"
},
{
"description": "Value for comment option.",
"type": "null"
}
],
"description": "Value for comment."
},
"is_active": {
"description": "Value for is active.",
"type": "boolean"
},
"kind": {
"description": "Value for kind.",
"enum": [
"link",
"code_word"
],
"type": "string"
},
"title": {
"description": "Value for title.",
"maxLength": 64,
"minLength": 1,
"type": "string"
}
},
"required": [
"campaign_seq_num",
"kind",
"title"
],
"type": "object"
},
"name": "create_marketing_link",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"marketing:write"
],
"risk": "write",
"scope": "marketing:write",
"title": "Create Marketing Link"
}delete_marketing_campaign
Soft-delete a marketing campaign by its tenant-local seqNum. Idempotent: deleting an absent or already-deleted campaign returns deleted:true.
{
"description": "Soft-delete a marketing campaign by its tenant-local `seqNum`. Idempotent: deleting an absent or already-deleted campaign returns deleted:true.",
"domain": "marketing",
"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_marketing_campaign",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"marketing:write"
],
"risk": "destructive",
"scope": "marketing:write",
"title": "Delete Marketing Campaign"
}delete_marketing_link
Disable a marketing source link by its tenant-local seqNum, preserving attribution history. A missing or foreign seqNum is NOT_FOUND. Repeating deletion of an existing already-inactive link is idempotent and returns deleted:true.
{
"description": "Disable a marketing source link by its tenant-local `seqNum`, preserving attribution history. A missing or foreign seqNum is NOT_FOUND. Repeating deletion of an existing already-inactive link is idempotent and returns deleted:true.",
"domain": "marketing",
"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_marketing_link",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"marketing:write"
],
"risk": "destructive",
"scope": "marketing:write",
"title": "Delete Marketing Link"
}list_marketing_campaigns
List the tenant marketing campaigns with CRM-visible statistics: clicks, users, orders, payments, and the latest statistics refresh. A campaign is a destination/aggregate and includes its source links; it has no type or public address. Each source has its tenant-local seqNum, the only id accepted by source-link mutations. 0-cost read.
{
"description": "List the tenant marketing campaigns with CRM-visible statistics: clicks, users, orders, payments, and the latest statistics refresh. A campaign is a destination/aggregate and includes its source links; it has no type or public address. Each source has its tenant-local `seqNum`, the only id accepted by source-link mutations. 0-cost read.",
"domain": "marketing",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "list_marketing_campaigns",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"marketing:read"
],
"risk": "read",
"scope": "marketing:read",
"title": "List Marketing Campaigns"
}list_marketing_links
List all tenant marketing source links for batch operations. Each row includes its tenant-local seqNum and a signed QR PNG URL. QR URLs expire after 900 seconds (15 minutes); download a large batch promptly and request a fresh list after expiry. 0-cost read.
{
"description": "List all tenant marketing source links for batch operations. Each row includes its tenant-local `seqNum` and a signed QR PNG URL. QR URLs expire after 900 seconds (15 minutes); download a large batch promptly and request a fresh list after expiry. 0-cost read.",
"domain": "marketing",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "list_marketing_links",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"marketing:read"
],
"risk": "read",
"scope": "marketing:read",
"title": "List Marketing Links"
}update_marketing_campaign
Update a campaign by its tenant-local seqNum. Patch its display name, destination target, delivery button, or active flag. Source kind/code words belong to links and cannot be edited through a campaign. A foreign or missing seqNum is NOT_FOUND.
{
"description": "Update a campaign by its tenant-local `seqNum`. Patch its display name, destination target, delivery button, or active flag. Source kind/code words belong to links and cannot be edited through a campaign. A foreign or missing seqNum is NOT_FOUND.",
"domain": "marketing",
"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"
},
"button_target": {
"anyOf": [
{
"description": "Value for button target option.",
"oneOf": [
{
"additionalProperties": false,
"description": "Value for button target option option.",
"properties": {
"kind": {
"const": "delivery_message",
"description": "Value for kind.",
"type": "string"
}
},
"required": [
"kind"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for button target option option.",
"properties": {
"kind": {
"const": "url",
"description": "Value for kind.",
"type": "string"
},
"url": {
"description": "Value for url.",
"format": "uri",
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for button target option option.",
"properties": {
"kind": {
"const": "web_app",
"description": "Value for kind.",
"type": "string"
},
"web_app_url": {
"description": "Value for web app url.",
"format": "uri",
"type": "string"
}
},
"required": [
"kind",
"web_app_url"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for button target option option.",
"properties": {
"kind": {
"const": "section_root",
"description": "Value for kind.",
"type": "string"
},
"section": {
"description": "Value for section.",
"enum": [
"catalog",
"booking",
"events"
],
"type": "string"
}
},
"required": [
"kind",
"section"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for button target option option.",
"properties": {
"entity_seq": {
"description": "Value for entity seq.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"entity_type": {
"description": "Value for entity type.",
"enum": [
"product",
"catalog_group",
"menu_group",
"event",
"resource",
"chain_step",
"marketing_campaign",
"marketing_link",
"form"
],
"type": "string"
},
"kind": {
"const": "deeplink",
"description": "Value for kind.",
"type": "string"
}
},
"required": [
"kind",
"entity_type",
"entity_seq"
],
"type": "object"
}
]
},
{
"description": "Value for button target option.",
"type": "null"
}
],
"description": "Value for button target."
},
"button_title": {
"anyOf": [
{
"description": "Value for button title option.",
"maxLength": 100,
"type": "string"
},
{
"description": "Value for button title option.",
"type": "null"
}
],
"description": "Value for button title."
},
"display_name": {
"description": "Value for display name.",
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"is_active": {
"description": "Value for is active.",
"type": "boolean"
},
"seq_num": {
"description": "Value for seq num.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"target": {
"description": "Value for target.",
"oneOf": [
{
"additionalProperties": false,
"description": "Value for target option.",
"properties": {
"kind": {
"const": "delivery_message",
"description": "Value for kind.",
"type": "string"
}
},
"required": [
"kind"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for target option.",
"properties": {
"kind": {
"const": "url",
"description": "Value for kind.",
"type": "string"
},
"url": {
"description": "Value for url.",
"format": "uri",
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for target option.",
"properties": {
"kind": {
"const": "web_app",
"description": "Value for kind.",
"type": "string"
},
"web_app_url": {
"description": "Value for web app url.",
"format": "uri",
"type": "string"
}
},
"required": [
"kind",
"web_app_url"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for target option.",
"properties": {
"kind": {
"const": "section_root",
"description": "Value for kind.",
"type": "string"
},
"section": {
"description": "Value for section.",
"enum": [
"catalog",
"booking",
"events"
],
"type": "string"
}
},
"required": [
"kind",
"section"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for target option.",
"properties": {
"entity_seq": {
"description": "Value for entity seq.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"entity_type": {
"description": "Value for entity type.",
"enum": [
"product",
"catalog_group",
"menu_group",
"event",
"resource",
"chain_step",
"marketing_campaign",
"marketing_link",
"form"
],
"type": "string"
},
"kind": {
"const": "deeplink",
"description": "Value for kind.",
"type": "string"
}
},
"required": [
"kind",
"entity_type",
"entity_seq"
],
"type": "object"
}
]
}
},
"required": [
"seq_num"
],
"type": "object"
},
"name": "update_marketing_campaign",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"marketing:write"
],
"risk": "write",
"scope": "marketing:write",
"title": "Update Marketing Campaign"
}update_marketing_link
Update a source link by its tenant-local seqNum. Only title, comment, and active state are mutable; source kind and code word are immutable. A foreign or missing seqNum is NOT_FOUND.
{
"description": "Update a source link by its tenant-local `seqNum`. Only title, comment, and active state are mutable; source kind and code word are immutable. A foreign or missing seqNum is NOT_FOUND.",
"domain": "marketing",
"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"
},
"comment": {
"anyOf": [
{
"description": "Value for comment option.",
"maxLength": 255,
"type": "string"
},
{
"description": "Value for comment option.",
"type": "null"
}
],
"description": "Value for comment."
},
"is_active": {
"description": "Value for is active.",
"type": "boolean"
},
"seq_num": {
"description": "Value for seq num.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"title": {
"description": "Value for title.",
"maxLength": 64,
"minLength": 1,
"type": "string"
}
},
"required": [
"seq_num"
],
"type": "object"
},
"name": "update_marketing_link",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"marketing:write"
],
"risk": "write",
"scope": "marketing:write",
"title": "Update Marketing Link"
}