Leadify MCP Server

Serveur MCP (Model Context Protocol) pour l'API Leadify. Expose tous les endpoints REST de Leadify sous forme de tools MCP, utilisables depuis Claude Desktop, Claude Code ou tout client compatible MCP.

Installation

Le serveur est publié sur npm sous @agifyai/leadify-mcp. Aucun clone, aucun build local : npx télécharge la dernière version à chaque démarrage.

Claude Desktop

Ouvrir le fichier de configuration :

• macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows : %APPDATA%\Claude\claude_desktop_config.json

Ajouter une entrée "leadify" dans "mcpServers" :

{
  "mcpServers": {
    "leadify": {
      "command": "npx",
      "args": ["-y", "@agifyai/leadify-mcp@latest"],
      "env": {
        "LEADIFY_API_KEY": "votre-clé-api"
      }
    }
  }
}

Redémarrer Claude Desktop. Les tools apparaissent (icône marteau).

Claude Code

claude mcp add leadify npx -y @agifyai/leadify-mcp@latest -e LEADIFY_API_KEY=votre-clé-api

Mise à jour automatique

Le tag @latest force npx à vérifier la version publiée à chaque lancement de session MCP. Quand un nouveau tool est mergé sur main et publié, il est dispo à la session suivante — pas de git pull, pas de rebuild.

Développement

Pour bosser sur le MCP en local :

git clone [email protected]:AgifyAI/mcp_leadify.git
cd mcp_leadify
npm install
npm run build

Pointer Claude Code sur la build locale :

claude mcp add leadify-dev node /chemin/absolu/vers/mcp_leadify/dist/index.js -e LEADIFY_API_KEY=votre-clé-api

Publier une nouvelle version

npm version patch   # ou minor / major
git push && git push --tags

GitHub Actions build et publie sur npm automatiquement (workflow .github/workflows/publish.yml). Si la version dans package.json n'a pas bougé, le workflow skip — pas de doublon.

Tools disponibles

| Tool | Description | |------|-------------| | test_api_key | Vérifier que la clé API configurée est valide (health check). | | add_leads | Ajouter un ou plusieurs leads à un groupe. | | get_leads | Rechercher et lister des leads avec filtres, recherche et pagination. | | get_lead | Récupérer les détails complets d'un lead par son ID. | | update_lead | Mettre à jour un ou plusieurs champs d'un lead existant. | | delete_leads | Supprimer définitivement des leads par leurs IDs. | | update_schema | Ajouter ou modifier les définitions de champs d'un groupe. | | delete_columns | Supprimer des colonnes du schéma et des données d'un groupe. | | update_hidden_columns | Afficher ou masquer des colonnes dans la vue tableau (réversible). | | add_campaign_log | Enregistrer une entrée de log de campagne pour un lead. | | get_campaign_logs | Récupérer les logs de campagne avec filtres et pagination. | | delete_campaign_log | Supprimer une entrée de log de campagne. | | update_campaign_stats | Mettre à jour les statistiques d'email d'une campagne pour un groupe de leads. | | create_campaign | Créer une nouvelle campagne rattachée à un groupe de leads (statut DRAFT). | | get_campaign | Récupérer les détails d'une campagne et ses KPIs temps réel. | | update_campaign_status | Changer le statut d'une campagne (DRAFT, ACTIVE, PAUSED, COMPLETED). | | export_campaign | Exporter les statistiques complètes d'une campagne en CSV. | | add_signal | Ajouter un signal de business intelligence à un lead (INFO, CRITICAL, GOLDEN). | | add_activity | Journaliser une interaction prospect (LinkedIn, email, call) dans le feed du lead. | | get_data_room | Récupérer la data room complète : infos société, documents, personas. | | update_data_room | Mettre à jour les informations société (companyInfo) de la data room. | | add_data_room_document | Ajouter un document textuel à la data room avec catégorie. | | upsert_persona | Créer ou mettre à jour un persona (ciblage, messaging, outils actifs). | | get_persona | Récupérer un persona par son ID. | | get_lead_group_persona | Récupérer le persona assigné à un groupe de leads. | | list_data_sources | Lister toutes les sources de données configurées (par pays puis nom). | | create_data_source | Créer une nouvelle source de données (admin uniquement). | | update_data_source | Modifier une source de données existante (admin uniquement). | | delete_data_source | Supprimer définitivement une source de données (admin uniquement). | | get_outreach_settings | Récupérer la config outreach d'un lead group (positioning, sequence, rules, URLs, case studies). | | update_outreach_settings | Update full-form (escape hatch) — remplace les blocs JSON entièrement. Préférer les tools granulaires ci-dessous. | | update_outreach_positioning | Patch partiel du positioning (dream / fear / whyNow individuellement). | | update_outreach_sequence_slot | Patch d'un seul slot de séquence (connexion, linkedin.one/two/three, email.one/two/three) sans toucher les autres. | | update_outreach_rules | Patch du bloc rules : forbidden/priority (replace), format.* (deep-merge). | | update_outreach_case_study | Ajouter / remplacer / supprimer un case study par index, sans re-envoyer la liste. | | update_outreach_urls | Patch booking_url et/ou website_url uniquement. | | set_outreach_connection_request | Toggle du flag connectionRequestEnabled (LinkedIn invite vs cold DM). |

Développement

Mode watch pour le développement :

npm run dev