API et MCP
Référence des outils MCP
Tous les outils exposés par le serveur MCP de Nudge, regroupés par domaine, avec leurs arguments et la permission contrôlée.
Comment lire cette référence
Le serveur MCP de Nudge expose 224 outils, un par action de l'application Nudge. Ils sont générés à partir de l'application elle-même et la suivent : quand un écran gagne une action, l'outil correspondant apparaît.
Chaque outil prend :
orgSlug: le slug de l'espace (https://app.asknudge.ai/w/{orgSlug}). Tous les outils l'exigent, saufinvitations__accept_invitation,onboarding__create_workspace_with_localeet les outilsworkspaces__*.args: les autres arguments, dans l'ordre indiqué dans la colonneargs. Un argument écrit{ … } = {}est un seul objet avec ces clés ;= …donne la valeur par défaut.
La colonne Permission indique la clé de permission que l'outil contrôle, quand il en contrôle une en particulier. Un tiret signifie que l'outil n'a pas de clé de permission dédiée ; il ne fonctionne néanmoins que sur les espaces dont vous êtes membre et ne renvoie que ce que votre rôle peut voir. Les actions réservées aux administrateurs (équipe, rôles, certains réglages) sont aussi limitées par rôle.
Les clés de permission sont celles de l'éditeur de rôles de Nudge : bookings.cancel, contacts.manage, forms.manage, settings.manage, api.manage, etc.
Voir Serveur MCP pour connecter un client et pour les conventions d'appel.
Agents
| Outil | Rôle | args | Permission |
|---|---|---|---|
agents__get_agents_board | Vue d'ensemble des agents : statut, activité récente et suggestions. | options | — |
agents__get_agent_activity | Fil d'activité d'un agent. | agent, options | — |
agents__get_website_setup | État de configuration de l'agent site web (widget, formulaires, installation). | — | — |
agents__check_widget_install | Vérifie que le script du widget est bien présent sur votre site. | options = {} | — |
agents__get_outreach_list | Liste de cibles de l'agent de prospection. | — | — |
agents__import_outreach_targets | Importe des cibles dans la liste de prospection. | payload | — |
agents__get_handoff_setup | État de configuration de l'agent de passage de relais. | — | — |
agents__hubspot_lists | Liste vos listes HubSpot importables. | — | — |
agents__import_from_hubspot_list | Importe des contacts depuis une liste HubSpot. | listId, options | — |
agents__set_agent_status | Active ou désactive un agent. | agent, status | — |
agents__set_agent_autonomy | Règle le niveau d'autonomie d'un agent. | agent, autonomy | — |
agents__snooze_agent_suggestion | Reporte la suggestion en cours d'un agent. | agent | — |
agents__update_agent_settings | Modifie les réglages d'un agent. | agent, patch | — |
agents__get_shared_memory | Lit la mémoire partagée par les agents. | — | — |
agents__update_shared_memory | Modifie la mémoire partagée. | patch | — |
agents__reset_shared_memory | Réinitialise la mémoire partagée. | — | — |
Demander à Nudge
| Outil | Rôle | args | Permission |
|---|---|---|---|
ask__ask | Pose une question à Demander à Nudge sur vos données. | { question, scope, period, intent = null } = {} | — |
ask__list_ask_threads | Liste vos fils Demander à Nudge. | options | — |
ask__delete_ask_thread | Supprime un fil Demander à Nudge. | id | — |
Contacts et notes
| Outil | Rôle | args | Permission |
|---|---|---|---|
collection__list_collection | Coordonnées collectées par l'agent. | options | — |
collection__collection_forms | Formulaires qui collectent des coordonnées. | — | — |
collection__collection_metrics | Indicateurs de collecte. | options | — |
contact_ops__list_duplicates | Contacts probablement en double. | — | — |
contact_ops__merge_contacts | Fusionne des doublons dans un contact principal. | primaryId, duplicateIds | — |
contact_ops__bulk_update_contacts | Modifie plusieurs contacts à la fois. | ids, updates | — |
contact_ops__bulk_delete_contacts | Supprime plusieurs contacts à la fois. | ids | — |
contacts__list_contacts | Liste les contacts avec filtres. | options | — |
contacts__create_contact | Crée un contact. | payload | contacts.manage |
contacts__get_contact | Lit un contact. | shortId | — |
contacts__update_contact | Modifie un contact. | id, updates | contacts.manage |
contacts__delete_contact | Supprime un contact. | id | contacts.manage |
contacts__erase_contact | Efface un contact et ses données personnelles (RGPD). | id | contacts.manage |
contacts__export_contact_data | Exporte les données d'un contact (droit d'accès RGPD). | id | contacts.export |
contacts__export_contacts | Exporte les contacts. | options | contacts.export |
contacts__find_contacts_by_email | Recherche des contacts par e-mail. | email | — |
contacts__list_pipeline_contacts | Contacts de la vue pipeline. | options | — |
contacts__get_contact_board | Tableau des contacts (colonnes par étape). | options | — |
contacts__contact_agent_options | Agents auxquels un contact peut être confié. | shortId | contacts.view |
contacts__assign_contact_to_agent | Confie un contact à un agent. | shortId, agent | — |
contacts__ask_contact | Pose une question à Nudge sur un contact. | shortId, payload = {} | — |
notes__list_notes | Notes d'un contact. | contactId | — |
notes__create_note | Ajoute une note. | { contactId, content, bookingId } = {} | — |
notes__delete_note | Supprime une note. | noteId | — |
notes__list_contact_activity | Activité d'un contact. | contactId | — |
Leads à valider et relances
| Outil | Rôle | args | Permission |
|---|---|---|---|
lead_scoring__get_form_scoring | Règles de scoring d'un formulaire. | slug | forms.manage |
lead_scoring__update_form_scoring | Modifie les règles de scoring. | formId, scoringRules | forms.manage |
lead_scoring__list_leads | Leads à valider. | options | — |
lead_scoring__count_leads | Nombre de leads à valider. | — | — |
lead_scoring__get_lead | Lit un lead. | shortId | — |
lead_scoring__dismiss_lead | Écarte un lead (avec un motif). | shortId, reason | — |
lead_scoring__restore_lead | Restaure un lead écarté. | shortId | — |
lead_scoring__get_score_weights | Pondérations du score. | — | — |
lead_scoring__update_score_weights | Modifie les pondérations du score. | weights | forms.manage |
lead_scoring__get_proposal | Prépare une proposition de rendez-vous pour un lead. | shortId, closerId = null | — |
lead_scoring__send_proposal | Envoie la proposition de rendez-vous. | shortId, { closerId = null, slots = [], note = '' } = {} | contacts.manage |
nurture__list_drafts | Brouillons de relance en attente de validation. | options | — |
nurture__count_drafts | Nombre de brouillons. | — | — |
nurture__list_recent_sends | Relances envoyées récemment. | options | — |
nurture__approve_draft | Valide (et envoie) un brouillon. | draftId, content | — |
nurture__dismiss_draft | Écarte un brouillon. | draftId, decision | — |
Rendez-vous et Ma journée
| Outil | Rôle | args | Permission |
|---|---|---|---|
attendance__get_attendance_stats | Statistiques de présence et de no-show. | options | — |
attendance__list_at_risk_bookings | Rendez-vous à venir à risque de no-show. | options | — |
bookings__list_bookings | Liste les rendez-vous avec filtres. | options | — |
bookings__list_calendar_bookings | Rendez-vous pour une vue calendrier. | options | — |
bookings__get_booking | Lit un rendez-vous (id ou id court). | idOrShortId | — |
bookings__update_booking | Modifie un rendez-vous. | id, updates | bookings.reassign pour changer d’hôte, bookings.cancel pour annuler |
bookings__list_activity | Chronologie des rendez-vous et conversations. | options | — |
bookings__get_conversation | Lit une conversation. | id | — |
bookings__cancel_booking | Annule un rendez-vous (motif obligatoire). | id, { reason } = {} | bookings.cancel |
bookings__mark_no_show | Marque un rendez-vous en no-show. | id, { reason } = {} | — |
bookings__reassign_booking | Réattribue un rendez-vous à un autre closer. | id, { closerId, reason } = {} | bookings.reassign |
bookings__list_reschedule_slots | Créneaux libres pour déplacer un rendez-vous. | id | — |
bookings__reschedule_booking | Déplace un rendez-vous sur un nouveau créneau. | id, { start, closerId = null } = {} | bookings.reassign ou bookings.cancel |
bookings__invite_to_reschedule | Envoie au contact un lien pour choisir un autre horaire. | id | — |
bookings__record_outcome | Enregistre le résultat d'un rendez-vous. | id, { outcome, amount, notes } = {} | — |
bookings__list_booking_crm_sync_logs | Historique de synchronisation CRM d'un rendez-vous. | id | crm.view |
my_day__get_my_day | Votre journée : rendez-vous et tâches. | — | — |
my_day__record_call_outcome | Enregistre le résultat d'une tâche d'appel. | taskId, outcome, notes = null | — |
my_day__claim_booking | Prend un rendez-vous sans hôte. | id | — |
Formulaires, workflows et planification
| Outil | Rôle | args | Permission |
|---|---|---|---|
booking_form__get_booking_form_page | Lit (ou crée) le formulaire de RDV de l'agent site web. | { create = false } = {} | forms.manage |
booking_form__save_booking_form_questions | Enregistre les questions du formulaire de RDV. | questions | — |
booking_form__check_booking_form_install | Vérifie l'installation du formulaire de RDV. | — | — |
form_ai__generate_questions | Rédige des questions de qualification avec l'IA. | input = {} | forms.manage |
form_builder__get_form | Lit un formulaire par son slug. | slug | — |
form_builder__create_form | Crée un formulaire. | form | forms.manage |
form_builder__update_form | Modifie un formulaire. | id, updates | forms.manage |
form_workspace_settings__apply_form_workspace_settings | Applique des réglages à tous les formulaires de l'espace. | patch | — |
form_workspace_settings__apply_form_settings | Applique des réglages à un formulaire. | formId, patch | — |
forms__list_forms | Liste les formulaires. | — | — |
forms__toggle_form | Active ou désactive un formulaire. | id, isActive | — |
forms__delete_form | Supprime un formulaire. | id | forms.manage |
scheduling_rules__get_scheduling_rules | Règles de planification. | — | — |
scheduling_rules__update_scheduling_rules | Modifie les règles de planification. | patch | forms.manage |
scheduling_rules__update_assignment_mode | Change le mode d'attribution des rendez-vous. | mode | — |
scheduling_rules__update_closer_hours | Règle les horaires d'un closer. | closerId, workingHours | — |
workflows__list_workflow_steps | Étapes de workflow d'un formulaire. | formId | — |
workflows__create_workflow_step | Ajoute une étape de workflow. | formId, step | — |
workflows__update_workflow_step | Modifie une étape de workflow. | id, updates | — |
workflows__delete_workflow_step | Supprime une étape de workflow. | id | — |
workflows__reorder_workflow_steps | Réordonne les étapes de workflow. | formId, updates | — |
workflows__create_default_workflow | Crée le workflow par défaut. | formId, steps | — |
Agent site web, widget et connaissance
| Outil | Rôle | args | Permission |
|---|---|---|---|
knowledge__list_knowledge | Liste les bases de connaissance et leurs entrées. | — | — |
knowledge__get_entry_content | Lit le contenu d'une entrée. | id | — |
knowledge__list_knowledge_gaps | Questions auxquelles la base n'a pas su répondre. | input = {} | — |
knowledge__create_base | Crée une base de connaissance. | input | — |
knowledge__update_base | Modifie une base de connaissance. | id, updates | — |
knowledge__delete_base | Supprime une base de connaissance. | id | — |
knowledge__create_entry | Ajoute une entrée. | input | settings.manage |
knowledge__update_entry | Modifie une entrée. | id, updates | — |
knowledge__set_entries_active | Active ou désactive des entrées. | input | — |
knowledge__set_entry_openers | Utilise les questions d'une entrée comme amorces de conversation. | id, enabled | — |
knowledge__delete_entry | Supprime une entrée. | id | — |
knowledge__upload_document | Téléverse un document (fichier). | formData | settings.manage |
knowledge__import_url | Importe une page web. | input = {} | settings.manage |
onboarding__create_workspace_with_locale | Crée un espace avec sa langue. | name, slug, locale = {} | — |
onboarding__get_site_context | Ce que Nudge sait de votre site. | — | — |
onboarding__save_site_facts | Enregistre des faits sur votre activité. | { baseId, facts } = {} | — |
site_scan__refresh_site | Met à jour la lecture de votre site. | input = {} | settings.manage |
site_scan__site_directory | Pages lues sur votre site. | baseId | — |
site_scan__scan_site | Lance une lecture du site. | input = {} | settings.manage |
site_scan__summarize_scan | Résumé d'une lecture. | input = {} | settings.manage |
site_scan__list_site_scans | Liste les lectures du site. | — | — |
website__list_library | Liste la bibliothèque de l'agent site web. | baseId | — |
website__save_library | Enregistre un élément de la bibliothèque. | input | settings.manage |
website__delete_library | Supprime un élément de la bibliothèque. | id, baseId | settings.manage |
website__callback_inbox | Demandes de rappel en attente. | — | — |
website__claim_callback | Prend une demande de rappel. | id | — |
website__capacity_report | Rapport de capacité de l'équipe. | — | — |
website__conversion_report | Rapport de conversion. | — | — |
website__save_pilot | Enregistre les réglages du pilote. | input | settings.manage |
website__import_conversions | Importe des conversions. | inputs | settings.manage |
website__qualification_report | Rapport de qualification. | — | — |
website__generate_qualification | Propose des règles de qualification pour un formulaire. | formId | forms.manage |
website__decide_qualification | Accepte ou refuse une proposition de qualification. | id, decision | forms.manage |
website__callback_stats | Statistiques des rappels. | — | — |
widget_appearance__get_widget_appearance | Apparence du widget. | — | — |
widget_appearance__publish_widget_appearance | Publie une nouvelle apparence du widget. | formId, draft | forms.manage |
widget__get_widget_config | Configuration du widget d'un formulaire. | formId | — |
widget__save_widget_config | Enregistre la configuration du widget. | formId, config | forms.manage |
Analyses, insights et recherche
| Outil | Rôle | args | Permission |
|---|---|---|---|
analytics__get_analytics_overview | Chiffres clés d'une période. | options | — |
analytics__get_analytics_trends | Tendances dans le temps. | options | — |
analytics__outcomes_by_closer | Résultats des rendez-vous par closer. | options | — |
analytics__outcomes_by_form | Résultats des rendez-vous par formulaire. | options | — |
analytics__list_attribution | Attribution des leads par source. | options | — |
analytics__get_funnel_totals | Totaux du tunnel (visites, leads, rendez-vous). | options | — |
analytics__list_analytics_closers | Closers disponibles comme filtres d'analyse. | — | — |
chat_stats__get_chat_overview | Statistiques des conversations. | options | — |
chat_stats__list_chat_questions | Questions les plus posées par les visiteurs. | options | — |
chat_stats__list_hot_leads | Leads chauds issus des conversations. | options | — |
chat_stats__list_flagged_conversations | Conversations signalées. | options | — |
insights__list_insights | Liste les analyses. | options | — |
insights__get_nurture_stats | Statistiques de relance. | options | analytics.view |
insights__generate_abandon_report | Rapport sur les abandons de formulaire. | { days = 30, formId = null } = {} | forms.manage |
insights__demand_map | Carte de ce que demandent les visiteurs. | input = {} | — |
insights__pages_driving_bookings | Pages qui mènent à des rendez-vous. | input = {} | — |
search__search_workspace | Recherche dans l'espace. | term | — |
Intégrations, webhooks et pixels
| Outil | Rôle | args | Permission |
|---|---|---|---|
integrations__get_integrations_overview | État de toutes les intégrations. | — | — |
integrations__get_my_integrations | Vos comptes connectés. | — | — |
integrations__update_calendar_prefs | Modifie vos préférences d'agenda. | prefs | — |
integrations__disconnect_provider | Déconnecte un de vos fournisseurs. | provider | — |
integrations__list_my_calendars | Liste vos agendas. | — | — |
integrations__list_webhooks | Liste les webhooks. | — | — |
integrations__create_webhook | Crée un webhook (url, events, secret). | webhook | api.manage |
integrations__update_webhook | Modifie un webhook. | id, updates | api.manage |
integrations__delete_webhook | Supprime un webhook. | id | api.manage |
integrations__list_webhook_logs | Les 20 dernières livraisons d'un webhook. | webhookId | — |
integrations__get_crm_sync_config | Lit les réglages de synchronisation d'un CRM. | provider | — |
integrations__upsert_crm_sync_config | Enregistre les réglages de synchronisation d'un CRM. | provider, config | — |
integrations__list_crm_sync_logs | Journaux de synchronisation CRM d'un rendez-vous. | bookingId | — |
integrations__list_pixels | Liste les pixels publicitaires. | — | — |
integrations__list_pixel_activity | Activité récente des pixels. | — | — |
integrations__create_pixel | Crée un pixel. | pixel | — |
integrations__update_pixel | Modifie un pixel. | id, updates | — |
integrations__delete_pixel | Supprime un pixel. | id | — |
integrations__test_pixel | Envoie un événement de test à un pixel. | id, options | — |
integrations__linked_in_round | Configuration LinkedIn Ads : étape en cours. | state | — |
integrations__linked_in_accounts | Configuration LinkedIn Ads : comptes publicitaires. | state | — |
integrations__linked_in_rules | Configuration LinkedIn Ads : règles de conversion. | state, accountId | — |
integrations__linked_in_create_rule | Configuration LinkedIn Ads : crée une règle de conversion. | state, { accountId, name, type } | — |
integrations__linked_in_finish | Configuration LinkedIn Ads : termine la connexion. | state, { name, partnerId, accountId, triggers } | — |
integrations__linked_in_cancel | Configuration LinkedIn Ads : annule. | state | — |
Équipe, rôles et invitations
| Outil | Rôle | args | Permission |
|---|---|---|---|
avatar__upload_avatar | Téléverse votre photo de profil (fichier). | formData | — |
avatar__upload_org_logo | Téléverse le logo de l'espace (fichier). | formData | settings.manage |
invitations__send_invitation | Invite une personne dans l'espace. | payload | — |
invitations__resend_invitation | Renvoie une invitation. | id | — |
invitations__accept_invitation | Accepte une invitation (jeton). | token | — |
team__list_team_members | Liste les membres de l'équipe. | — | — |
team__list_closers | Liste les closers. | — | — |
team__list_teams | Liste les équipes. | — | — |
team__update_team_member | Modifie un membre. | id, updates | — |
team__deactivate_team_member | Désactive un membre. | id | — |
team__reactivate_team_member | Réactive un membre. | id | — |
team__get_my_profile_settings | Vos réglages de profil. | — | — |
team__update_my_identity | Modifie votre nom et votre identité. | identity | — |
team__update_my_working_hours | Modifie vos horaires de travail. | workingHours | — |
team__update_my_notification_prefs | Modifie vos préférences de notification. | prefs | — |
team__list_pending_invitations | Invitations en attente. | — | — |
team__create_invitation | Crée une invitation. | payload | — |
team__revoke_invitation | Révoque une invitation. | id | — |
team__list_roles | Liste les rôles. | — | — |
team__create_role | Crée un rôle. | payload | — |
team__update_role | Modifie un rôle. | id, updates | — |
team__delete_role | Supprime un rôle. | id | — |
team__list_role_permissions | Permissions de chaque rôle. | — | — |
team__update_role_permissions | Modifie les permissions d'un rôle. | role, permissions | — |
Espace, facturation et audit
| Outil | Rôle | args | Permission |
|---|---|---|---|
audit__list_audit_logs | Lit le journal d'audit. | options | audit.view |
billing__get_subscription | Abonnement en cours. | — | billing.view |
billing__get_usage | Consommation par rapport aux limites du plan. | — | billing.view |
billing__get_billing_usage | Détail de la consommation facturée. | — | billing.view |
billing__get_currency | Devise de facturation de l'espace. | — | — |
billing__start_checkout | Démarre un paiement (mensuel ou annuel). | interval = 'monthly' | billing.manage |
billing__open_portal | Ouvre le portail de facturation. | — | billing.manage |
messaging__get_messaging_settings | Réglages de notifications et de messagerie. | — | — |
messaging__update_messaging_settings | Modifie les réglages de messagerie. | patch | — |
organizations__get_organization | Lit l'espace de travail. | — | settings.view |
organizations__update_organization | Modifie l'espace de travail. | updates | settings.manage |
organizations__update_organization_settings | Modifie les réglages de l'espace. | patch | settings.manage |
organizations__delete_organization | Supprime l'espace de travail. | — | settings.manage |
support_activity__list_support_actions | Actions du support Nudge dans votre espace. | before = null | — |
support_activity__list_support_sessions | Sessions d'accès du support Nudge. | before = null | — |
workspaces__create_workspace | Crée un espace de travail. | name, slug | — |
workspaces__check_workspace_slug | Vérifie qu'un slug d'espace est libre. | — | — |
workspaces__find_domain_orgs | Espaces de votre domaine e-mail que vous pouvez rejoindre. | — | — |
workspaces__join_org_by_domain | Rejoint un espace de votre domaine e-mail. | orgId | — |