Gehosteter MCP-Server
In einer Minute eingerichtet
- Kopiere deinen API-Token aus deinen Kontoeinstellungen.
- Wähle unten dein Tool aus und füge den Codeausschnitt ein – ersetze dabei den Platzhalter für den Token.
- Starte dein KI-Tool neu und frage es etwas wie: „Welches Geschlecht hat der Name Andrea in Italien wahrscheinlich?“
Führe diesen einen Befehl in deinem Terminal aus – das ist die komplette Einrichtung.
claude mcp add --transport http --header "Authorization: Bearer YOUR_API_TOKEN" gender-api https://mcp.gender-api.com
Ergänze --scope user, damit Gender-API in allen deinen Projekten verfügbar ist und nicht nur im aktuellen.
Claude Desktop verbindet sich über eine kleine npm-Bridge, die automatisch heruntergeladen wird. Füge das in deine Konfigurationsdatei ein – eine manuelle Installation ist nicht nötig.
{
"mcpServers": {
"gender-api": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.gender-api.com",
"--header",
"Authorization:Bearer YOUR_API_TOKEN"
]
}
}
}
Ort der Konfigurationsdatei:
-
macOS
~/Library/Application Support/Claude/claude_desktop_config.json -
Windows
%APPDATA%\Claude\claude_desktop_config.json
Schreibe Authorization:Bearer ohne Leerzeichen nach dem Doppelpunkt – so erwartet es die Bridge.
Füge das in ~/.cursor/mcp.json ein, wenn es für alle Projekte gelten soll, oder in .cursor/mcp.json innerhalb eines einzelnen Projekts.
{
"mcpServers": {
"gender-api": {
"url": "https://mcp.gender-api.com",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Füge das in .vscode/mcp.json in deinem Projekt ein oder in die mcp.json auf Benutzerebene, damit es überall aktiv ist.
{
"servers": {
"gender-api": {
"type": "http",
"url": "https://mcp.gender-api.com",
"requestInit": {
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
}
VS Code verwendet servers statt mcpServers und erwartet die Header innerhalb von requestInit. Dasselbe Format funktioniert in Visual Studio und in JetBrains-IDEs.
Jeder Client mit Unterstützung für Remote-MCP braucht nur diese drei Angaben:
Endpoint: https://mcp.gender-api.com Transport: streamable-http Header: Authorization: Bearer YOUR_API_TOKEN
Wenn dein Client nur lokale MCP-Server unterstützt, nutze die npx mcp-remote-Bridge aus dem Claude-Desktop-Tab – sie funktioniert mit jedem Client, der ausschließlich stdio beherrscht.
Nutze Gender-API direkt in KI-Tools
Unser MCP Server ermöglicht es MCP-kompatiblen KI-Tools, Gender-API direkt aufzurufen. Das heißt: Dein Assistent kann Vornamen, vollständige Namen, aus E-Mail-Adressen abgeleitete Namen und Herkunftsland-Daten über strukturierte Tool-Calls anreichern – statt nur über Prompt-Anweisungen.
Du musst nichts installieren und nichts hosten: Richte dein Tool auf https://mcp.gender-api.com und authentifiziere dich mit demselben Gender-API-Token, den du schon für die API verwendest.
Was Kund:innen damit machen können
- Nutze Live-Daten von Gender-API: Dein KI-Tool kann Live-Ergebnisse von Gender-API abfragen, statt sich Request-Formate oder Antworten auszudenken.
- Reuse dein vorhandenes Token: Der MCP-Server funktioniert mit demselben Gender-API-Bearer-Token, das du bereits für die API verwendest.
- MCP-kompatible Clients verbinden: Du kannst es in Claude, Cursor oder deinen eigenen MCP-kompatiblen internen Tools und Agents verwenden, die gehostete MCP-URLs unterstützen.
- Halte die Abrechnung einfach: Die normale Nutzung der Gender-API-Credits gilt weiterhin – du musst also kein zweites Abrechnungssystem kennenlernen.
Unterstützte Tools
Enthaltene MCP-Tools
- query_first_name – Vermutliches Gender anhand des Vornamens abfragen.
- query_full_name – Vermutliches Geschlecht anhand des vollständigen Namens abfragen.
- query_email – Extrahiere und erweitere einen Namen aus einer E-Mail-Adresse.
- get_country_of_origin – Erhalte wahrscheinliche Herkunftsländer.
- get_statistics – Prüfe deine verbleibenden Credits und Konto-Statistiken.
Gehosteter Transport
Nutze den gehosteten Streamable-HTTP-Endpunkt unter https://mcp.gender-api.com und authentifiziere dich mit deinem bestehenden Gender-API-Bearer-Token.
Echte MCP-Anwendungsfälle aus der Praxis
Lead-Enrichment in KI-Copilots
Lass Claude, Cursor oder einen internen Sales-Agenten eine Lead-Liste durchsehen, Gender-API über MCP aufrufen und vor der Kontaktaufnahme wahrscheinliche Vornamen, Gender und Kontext zum Herkunftsland ergänzen.
CRM- und Support-Personalisierung
Dein Support-Assistent kann eingehende E-Mail-Adressen prüfen, mit `query_email` wahrscheinliche Vornamen extrahieren und natürlichere, personalisierte Antwortentwürfe für Support-Mitarbeiter erstellen.
Agenten für Tabellenbereinigung und Recherche
MCP-fähige Datenbereinigungs-Agenten können CSV-Dateien oder Tabellen prüfen, Spalten mit Vornamen standardisieren und Zeilen mit Gender-API-Ergebnissen anreichern – ganz ohne eigenen API-Code in jedem Workflow.
Marketing-Automatisierung und Segmentierung
Nutze MCP in Assistenten zur Kampagnenerstellung, um Anreden zu generieren, Kontaktdaten anzureichern und die verbleibenden Credits zu prüfen, bevor du einen Personalisierungs-Workflow startest.
Du entwickelst deinen eigenen MCP-Client?
Mit dem offiziellen MCP-SDK verbinden
Wenn du einen eigenen Agenten schreibst statt ein fertiges Tool zu nutzen, verbinde den Streamable-HTTP-Transport direkt:
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',
},
},
});
Häufig gestellte Fragen
Verwendet das meine normalen Gender-API-Credits?
Ja. Der MCP-Server ist eine schlanke Integrationsschicht über den bestehenden Gender-API-Endpunkten, daher gelten weiterhin die normalen Token-Berechtigungen und die übliche Credit-Nutzung.
Kann ich es in meinem eigenen internen MCP-Tool verwenden?
Ja. Wenn dein Tool gehostetes MCP unterstützt, verbinde es mit https://mcp.gender-api.com und sende deinen Gender-API-Bearer-Token.
Muss ich etwas installieren?
Nein. Der MCP-Server wird von uns gehostet, es gibt also nichts herunterzuladen und nichts, was dauerhaft laufen muss. Clients, die nur lokale MCP-Server unterstützen, nutzen die npx mcp-remote-Bridge, die sich beim ersten Start selbst herunterlädt.
Mein KI-Tool zeigt die Gender-API-Tools nicht an. Was nun?
Starte das Tool neu, nachdem du seine Konfiguration geändert hast, und prüfe noch einmal, ob du den Platzhalter durch deinen echten API-Token ersetzt hast. Wird die Verbindung abgelehnt, ist dein Token ungültig oder hat keine Credits mehr – beides erscheint als Authentifizierungsfehler.
Noch fragen?
