Configuration en une minute

Copie ton token API depuis tes paramètres de compte.
Choisis ton outil ci-dessous et colle l’extrait de code en remplaçant le token.
Redémarre ton outil d’IA et pose-lui une question comme : « Quel est le genre probable du prénom Andrea en Italie ? »

Lance cette seule commande dans ton terminal — c’est toute la configuration.

claude mcp add --transport http --header "Authorization: Bearer YOUR_API_TOKEN" gender-api https://mcp.gender-api.com

Ajoute --scope user pour rendre Gender-API disponible dans tous tes projets et pas seulement le projet courant.

Claude Desktop se connecte via un petit pont npm téléchargé automatiquement. Ajoute ceci à ton fichier de configuration — aucune installation manuelle n’est nécessaire.

{
  "mcpServers": {
    "gender-api": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.gender-api.com",
        "--header",
        "Authorization:Bearer YOUR_API_TOKEN"
      ]
    }
  }
}

Emplacement du fichier de configuration :

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

Écris Authorization:Bearer sans espace après les deux-points — c’est ce que le pont attend.

Ajoute ceci dans ~/.cursor/mcp.json pour tous les projets, ou dans .cursor/mcp.json pour un seul projet.

{
  "mcpServers": {
    "gender-api": {
      "url": "https://mcp.gender-api.com",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Ajoute ceci dans .vscode/mcp.json de ton projet, ou dans le mcp.json au niveau utilisateur pour l’activer partout.

{
  "servers": {
    "gender-api": {
      "type": "http",
      "url": "https://mcp.gender-api.com",
      "requestInit": {
        "headers": {
          "Authorization": "Bearer YOUR_API_TOKEN"
        }
      }
    }
  }
}

VS Code utilise servers au lieu de mcpServers et attend les en-têtes dans requestInit. La même structure fonctionne dans Visual Studio et les IDE JetBrains.

Tout client compatible avec le MCP distant n’a besoin que de ces trois valeurs :

Endpoint:  https://mcp.gender-api.com
Transport: streamable-http
Header:    Authorization: Bearer YOUR_API_TOKEN

Si ton client ne prend en charge que les serveurs MCP locaux, utilise le pont npx mcp-remote présenté dans l’onglet Claude Desktop — il fonctionne avec tout client stdio.

Utilise Gender-API directement dans les outils d’IA

Notre serveur MCP permet aux outils d’IA compatibles MCP d’appeler Gender-API directement. Résultat : ton assistant peut enrichir les prénoms, les noms complets, les noms déduits d’une adresse e-mail et les données sur le pays d’origine via des appels d’outils structurés, plutôt qu’avec de simples instructions dans le prompt.

Il n’y a rien à installer ni à héberger : pointe ton outil vers https://mcp.gender-api.com et authentifie-toi avec le même token Gender-API que tu utilises déjà pour l’API.

Ce que tu peux faire avec ça

Utilise les données en direct de Gender-API: Ton outil d’IA peut interroger les résultats Gender-API en direct, au lieu d’inventer des formats de requête ou des réponses.
Réutilise ton token existant: Le serveur MCP fonctionne avec le même bearer token Gender-API que tu utilises déjà pour l’API.
Connecte des clients compatibles MCP: Tu peux l’utiliser dans Claude, Cursor, ou tes propres outils et agents internes compatibles MCP qui prennent en charge les URL MCP hébergées.
Garde une facturation simple: L’utilisation normale des crédits Gender-API s’applique toujours, donc tu n’as pas de deuxième système de facturation à apprendre.

Outils pris en charge

Outils MCP inclus

query_first_name – Rechercher le genre probable à partir du prénom.
query_full_name – Interroge le genre probable à partir du nom complet.
query_email – Extrait et enrichit un prénom à partir d’une adresse e-mail.
get_country_of_origin – Obtiens les pays d’origine les plus probables.
get_statistics – Vérifie tes crédits restants et les statistiques de ton compte.

Transport hébergé

Utilise le point de terminaison Streamable HTTP hébergé à l’adresse https://mcp.gender-api.com et authentifie-toi avec ton token bearer Gender-API existant.

Cas d’usage MCP en situation réelle

Enrichissement de leads dans les copilotes IA

Laisse Claude, Cursor ou un agent commercial interne analyser une liste de leads, appeler Gender-API via MCP, et ajouter des prénoms probables, le genre et le pays d’origine pour contextualiser avant la prise de contact.

Personnalisation du CRM et de l’assistance

Ton assistant support peut analyser les adresses e-mail entrantes, en extraire des prénoms probables avec `query_email`, et créer des brouillons de réponse personnalisés, plus naturels, pour tes agents.

Agents de nettoyage de tableur et de recherche

Les agents de nettoyage de données compatibles MCP peuvent analyser des fichiers CSV ou des feuilles de calcul, standardiser les colonnes de prénom et enrichir les lignes avec les résultats de Gender-API, sans avoir à écrire du code API sur mesure dans chaque workflow.

Automatisation et segmentation marketing

Utilise MCP dans les assistants de création de campagnes pour générer des salutations, enrichir les données de tes contacts et vérifier tes crédits restants avant de lancer un workflow de personnalisation.

Tu développes ton propre client MCP ?

Se connecter avec le SDK MCP officiel

Si tu écris ton propre agent au lieu d’utiliser un outil prêt à l’emploi, connecte directement le transport Streamable HTTP :

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';

const transport = new StreamableHTTPClientTransport(new URL('https://mcp.gender-api.com'), {
  requestInit: {
    headers: {
      Authorization: 'Bearer YOUR_API_TOKEN',
    },
  },
});

Foire aux questions

01

Est-ce que ça utilise mes crédits Gender-API habituels ?

Oui. Le serveur MCP est une fine couche d’intégration au-dessus des endpoints Gender-API existants, donc les permissions de token habituelles et l’utilisation des crédits s’appliquent toujours.

02

Puis-je l’utiliser dans mon propre outil MCP interne ?

Oui. Si ton outil prend en charge le MCP hébergé, connecte-le à https://mcp.gender-api.com et envoie ton token bearer Gender-API.

03

Dois-je installer quelque chose ?

Non. Le serveur MCP est hébergé par nous, il n’y a donc rien à télécharger ni à faire tourner. Les clients qui ne prennent en charge que les serveurs MCP locaux utilisent le pont npx mcp-remote, qui se télécharge tout seul au premier démarrage.

04

Mon outil d’IA n’affiche pas les outils Gender-API. Que faire ?

Redémarre l’outil après avoir modifié sa configuration et vérifie que tu as bien remplacé le token d’exemple par ton vrai token API. Si la connexion est refusée, ton token est invalide ou n’a plus de crédits — les deux apparaissent comme une erreur d’authentification.

Serveur MCP hébergé