Documentation MCP Vayne
Le serveur MCP Vayne permet aux agents IA — Claude, Cursor et tout client compatible MCP — d'utiliser chaque fonctionnalité de l'API Vayne sous forme d'outils : scraping Sales Navigator, scraping de profils et d'entreprises, scraping d'offres d'emploi et de posts, recherche inversée d'email et enrichissement email & téléphone. Cette page couvre les détails de connexion, la configuration par client, le catalogue d'outils, les crédits et les webhooks.
🤖 Donnez cette documentation à votre agent IA
Le guide agent complet — chaque outil, le modèle de crédits, les webhooks et le glossaire des colonnes d'export — est publié en une seule page markdown. Copiez-le et collez-le dans n'importe quel assistant IA, ou donnez l'URL brute à votre agent.
💡 Astuce : Les clients MCP découvrent les outils automatiquement à la connexion — le guide est du contexte supplémentaire qui aide votre agent à choisir le bon outil et à estimer les coûts avant de dépenser des crédits.
Détails de connexion
Le serveur MCP Vayne est un service HTTP hébergé et sans état — rien à installer ni à faire tourner vous-même.
- Transport
- Streamable HTTP
- URL du serveur
- https://mcp.vayne.io/mcp
- En-tête d'authentification
- Authorization: Bearer <YOUR_TOKEN>
Deux façons de s'authentifier : un token API Vayne dans l'en-tête Authorization, ou OAuth — les clients qui supportent le flux OAuth MCP (par exemple les connecteurs personnalisés claude.ai) ajoutent simplement l'URL du serveur et sont redirigés vers Vayne pour se connecter et autoriser l'accès. L'accès OAuth est révocable à tout moment depuis votre compte Vayne.
L'utilisation du MCP nécessite un plan avec accès API (Starter et au-dessus). Récupérez ou régénérez votre token API dans l'app Vayne, dans les Paramètres API ; les utilisateurs connectés trouveront aussi des configurations client prêtes à l'emploi dans la fenêtre Configuration MCP de chaque page de fonctionnalité.
Configuration par client
Choisissez votre client ci-dessous. Chaque extrait attend votre token API à la place de <YOUR_TOKEN>.
Claude.ai (web) ▾
Dans claude.ai, ouvrez Réglages → Connecteurs → Ajouter un connecteur personnalisé et collez l'URL du serveur ci-dessus — aucun token nécessaire. Claude vous redirige vers Vayne pour vous connecter et autoriser ; approuvez, et la connexion est active.
Claude Code (CLI) ▾
Ouvrez un terminal, remplacez <YOUR_TOKEN> par votre token Vayne, puis exécutez :
claude mcp add --transport http vayne https://mcp.vayne.io/mcp --header "Authorization: Bearer <YOUR_TOKEN>"Claude Desktop ▾
Ajoutez ce bloc dans claude_desktop_config.json (dans Claude Desktop, ouvrez Réglages → Développeur → Modifier la configuration), remplacez <YOUR_TOKEN>, enregistrez puis redémarrez Claude Desktop :
{
"mcpServers": {
"vayne": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.vayne.io/mcp", "--header", "Authorization: Bearer <YOUR_TOKEN>"]
}
}
}Cursor ▾
Dans Cursor, ouvrez Settings → MCP et ajoutez un nouveau serveur avec cette configuration (remplacez <YOUR_TOKEN>) :
{
"mcpServers": {
"vayne": {
"url": "https://mcp.vayne.io/mcp",
"headers": { "Authorization": "Bearer <YOUR_TOKEN>" }
}
}
}Claude Agent SDK ▾
Pour construire votre propre agent avec le Claude Agent SDK. Remplacez <YOUR_TOKEN> par le token Vayne de l'utilisateur au nom duquel l'agent agit.
import { query } from "@anthropic-ai/claude-agent-sdk";
const result = query({
prompt: "Find CEOs in North America and start a Sales Navigator scrape",
options: {
mcpServers: {
vayne: {
type: "http",
url: "https://mcp.vayne.io/mcp",
headers: { Authorization: "Bearer <YOUR_TOKEN>" },
},
},
},
});Tout autre client MCP ▾
Outils
30+ outils regroupés par fonctionnalité — les mêmes capacités que l'API Vayne, plus des assistants exclusifs au MCP comme les constructeurs de recherches Sales Navigator.
Sales Navigator
Construisez des recherches de leads ou d'entreprises à partir de critères en langage naturel, estimez gratuitement le nombre de résultats, puis créez et suivez des ordres de scraping (jusqu'à 20 000 résultats par recherche).
build_search_url · build_account_search_url · estimate_search · create_order · list_orders · get_order
Scraping de profils & entreprises
Scrapez n'importe quelle URL de profil ou d'entreprise LinkedIn — une URL unique répond instantanément, deux ou plus deviennent un job batch asynchrone.
scrape_linkedin_url · get_linkedin_scraping
Scraping & recherche d'offres d'emploi
Scrapez des offres d'emploi (à l'unité ou en batch) et cherchez des offres LinkedIn par mots-clés, localisation ou entreprise, avec chargement de pages supplémentaires à la demande.
scrape_linkedin_job · get_linkedin_job_scraping · search_linkedin_jobs · get_linkedin_job_search · load_more_linkedin_job_search
Scrapers de posts
Capturez chaque liker et commentateur d'un post, ou de tous les posts récents d'un profil ou d'une page entreprise — avec estimation du coût au préalable.
scrape_post_engagement · scrape_profile_posts · estimate_profile_posts · scrape_company_posts · estimate_company_posts · list_post_scrapers · get_post_scraper
Recherche inversée d'email
Transformez des emails B2B en profils LinkedIn. Facturé par match trouvé, pas par email soumis.
create_reverse_lookup · list_reverse_lookups · get_reverse_lookup
Enrichissement email & téléphone
Trouvez l'email professionnel et le téléphone d'un contact — un contact par appel, identifié par URL LinkedIn ou nom + domaine d'entreprise. Utilise les crédits d'enrichissement.
create_contact_finder · list_contact_finders · get_contact_finder
Find people
Recherche rapide de personnes par entreprise et titre de poste, sans construire d'URL Sales Navigator.
find_people · get_find_people
État du compte & assistants
Vérifiez les soldes de crédits et limites quotidiennes, contrôlez la connexion LinkedIn, et résolvez secteurs, localisations et entreprises en identifiants LinkedIn pour un ciblage précis.
get_credits · check_linkedin_status · search_industries · search_locations · search_companies
Crédits
Les actions MCP consomment les mêmes crédits que l'app web et l'API — il n'y a pas de tarification MCP séparée. Deux pools, tous deux visibles via get_credits :
- Les crédits de scraping financent les ordres Sales Navigator, les recherches inversées, les scrapings d'URL et d'offres d'emploi, les recherches d'offres (y compris load_more) et les scrapers de posts. Les limites quotidiennes ne s'appliquent qu'aux scrapes Sales Navigator.
- Les crédits d'enrichissement financent uniquement l'enrichissement email & téléphone (contact finder).
- Les agents ont pour consigne d'estimer le nombre de résultats et de confirmer le coût en crédits avec vous avant de créer un ordre.
Webhooks
La plupart des outils de création acceptent une URL de webhook HTTPS optionnelle qui reçoit les résultats à la fin du job — pratique pour Clay, Bitscale, les CRM, Zapier, n8n ou des backends maison. Les livraisons sont protégées par un mécanisme de confiance à la première utilisation : la première fois qu'un job cible un nouvel hôte de destination, le job s'exécute normalement mais la livraison est retenue et vous recevez un email d'approbation en un clic. Une fois approuvé, l'hôte est de confiance pour les livraisons futures ; les livraisons retenues expirent après 7 jours sans approbation.
Bon à savoir
- Les ordres de scraping sont limités à 5 par 15 minutes et par utilisateur, et les ordres dépassant vos crédits disponibles sont refusés.
- Une recherche Sales Navigator scrape au maximum 20 000 résultats — les cibles plus larges sont découpées en plusieurs recherches.
- create_order peut aussi enregistrer la recherche dans Sales Navigator (savedSearch) — leads uniquement, et LinkedIn limite les recherches enregistrées à 50 par compte.
- Le scraping Sales Navigator utilise la session LinkedIn connectée à votre compte Vayne ; si elle expire, rafraîchissez-la dans les paramètres de connexion LinkedIn de l'app. Les autres fonctionnalités ne nécessitent aucun compte LinkedIn.
- Un 401 sur n'importe quel outil signifie que le token API est erroné ou a été régénéré — copiez-en un nouveau depuis les Paramètres API.
- Les clients MCP mettent en cache la liste d'outils à la connexion ; si de nouveaux outils n'apparaissent pas, déconnectez puis reconnectez complètement le client.