Documentation MCP Vayne

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 (clients par token uniquement)

Authorization: Bearer <YOUR_TOKEN>

Deux façons de s'authentifier. OAuth est la voie par défaut pour Claude : Claude Desktop, Claude.ai, Claude Code et Cursor n'ont besoin que de l'URL du serveur — ils vous redirigent vers Vayne pour vous connecter et autoriser l'accès, et ne stockent aucun token sur votre machine. Pour mettre fin à une connexion OAuth, supprimez le connecteur dans le client ; les tokens d'accès qu'il détient sont de courte durée et expirent d'eux-mêmes. Tous les autres clients envoient un token API Vayne dans l'en-tête Authorization.

L'utilisation du MCP nécessite un plan avec accès API (Starter et au-dessus), connexions OAuth comprises : sur un plan inférieur, le connecteur s'autorise quand même, mais chaque appel d'outil renvoie « Plan does not include API access ». 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. Claude Desktop, Claude.ai, Claude Code et Cursor peuvent se connecter à Vayne via OAuth — rien à copier hormis l'URL du serveur. Les autres extraits attendent votre token API à la place de <YOUR_TOKEN>.

https://mcp.vayne.io/mcp

{
  "mcpServers": {
    "vayne": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.vayne.io/mcp", "--header", "Authorization: Bearer <YOUR_TOKEN>"]
    }
  }
}

claude mcp add --transport http vayne https://mcp.vayne.io/mcp

claude mcp add --transport http vayne https://mcp.vayne.io/mcp --header "Authorization: Bearer <YOUR_TOKEN>"

{
  "mcpServers": {
    "vayne": {
      "url": "https://mcp.vayne.io/mcp",
      "headers": { "Authorization": "Bearer <YOUR_TOKEN>" }
    }
  }
}

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>" },
      },
    },
  },
});

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.

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. Sur un connecteur OAuth, supprimez-le puis rajoutez-le pour ré-autoriser l'accès.
• 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.