Для AI-агентов: markdown этой страницы — /docs/mcp-marketing.mdиндекс документации — /llms.txt
MCP: marketing
Обновлено
Определения инструментов. Обновляйте tools/list после изменения прав. required_scopes: ALL.
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.
Scopes (ALL): ["marketing:write"]. Risk: "write".
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.
Scopes (ALL): ["marketing:write"]. Risk: "write".
delete_marketing_campaign
Soft-delete a marketing campaign by its tenant-local `seqNum`. Idempotent: deleting an absent or already-deleted campaign returns deleted:true.
Scopes (ALL): ["marketing:write"]. Risk: "destructive".
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.
Scopes (ALL): ["marketing:write"]. Risk: "destructive".
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.
Scopes (ALL): ["marketing:read"]. Risk: "read".
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.
Scopes (ALL): ["marketing:read"]. Risk: "read".
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.
Scopes (ALL): ["marketing:write"]. Risk: "write".
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.
Scopes (ALL): ["marketing:write"]. Risk: "write".