MCP Tools Reference
Liste exhaustive des 181 tools MCP exposés par Trackily, groupés par module. Pour chacun : nom, description courte, scope(s) requis, tier (1 = auto-execute, 2 = preview + confirm_token requis). Cette page est l'API reference : à imprimer/bookmark pour développer un agent custom.
Table des matières
- autopilot-resources — 12 tools de lecture (campaigns/offers/landings/flows + search)
- autopilot-actions — 17 tools d'écriture core (pause/resume/create/update)
- autopilot-source-actions — 6 tools ad networks (Kadam, Meta, TikTok…)
- autopilot-meta-tools — 6 tools d'orchestration (briefing, anomalies, scale)
- autopilot-content-tools — 11 tools landings (AI, translate, compliance, import)
- autopilot-workflow-tools — 8 tools cloaking workflows (Drawflow DSL)
- autopilot-ecommerce-tools — 10 tools stores + products Shopify
- autopilot-ecommerce-orders-tools — 14 tools orders Shopify
- autopilot-ecommerce-marketing-tools — 17 tools collections/discounts/scripts/webhooks
- autopilot-ecommerce-content-tools — 15 tools pages CMS/blogs/articles/metafields/SEO
- autopilot-ecommerce-analytics-tools — 13 tools analytics + customers + inventory
- autopilot-ecommerce-orchestration-tools — 8 tools briefings + bulk Shopify
- autopilot-native-commerce-tools — 11 tools native products + shipping
- autopilot-native-orders-tools — 7 tools orders natives
- autopilot-email-tools — 26 tools email marketing (lists, sequences, SMTP, triggers)
Légende des colonnes :
- Tool — nom à passer dans
tools/callparams.name - Scopes — requis sur le token (cf. Scopes)
- Tier —
T1= exécuté immédiatement ;T2= preview + confirm_token requis (cf. Tier System)
resources
Le module historique de Trackily — exposait initialement des resources MCP (URIs trackily://...), désormais aussi des tools-équivalents pour les clients qui ne supportent pas les resources.
| Tool | Scopes | Tier | Description |
|---|---|---|---|
get_stats |
stats:read |
T1 | Stats agrégées sur une fenêtre de dates, groupées par day / campaign / offer / source / landing / country / device. |
get_campaign_detail |
campaigns:read |
T1 | Détail complet d'une campagne incluant flows et stats sur une fenêtre. Cf. Campaigns. |
get_offer_detail |
offers:read |
T1 | Détail complet d'une offre incluant stats day-by-day (Trackily + cross-check réseau). |
get_landing_detail |
landings:read |
T1 | Détail complet d'une landing page (type, url, redirect/protection configs). Cf. Landings. |
get_flow_detail |
flows:read |
T1 | Tous les flows (forced / regular / default) d'une campagne avec leur schema et filtres. |
list_clicks |
reports:read |
T1 | Log paginé des clicks. Filtres optionnels : campaign_id, offer_id, from, to. Max 500 lignes. |
list_conversions |
reports:read |
T1 | Log paginé des conversions avec join sur clicks. Filtre status optionnel. |
list_leads |
landings:read |
T1 | Leads captés (email/name/phone). Filtres optionnels : landing_id, campaign_id. |
search_entities |
campaigns:read + offers:read + landings:read + sources:read |
T1 | Search global campaigns / offers / landings / sources par name ou external id. Max 20 par type. |
get_automizer_audit |
automizer:read |
T1 | Exécutions Automizer récentes (quelles règles ont fire, quelles actions, quand). Filtre rule_id optionnel. |
list_automizer_rules |
automizer:read |
T1 | Liste des règles Automizer avec état courant. Équivalent tool de la resource trackily://automizer/rules. |
list_offers |
offers:read |
T1 | Liste des offres Trackily avec filtres bulk. Cas d'usage : bulk-resolve N external_ids Everflow vers leurs IDs Trackily + smart links + payouts en un call. |
actions
Le module core des mutations sur les entités Trackily natives (campagnes, offres, landings, automizer rules).
| Tool | Scopes | Tier | Description |
|---|---|---|---|
pause_campaign |
campaigns:write |
T1 | Pause une campagne (is_active=false). Réversible avec resume_campaign. |
resume_campaign |
campaigns:write |
T1 | Reprise d'une campagne paused. |
pause_offer |
offers:write |
T1 | Pause une offre (status=paused). Les nouvelles campagnes la verront paused dans le dropdown. |
resume_offer |
offers:write |
T1 | Reprise d'une offre paused. |
pause_landing |
landings:write |
T1 | Pause une landing (is_active=false). Les flows actifs la skippent. |
resume_landing |
landings:write |
T1 | Reprise d'une landing paused. |
pause_automizer_rule |
automizer:write |
T1 | Pause une règle Automizer. La loop d'évaluation 60s la skip. |
resume_automizer_rule |
automizer:write |
T1 | Réactive une règle Automizer. |
sync_offer_network_stats |
offers:write |
T1 | Déclenche un sync stats Everflow / réseau affiliate. Sans offer_id : refresh chaque offre active. |
create_campaign |
campaigns:write |
T1 | Crée une nouvelle campagne Trackily. Slug auto-généré si omis. Cf. Campaigns / Create. |
create_flow |
campaigns:write |
T1 | Crée un nouveau flow sur une campagne. Engine évalue : forced → regular → default. Cf. Campaigns / Flows. |
update_offer_payout |
offers:write |
T2 | Update du payout d'une offre. Preview + confirm_token. |
update_campaign_cost |
campaigns:write |
T2 | Update du cost_model et/ou cost_value d'une campagne. Two-step avec confirm_token. |
duplicate_campaign |
campaigns:write |
T2 | Clone une campagne avec un nouveau name + slug. Le clone démarre is_active=false. |
create_automizer_rule |
automizer:write |
T2 | Crée une règle Automizer avec conditions + actions custom. Cf. Automizer / Rules. |
update_automizer_rule |
automizer:write |
T2 | Update partiel d'une règle Automizer. |
delete_automizer_rule |
automizer:write |
T2 | Suppression définitive d'une règle Automizer. |
source-actions
Tools qui appellent les ad networks (Kadam, Meta, TikTok, Taboola, MGID, ExoClick, PropellerAds…). Lecture des réglages externes + pause / budget / bid.
| Tool | Scopes | Tier | Description |
|---|---|---|---|
list_source_campaigns |
sources:read |
T1 | Inspecte une source row : confirme la plateforme détectée, liste les external_campaign_ids enregistrés. |
test_source_connection |
sources:read |
T1 | Vérifie que le helper API d'une source est wired + identifie la plateforme cible. |
pause_source_campaign |
sources:write |
T1 | Pause une campagne directement sur l'ad platform (Kadam / Meta / TikTok / Taboola / MGID / ExoClick / PropellerAds). |
resume_source_campaign |
sources:write |
T2 | Reprise d'une campagne ad-platform paused. |
update_source_campaign_budget |
sources:write |
T2 | Update du daily ou total budget d'une campagne ad-platform. Toujours en USD — le tool convertit. Respecte daily_spend_cap_usd du token. |
update_source_campaign_bid |
sources:write |
T2 | Update du bid / CPC d'une campagne ad-platform (Kadam rate, PropellerAds rate, Taboola cpc…). |
meta-tools
Tools de synthèse et d'orchestration — chaînent plusieurs reads sous le capot pour produire un brief actionnable.
| Tool | Scopes | Tier | Description |
|---|---|---|---|
daily_briefing |
stats:read + campaigns:read |
T1 | Brief matinal one-shot : KPI snapshot today / yesterday / 7-day baseline + top winners et losers. |
detect_creative_fatigue |
stats:read + landings:read |
T1 | Compare la perf de landings sur les N derniers jours vs les N précédents. Identifie le creative à refresh. |
detect_anomalies |
stats:read + campaigns:read |
T1 | Scan des N dernières heures pour 3 classes d'anomalies : bot-rate spikes (≥30%) par source, EPC drops, cost spikes. |
suggest_optimizations |
stats:read + campaigns:read + offers:read + sources:read |
T1 | Analyse compréhensive read-only sur N jours. Identifie under_performers + winners + opportunités de scale. |
rotate_offer_in_flows |
offers:write + flows:write |
T2 | Swap chaque occurrence de old_offer_id avec new_offer_id dans tous les flows. Utile pour migrer rapidement quand un advertiser a changé d'URL. |
cross_platform_scale_plan |
campaigns:read + sources:read |
T1 | Planner read-only : donne un winning campaign + une liste de sources cibles, retourne un plan de scale (budget, bid, géo). |
content-tools
Tools dédiés à la génération + manipulation de landings — surtout via l'AI Landing Builder.
| Tool | Scopes | Tier | Description |
|---|---|---|---|
generate_ai_landing |
ai:generate + landings:write |
T2 | Génère une nouvelle landing AI-authored depuis une description. Uses Trackily AI Landing Builder. |
generate_landing_for_offer |
ai:generate + landings:write + offers:read |
T2 | Wrapper plus haut niveau : lit l'offre, infère le vertical (antivirus, vpn, diet…), génère la landing avec les bons templates. |
generate_landing_variants |
ai:generate + landings:write |
T2 | Crée N variants A/B (1-8) d'une landing AI existante. Génération EN PARALLÈLE. |
get_ai_landing_detail |
landings:read |
T1 | DEPRECATED depuis v38. Équivalent à get_landing_detail désormais. |
translate_landing |
ai:generate + landings:write |
T2 | Traduit une landing AI existante en N langues. Crée une landing draft par langue. |
compliance_check |
landings:read + ai:generate |
T2 | Audit compliance d'une landing par vertical-specific rules. Deux modes : rules (gratuit) ou ai (LLM). |
create_landing |
landings:write |
T1 | Crée une landing_pages row classique — équivalent MCP de la modal "Add Landing Page". Types : url / local / redirect_tracker / ai. |
update_landing |
landings:write |
T1 | Update partiel d'une landing_pages row. |
rerender_landing_from_meta |
landings:write |
T1 | Re-rendre une landing AI-generated depuis le LLM copy + design DNA stocké dans son meta. |
import_landing_from_url |
landings:write |
T1 | Télécharge une page externe et la sauve comme landing Trackily. Deux modes. |
link_landing_to_campaign |
landings:write + campaigns:write + flows:write |
T1 | Bridge une landing AI vers un flow de campagne pour qu'elle reçoive du trafic live. |
workflow-tools
Tools pour les cloaking workflows (Visual Workflow Builder, basé sur Drawflow). Manipulation par DSL pour éviter de toucher au layout HTML interne.
| Tool | Scopes | Tier | Description |
|---|---|---|---|
list_cloaking_workflows |
settings:read |
T1 | Liste les workflows cloaking. Retourne id, name, is_active, dates, count campagnes liées, node count. |
get_cloaking_workflow |
settings:read |
T1 | Fetch un workflow comme DSL (nodes + edges). Cache le Drawflow layout pour raisonner sur la logique. |
list_workflow_node_types |
settings:read |
T1 | Catalog complet des node types (trigger / detect / action / advanced / route / destination) avec inputs/outputs et config par défaut. |
create_cloaking_workflow |
settings:write |
T2 | Crée un workflow depuis un DSL. Call list_workflow_node_types avant pour le catalog. Preview montre node breakdown par kind. |
update_cloaking_workflow |
settings:write |
T2 | Patch un workflow existant. Champs omis = inchangés. Quand nodes/edges fournis, le schema est remplacé atomically. |
delete_cloaking_workflow |
settings:write |
T2 | Soft-delete (deleted_at set). Toute campagne référenceant le workflow voit son cloaking_workflow_id set à NULL — pas de coupure de trafic. |
duplicate_cloaking_workflow |
settings:write |
T1 | Clone un workflow comme INACTIVE draft (l'opérateur édite avant d'activer). |
assign_cloaking_workflow_to_campaign |
settings:write |
T2 | Assigne un workflow à une campagne (campaigns.cloaking_workflow_id). Preview warn si remplacement d'un workflow existant. |
Cf. Cloaking — Workflows.
ecommerce-tools
Tools pour la gestion des stores Shopify et le catalogue produit.
| Tool | Scopes | Tier | Description |
|---|---|---|---|
list_stores |
stores:read |
T1 | Liste les stores e-commerce connectés (Shopify, WooCommerce, Stripe…) avec platform, health, stats. |
get_store_detail |
stores:read |
T1 | Détail d'un store (domain, platform, currency, sync status, stats). |
test_store_connection |
stores:read |
T1 | Ping le platform pour valider les credentials du store. Shopify-only en Phase 1. |
list_products |
products:read |
T1 | Liste les produits mirrored depuis les stores connectés vers le catalogue local Trackily. |
sync_products_from_shopify |
products:write |
T1 | Pull depuis Shopify + upsert dans la table products de Trackily (idempotent via external_id). |
create_product |
products:write |
T2 | Crée un produit sur la plateforme distante ET mirror dans Trackily. |
update_product |
products:write |
T2 | Update partiel d'un produit sur la plateforme distante (Shopify en Phase 2). |
delete_product |
products:write |
T2 | Suppression définitive d'un produit côté plateforme distante ET du mirror Trackily. |
clone_product_from_url |
products:write |
T2 | Clone un produit Shopify depuis une URL publique vers un target store en un step. |
upload_product_image |
products:write |
T1 | Attache une image à un produit existant par URL. Shopify la télécharge async. |
ecommerce-orders-tools
Tools pour la gestion des commandes Shopify + variants produit.
| Tool | Scopes | Tier | Description |
|---|---|---|---|
list_orders |
orders:read |
T1 | Liste les orders Shopify avec filtres (status, financial_status, fulfillment_status, dates, customer_id). |
get_order_detail |
orders:read |
T1 | Détail complet d'une order Shopify : line items, shipping/billing, fulfillments, refunds, transactions. |
search_orders |
orders:read |
T1 | Search par order number / name prefix (ex: "1001" ou "#1001"). Utilise le filter name Shopify REST. |
update_order_tags |
orders:write |
T1 | Replace les tags sur une order Shopify. Réversible — tags sont cosmétiques. |
add_order_note |
orders:write |
T1 | Set la note interne sur une order (remplace l'existante). Notes sont merchant-only. |
cancel_order |
orders:write |
T2 | Cancel une order Shopify. IRRÉVERSIBLE. Reason : customer/fraud/inventory/declined/other. |
refund_order |
orders:write |
T2 | Issue un refund sur une order Shopify. IRRÉVERSIBLE. |
fulfill_order |
orders:write |
T2 | Crée un fulfillment pour une order Shopify (endpoint legacy). |
mark_order_as_paid |
orders:write |
T2 | Mark une order comme paid en créant une transaction "external sale" successful. |
list_abandoned_checkouts |
checkouts:read |
T1 | Liste les abandoned checkouts (carts arrivés au checkout sans convertir). Chaque entry inclut le recovery URL. |
get_checkout_recovery_link |
checkouts:read |
T1 | Recovery URL pour un abandoned checkout spécifique. |
add_product_variant |
products:write |
T2 | Add un variant à un produit Shopify existant. option1/option2/option3 selon le schema d'options du produit. |
update_product_variant |
products:write |
T2 | Update un variant Shopify. Partial — seuls les champs dans patch changent. |
delete_product_variant |
products:write |
T2 | Suppression définitive d'un variant Shopify. IRRÉVERSIBLE. |
ecommerce-marketing-tools
Tools pour les collections, codes promo, script tags, webhooks Shopify.
| Tool | Scopes | Tier | Description |
|---|---|---|---|
list_collections |
collections:read |
T1 | Liste les custom collections Shopify. Filtre par product_id (collections contenant ce produit) ou title substring. |
get_collection_detail |
collections:read |
T1 | Détail d'une collection (title, body_html, handle, sort_order, image, SEO, admin_url). |
create_collection |
collections:write |
T2 | Crée une custom (manually-managed) collection. Optional : body_html, image_src, sort_order. |
update_collection |
collections:write |
T2 | Update partiel d'une custom collection. |
delete_collection |
collections:write |
T2 | Suppression d'une custom collection. IRRÉVERSIBLE. Les produits ne sont PAS supprimés, juste le grouping. |
add_product_to_collection |
collections:write |
T1 | Add un produit à une custom collection (crée une collect row). Optional : position pour sort manuel. |
remove_product_from_collection |
collections:write |
T1 | Remove un produit d'une collection. Pass EITHER collect_id, OR (product_id + collection_id) — auto-resolve. |
list_discount_codes |
discounts:read |
T1 | Liste toutes les price rules + leurs discount codes. Chaque rule inclut codes + usage counts. |
create_discount_code |
discounts:write |
T2 | Crée un discount code en un call (price rule + code together). |
delete_discount_code |
discounts:write |
T2 | Delete un discount code. Default : delete la price rule entière. Set delete_whole_rule=false + discount_code_id pour delete un seul code. |
create_price_rule |
discounts:write |
T2 | Crée une price rule standalone (automatic discount sans code). Plus flexible que create_discount_code. |
list_script_tags |
marketing:read |
T1 | Liste les script tags injected sur le storefront. Chaque entry : src, event, display_scope. |
create_script_tag |
marketing:write |
T2 | Inject un JS file sur le storefront. display_scope : online_store / order_status / all. |
delete_script_tag |
marketing:write |
T1 | Remove un script tag. Réversible — tu peux toujours le re-créer. |
list_webhooks |
marketing:read |
T1 | Liste les webhooks Shopify registered. Filtre par topic (orders/create) ou address. |
create_webhook |
marketing:write |
T2 | Subscribe à un Shopify event. Topics communs : orders/create, orders/paid, orders/cancelled, checkouts/create, products/update, customers/create. |
delete_webhook |
marketing:write |
T1 | Unsubscribe un webhook. Réversible. |
ecommerce-content-tools
Tools pour les pages CMS, blogs, articles, metafields, SEO Shopify.
| Tool | Scopes | Tier | Description |
|---|---|---|---|
list_pages |
content:read |
T1 | Liste les pages CMS Shopify (About, Contact, Policies, custom). Filtre title/handle/published_status. |
create_page |
content:write |
T2 | Crée une page CMS. Pairs nicely avec un LLM call pour générer body_html. |
update_page |
content:write |
T2 | Update partiel d'une page CMS. |
delete_page |
content:write |
T2 | Delete une page CMS. IRRÉVERSIBLE. |
list_blogs |
content:read |
T1 | Liste les blogs du store. Most stores have 1 blog ("News"). Pass le blog id à list_articles. |
list_articles |
content:read |
T1 | Liste les articles dans un blog. Filtre par tag ou published_status. |
create_article |
content:write |
T2 | Crée un article. Combine avec un LLM call pour author du SEO content à scale. |
update_article |
content:write |
T2 | Update partiel d'un article. |
delete_article |
content:write |
T2 | Delete un article. IRRÉVERSIBLE. |
list_product_metafields |
products:read |
T1 | Liste les custom metafields sur un produit. Pairs key-value scopées par namespace. |
set_product_metafield |
products:write |
T1 | Create ou update un metafield. type defaults single_line_text_field. |
delete_product_metafield |
products:write |
T1 | Remove un metafield d'un produit. |
generate_product_description_ai |
products:write + ai:generate |
T1 | Use LLM (provider configured dans Settings → AI Landing Builder) pour écrire une description fresh. 8 frameworks : AIDA / PAS / BAB / 4Ps / PASTOR / StoryBrand / QUEST / FAB. |
translate_product |
products:write + ai:generate |
T1 | Traduit title + body_html + tags vers une autre langue via LLM. auto_apply=true pour push direct dans le produit Shopify. |
seo_audit_product |
products:read |
T1 | Audit SEO : title length, description length, handle quality, alt-text coverage, tags, SEO metafields. Retourne score + issues + suggestions. Pure rules, pas de LLM call. |
ecommerce-analytics-tools
Tools pour l'analytics e-commerce, customers, inventory Shopify.
| Tool | Scopes | Tier | Description |
|---|---|---|---|
get_shop_summary_stats |
analytics:read |
T1 | KPIs d'un store Shopify sur une date window : orders count, revenue, AOV, cancelled/refunded counts. |
get_best_selling_products |
analytics:read |
T1 | Top N produits par quantity sold ou revenue dans la window. |
get_revenue_by_period |
analytics:read |
T1 | Revenue + orders count bucketed par day / week / month. |
get_conversion_metrics |
analytics:read |
T1 | Rough funnel : completed orders vs abandoned checkouts dans la window + completion rate. |
list_customers |
customers:read |
T1 | Liste clients avec filtres date optionnels. Compact summary par client. |
get_customer_detail |
customers:read |
T1 | Détail complet d'un client : profile, addresses, recent orders (jusqu'à 20), admin URL. |
search_customers |
customers:read |
T1 | Search clients via Shopify query syntax. Examples : email:foo@bar.com, tag:vip. |
list_customer_orders |
customers:read + orders:read |
T1 | Liste orders pour un seul client. Utile pour LTV analysis, support context, repeat-purchase. |
create_customer |
customers:write |
T2 | Crée un nouveau client Shopify. Email ou phone requis. |
update_customer |
customers:write |
T2 | Update partiel d'un client. Seuls les champs dans patch changent. |
list_locations |
inventory:read |
T1 | Liste toutes les locations physiques/virtuelles du store. |
list_inventory_levels |
inventory:read |
T1 | Liste inventory levels par (inventory_item_id, location_id). Au moins l'un des deux requis côté Shopify. |
set_inventory_level |
inventory:write |
T1 | Set la stock quantity absolue d'un inventory item à une location. Tier-1 safe — inventory toujours rétablissable. |
ecommerce-orchestration-tools
Tools pour les briefings groupés + opérations bulk Shopify.
| Tool | Scopes | Tier | Description |
|---|---|---|---|
daily_shopify_briefing |
analytics:read + orders:read + checkouts:read |
T1 | Routine one-shot : revenue + orders today vs yesterday, last-7d best sellers, abandoned checkouts, funnel, suggested actions. |
detect_stock_alerts |
products:read + inventory:read |
T1 | Scan products actifs + flag variants avec inventory ≤ threshold. Sorted lowest first. Groups : out_of_stock / critical / low. |
detect_sluggish_products |
products:read + analytics:read |
T1 | Trouve les produits actifs avec 0 sales sur les N derniers jours. Utile pour seasonal cleanup + discount targeting. |
weekly_performance_report |
analytics:read + orders:read |
T1 | This-week vs last-week KPIs (orders, revenue, AOV, new customers) avec WoW deltas + 28-day daily revenue series + top 10 revenue products. |
get_shop_info |
stores:read |
T1 | Shop metadata : name, email, domain, plan, currency, timezone, country, owner. Fetches /shop.json. |
check_shop_health |
products:read |
T1 | Audit catalog quality : produits sans images, descriptions short/missing, variants sans SKU, zero-inventory, missing alt text, titles trop longs. Retourne health score + grade + issues. |
auto_fulfill_ready_orders |
orders:write |
T2 | Bulk-fulfill chaque order paid-but-unfulfilled des N derniers jours. IRRÉVERSIBLE — chaque order reçoit une fulfillment row. |
bulk_update_product_prices |
products:write |
T2 | Change prices sur multiple produits en un call. IRRÉVERSIBLE. operation : set / multiply_pct / add_amount. |
native-commerce-tools
Tools pour les produits natifs Trackily (storefront hosted Trackily, pas Shopify) + shipping zones.
| Tool | Scopes | Tier | Description |
|---|---|---|---|
list_native_products |
products:read |
T1 | Liste produits du native commerce catalog (storefront Trackily-hosted). |
get_native_product_detail |
products:read |
T1 | Fetch un native product avec full options + variants matrix. |
generate_landing_for_product |
ai:generate + landings:write + products:read |
T2 | Génère une landing AI tied à un native_products row. |
list_shipping_zones |
settings:read |
T1 | Liste toutes les shipping zones avec leurs rates. |
get_shipping_zone |
settings:read |
T1 | Fetch une seule shipping zone avec toutes ses rates. |
create_shipping_zone |
settings:read + settings:write |
T2 | Crée une shipping zone avec rates inline optionnels. |
update_shipping_zone |
settings:read + settings:write |
T2 | Update name / countries / status / position d'une zone. |
delete_shipping_zone |
settings:read + settings:write |
T2 | Delete une shipping zone (cascade ses rates). Preview reporte rate count. |
create_shipping_rate |
settings:read + settings:write |
T2 | Add une rate à une zone existante. |
update_shipping_rate |
settings:read + settings:write |
T2 | Update une rate. |
delete_shipping_rate |
settings:read + settings:write |
T2 | Delete une rate. |
native-orders-tools
Tools pour les orders natives Trackily (commerce hosted Trackily).
| Tool | Scopes | Tier | Description |
|---|---|---|---|
list_native_orders |
orders:read |
T1 | Liste orders du native commerce (storefront Trackily-hosted). |
get_native_order_detail |
orders:read |
T1 | Fetch une order native avec line items, customer info, paiements, fulfillments. |
get_native_product_stats |
reports:read + products:read |
T1 | Performance bundle pour un native product : KPI summary, conversions, revenue, AOV, top SKUs. |
mark_native_order_paid |
orders:write |
T2 | Mark une order native comme paid. Utilisé pour COD orders une fois le cash reçu. |
fulfill_native_order |
orders:write |
T2 | Update fulfillment status d'une order native, optionnellement avec tracking. |
cancel_native_order |
orders:write |
T2 | Cancel une order native. Restocke le variant inventory. |
refund_native_order |
orders:write |
T2 | Trigger refund Stripe ou PayPal sur une order native paid. |
Exemple list_native_orders :
// Request
{
"name": "list_native_orders",
"arguments": { "limit": 10, "payment_status": "paid" }
}
// Response (excerpt)
{
"status": "ok",
"orders": [
{
"id": 12,
"order_number": "TR-000012",
"total": "403.00",
"currency": "EUR",
"payment_status": "paid",
"fulfillment_status": "fulfilled",
"customer_email": "marie@example.com",
"created_at": "2026-05-18T14:22:11.421Z"
}
]
}
email-tools
Tools pour l'email marketing (lists, sequences, SMTP, subscribers, suppression, conversion triggers). Cf. la section Email pour les concepts détaillés.
Reads
| Tool | Scopes | Tier | Description |
|---|---|---|---|
list_email_smtp_servers |
email:read |
T1 | Liste chaque SMTP relay configured (Gmail, SendGrid, Postmark, SES, Mailgun) avec quotas + send counts. Passwords JAMAIS retournés. Cf. SMTP. |
list_email_lists |
email:read |
T1 | Liste chaque email list avec subscriber counts, opt-in mode, tracking flags, count landings bound. Cf. Lists. |
get_email_list_detail |
email:read |
T1 | Picture complète d'une liste : settings + histo subscriber statuses + 10 plus récents subscribers + sequences attachées + landings bound. À utiliser avant ops bulk. |
list_email_sequences |
email:read |
T1 | Liste autoresponder sequences. Filtre optionnel list_id. Retourne step counts (spot empty/incomplete sequences). Cf. Sequences. |
get_email_sequence_detail |
email:read |
T1 | Inspect une sequence : settings + chaque step (position, delays, subject, 200-char body preview, active flag). |
list_email_subscribers |
email:read |
T1 | Liste subscribers d'une liste. Filtre par status (subscribed, pending_confirm, unsubscribed, complained) + substring email. Cap 500 rows. |
get_email_subscriber_timeline |
email:read |
T1 | Audit + engagement intel par subscriber : timeline events (opens/clicks/unsubs/bounces), real-vs-prefetch counters, hour-of-day histo opens, learned preferred_send_hour pour STO. |
list_email_sends |
email:read |
T1 | Tail l'audit log des sends. Filtre par list_id, status (queued/sending/sent/failed/bounced), ou email substring. |
get_email_metrics |
email:read |
T1 | KPIs agrégés sur les N derniers jours : sent/failed/bounced/queued counts + open rate, click rate, bounce rate. Scope optionnel par liste. |
list_email_suppression |
email:read |
T1 | Liste les emails globalement suppressed (cross-list). Cf. Suppression. |
list_email_conversion_triggers |
email:read |
T1 | Liste les triggers postback→email actifs. Filtres list_id et offer_id. Cf. Automations. |
Writes
| Tool | Scopes | Tier | Description |
|---|---|---|---|
create_email_smtp_server |
email:write + settings:write |
T2 | Add nouveau SMTP relay. Password chiffré AES-256-GCM (SECRETS_MASTER_KEY). Tier-2 — credentials sensibles. |
create_email_list |
email:write |
T1 | Crée une email list. smtp_server_id optionnel — tu peux collect subscribers puis attacher un SMTP plus tard. |
update_email_list |
email:write |
T1 | Patch settings d'une liste (subset de fields). |
delete_email_list |
email:write |
T2 | Soft-delete d'une liste. Preview avec subscriber count + bound landings. |
create_email_sequence |
email:write |
T1 | Crée une sequence autoresponder sur une liste. La PREMIÈRE sequence créée devient automatiquement default_sequence. |
add_email_sequence_step |
email:write |
T1 | Append (ou insert) un step. delay_days/hours/minutes depuis enrollment time. Variables : {{first_name}}, {{name}}, {{email}}, {{country}}, {{custom.X}}, {{unsubscribe_url}}, {{list_name}}. |
update_email_sequence_step |
email:write |
T1 | Patch un step de sequence. |
enroll_email_subscriber |
email:write |
T1 | Enroll un email dans une liste + démarre la sequence (sauf skip_double_optin ou list.double_opt_in=false). Idempotent. Emails suppressed silently skipped. |
unsubscribe_email_subscriber |
email:write |
T1 | Unsubscribe manuel d'une liste. N'ajoute PAS à la suppression globale — utilise add_to_email_suppression. |
add_to_email_suppression |
email:write |
T1 | Add un email à la suppression GLOBALE (cross-list). |
bind_landing_to_email_list |
email:write + landings:write |
T1 | Bind (ou unbind) une landing à une liste. list_id=null pour unbind. |
send_test_email |
email:write |
T1 | Envoie UN email test sync (bypass queue). Variables rendues contre un subscriber synthetic. Tracking + footer NON injectés. |
create_email_conversion_trigger |
email:write |
T1 | Crée un trigger postback→email. Quand /postback fire pour offer_id (ou any si null), le buyer est auto-enrolled dans target_list_id. |
update_email_conversion_trigger |
email:write |
T1 | Patch un trigger (subset de fields). |
delete_email_conversion_trigger |
email:write |
T1 | Soft-delete d'un trigger. Future postbacks n'enrollent plus via ce trigger ; past enrollments préservés. |
Exemple enroll_email_subscriber :
// Request
{
"name": "enroll_email_subscriber",
"arguments": {
"list_id": 7,
"email": "marie@example.com",
"name": "Marie Dupont",
"custom_fields": { "city": "Paris", "age_range": "25-34" },
"source": "manual:admin"
}
}
// Response
{
"status": "ok",
"subscriber": {
"id": 421,
"list_id": 7,
"email": "marie@example.com",
"name": "Marie Dupont",
"status": "subscribed",
"custom_fields": { "city": "Paris", "age_range": "25-34" },
"enrolled_at": "2026-05-18T14:22:11.421Z"
},
"sequence_triggered": true,
"sequence_id": 12
}
Total : 181 tools
Pour rappel :
| Module | Count |
|---|---|
| resources | 12 |
| actions | 17 |
| source-actions | 6 |
| meta-tools | 6 |
| content-tools | 11 |
| workflow-tools | 8 |
| ecommerce-tools | 10 |
| ecommerce-orders-tools | 14 |
| ecommerce-marketing-tools | 17 |
| ecommerce-content-tools | 15 |
| ecommerce-analytics-tools | 13 |
| ecommerce-orchestration-tools | 8 |
| native-commerce-tools | 11 |
| native-orders-tools | 7 |
| email-tools | 26 |
| Total | 181 |
Voir aussi
- Index — overview du système MCP
- Concept — le protocole JSON-RPC
- Tokens — créer le bearer
- Scopes — granularité des permissions
- Tier System — preview + confirm_token