Nastavíte za minutu

Zkopírujte svůj API token z nastavení účtu.
Vyberte si níže svůj nástroj a vložte úryvek kódu, přičemž zástupný token nahraďte svým.
Restartujte svůj AI nástroj a zkuste se ho zeptat třeba: „Jaké pohlaví má pravděpodobně jméno Andrea v Itálii?“

Spusťte v terminálu tento jediný příkaz — to je celé nastavení.

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

Přidejte --scope user, aby bylo Gender-API dostupné ve všech vašich projektech, a nejen v tom aktuálním.

Claude Desktop se připojuje přes malý npm můstek, který se stáhne automaticky. Přidejte toto do svého konfiguračního souboru — ruční instalace není potřeba.

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

Umístění konfiguračního souboru:

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

Napište Authorization:Bearer bez mezery po dvojtečce — takto to můstek očekává.

Přidejte toto do ~/.cursor/mcp.json pro všechny projekty, nebo do .cursor/mcp.json v jednotlivém projektu.

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

Přidejte toto do .vscode/mcp.json ve svém projektu, nebo do mcp.json na úrovni uživatele, aby to fungovalo všude.

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

VS Code používá servers místo mcpServers a očekává hlavičky uvnitř requestInit. Stejná struktura funguje ve Visual Studiu a v IDE od JetBrains.

Každý klient, který podporuje vzdálené MCP, potřebuje jen tyto tři hodnoty:

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

Pokud váš klient podporuje pouze lokální MCP servery, použijte můstek npx mcp-remote ukázaný v záložce Claude Desktop — funguje s každým klientem, který umí jen stdio.

Nutzen Sie Gender-API direkt in KI-Tools

Unser MCP-Server ermöglicht MCP-kompatiblen KI-Tools, die Gender-API direkt aufzurufen. Das bedeutet, Ihr Assistent kann Vornamen, vollständige Namen, e-Mail-abgeleitete Namen und Herkunftsländer-Daten durch strukturierte Toolaufrufe bereichern, anstelle von reinen Prompt-Anweisungen.

Není co instalovat ani hostovat: nasměrujte svůj nástroj na https://mcp.gender-api.com a přihlaste se stejným Gender-API tokenem, jaký už používáte pro API.

Was Kunden damit tun können

Verwenden Sie Live-Gender-API-Daten: Dein KI-Tool kann Live-Gender-API-Ergebnisse abfragen, anstatt Anruf-Formate oder Antworten zu erfinden.
Wiederverwendung deines bestehenden Tokens: Der MCP-Server funktioniert mit dem gleichen Gender-API-Bearer-Token, das Sie bereits für die API verwenden.
Verbinde MCP-kompatible Clients: Sie können es in Claude, Cursor oder Ihren eigenen MCP-kompatiblen internen Tools und Agents verwenden, die gehostete MCP-URLs unterstützen.
Berechnung einfach halten: { "translations": [ {"id": 0, "translation": "{ "translations": [ {"id": 0, "translation": "Normalerweise gelten weiterhin die regulären Credit-Nutzung der Gender-API, sodass kein zweites Abrechnungssystem erlernt werden muss." } ] }"

Unterstützte Tools

Eingebettete MCP-Tools

query_first_name – Vermutetes Geschlecht nach Vornamen ermitteln.
query_full_name – Vermutliches Geschlecht nach vollständigem Namen ermitteln.
query_email – Name aus einer E-Mail-Adresse extrahieren und anreichern.
get_country_of_origin – Ermöglichen Sie wahrscheinlich Herkunftsländer.
get_statistics – Verbleibende Credits und Kontostatistiken überprüfen.

Beherbergter Transport

Použijte hostovaný endpoint Streamable HTTP na adrese https://mcp.gender-api.com a přihlaste se svým existujícím Gender-API bearer tokenem.

Reale MCP-Anwendungsfälle

Lead-Anreicherung in KI-CoPilots

Verlassen Sie sich darauf, dass Claude, Cursor oder ein interner Vertriebsmitarbeiter eine Lead-Liste prüft, Gender-API über MCP aufruft und vor der Kontaktaufnahme wahrscheinliche Vornamen, Geschlecht und Kontext zum Herkunftsländer hinzufügt.

CRM- und Support-Personalisierung

Ihr Assistent für den Kundendienst kann eingehende E-Mail-Adressen prüfen, mit `query_email` wahrscheinliche Vornamen extrahieren und natürlichere, personalisierte Entwurfsantworten für Agents erstellen.

Agents zur Bereinigung und Recherche von Tabellenkalkulationen

MCP-fähige Data-Cleaning-Agents können CSV-Dateien oder Tabellenkalkulationen überprüfen, Spalten mit Vornamen standardisieren und Zeilen mit Gender-API-Ergebnissen anreichern, ohne in jedem Workflow eigenen API-Code zu verwenden.

Marketing-Automatisierung und Segmentierung

Nutzen Sie MCP in Assistenten für Kampagnenaufbau, um Anreden zu generieren, Kontaktdaten anzureichern und die verbleibenden Credits zu prüfen, bevor Sie einen Personalisierungsworkflow starten.

Stavíte vlastního MCP klienta?

Připojit se s oficiálním MCP SDK

Pokud si píšete vlastního agenta místo použití hotového nástroje, připojte transport Streamable HTTP přímo:

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

Často kladené otázky

01

Verbraucht dies meine normalen Gender-API-Credits?

Ja. Der MCP-Server ist eine dünne Integrationsschicht über den bestehenden Gender-API-Endpunkten, daher gelten normale Token-Berechtigungen und die Credit-Nutzung weiterhin.

02

Kann ich es in meinem eigenen internen MCP-Tool verwenden?

Ano. Pokud váš nástroj podporuje hostované MCP, připojte ho k https://mcp.gender-api.com a pošlete svůj Gender-API bearer token.

03

Musím něco instalovat?

Ne. MCP server hostujeme my, takže není co stahovat ani udržovat v běhu. Klienti, kteří podporují pouze lokální MCP servery, používají můstek npx mcp-remote, který se sám stáhne při prvním spuštění.

04

Můj AI nástroj nezobrazuje nástroje Gender-API. Co teď?

Po úpravě konfigurace nástroj restartujte a zkontrolujte, že jste zástupný token nahradili svým skutečným API tokenem. Pokud je připojení odmítnuto, váš token je neplatný nebo mu chybí kredity — obojí se projeví jako chyba přihlášení.

Gehosteter MCP-Server