Värdad MCP-server
Klart på en minut
- Kopiera din API-token från dina kontoinställningar.
- Välj ditt verktyg nedan och klistra in kodsnutten, byt ut platshållaren mot din token.
- Starta om ditt AI-verktyg och fråga något i stil med: ”Vilket kön har namnet Andrea sannolikt i Italien?”
Kör det här enda kommandot i terminalen — det är hela installationen.
claude mcp add --transport http --header "Authorization: Bearer YOUR_API_TOKEN" gender-api https://mcp.gender-api.com
Lägg till --scope user för att göra Gender-API tillgängligt i alla dina projekt och inte bara det aktuella.
Claude Desktop ansluter via en liten npm-brygga som laddas ner automatiskt. Lägg till detta i din konfigurationsfil — ingen manuell installation behövs.
{
"mcpServers": {
"gender-api": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.gender-api.com",
"--header",
"Authorization:Bearer YOUR_API_TOKEN"
]
}
}
}
Konfigurationsfilens plats:
-
macOS
~/Library/Application Support/Claude/claude_desktop_config.json -
Windows
%APPDATA%\Claude\claude_desktop_config.json
Skriv Authorization:Bearer utan blanksteg efter kolon — så förväntar sig bryggan det.
Lägg till detta i ~/.cursor/mcp.json för alla projekt, eller i .cursor/mcp.json inuti ett enskilt projekt.
{
"mcpServers": {
"gender-api": {
"url": "https://mcp.gender-api.com",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Lägg till detta i .vscode/mcp.json i ditt projekt, eller i mcp.json på användarnivå för att aktivera det överallt.
{
"servers": {
"gender-api": {
"type": "http",
"url": "https://mcp.gender-api.com",
"requestInit": {
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
}
VS Code använder servers i stället för mcpServers och förväntar sig headers inuti requestInit. Samma struktur fungerar i Visual Studio och JetBrains-IDE:er.
Alla klienter som stöder fjärr-MCP behöver bara dessa tre värden:
Endpoint: https://mcp.gender-api.com Transport: streamable-http Header: Authorization: Bearer YOUR_API_TOKEN
Om din klient bara stöder lokala MCP-servrar använder du bryggan npx mcp-remote från fliken Claude Desktop — den fungerar med alla klienter som bara pratar stdio.
Använd Gender-API direkt i AI-verktyg
Vår MCP-server låter MCP-kompatibla AI-verktyg anropa Gender-API direkt. Det betyder att din assistent kan berika förnamn, fullständiga namn, e-postbaserade namn och ursprungsland via strukturerade verktygsanrop istället för enbart instruktioner i prompten.
Det finns inget att installera och inget att hosta: peka ditt verktyg mot https://mcp.gender-api.com och autentisera med samma Gender-API-token som du redan använder för API:et.
Vad kunder kan göra med det
- Använd live Gender-API-data: Ditt AI-verktyg kan fråga efter live Gender-API-resultat istället för att hitta på anropsformat eller svar.
- Återanvänd din befintliga token: MCP-servern fungerar med samma Gender-API bearer token som du redan använder för API:et.
- Anslut MCP-kompatibla klienter: Du kan använda det i Claude, Cursor eller dina egna MCP-kompatibla interna verktyg och agenter som stöder hostade MCP-URL:er.
- Håll faktureringen enkel: Normal kreditanvändning för Gender-API gäller fortfarande, så det finns inget nytt faktureringssystem att lära sig.
Supported verktyg
Ingående MCP-verktyg
- query_first_name – Fråga efter troligt kön baserat på förnamn.
- query_full_name – Fråga efter troligt kön baserat på fullständigt namn.
- query_email – Extrahera och berika ett namn från en e-postadress.
- get_country_of_origin – Hämta troliga ursprungsländer.
- get_statistics – Kontrollera återstående krediter och kontostatistik.
Hostad transport
Använd den hostade Streamable HTTP-endpointen på https://mcp.gender-api.com och autentisera med din befintliga Gender-API bearer-token.
Verkliga MCP-användningsområden
Lead-berikning i AI-copiloter
Låt Claude, Cursor eller en intern säljagent granska en lead-lista, anropa Gender-API via MCP och lägga till troliga förnamn, kön och ursprungsland som kontext innan kontakt tas.
CRM och personalisering av support
Din supportassistent kan granska inkommande e-postadresser, extrahera troliga förnamn med `query_email` och skapa mer naturliga, personliga utkast för agenter.
Städning av kalkylblad och research-agenter
MCP-aktiverade agenter för datastädning kan granska CSV-filer eller kalkylblad, standardisera kolumner med förnamn och berika rader med Gender-API-resultat utan anpassad API-kod i varje arbetsflöde.
Marknadsföringsautomatisering och segmentering
Använd MCP i assistenter för kampanjbygge för att generera hälsningsfraser, berika kontaktdata och kontrollera återstående krediter innan ett personaliserat arbetsflöde startas.
Bygger du en egen MCP-klient?
Anslut med det officiella MCP-SDK:t
Om du skriver en egen agent i stället för att använda ett färdigt verktyg ansluter du Streamable HTTP-transporten 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',
},
},
});
Vanliga frågor
Används mina vanliga Gender-API-krediter för detta?
Ja. MCP-servern är ett tunt integrationslager ovanpå de befintliga Gender-API-ändpunkterna, så vanliga token-behörigheter och kreditförbrukning gäller fortfarande.
Kan jag använda det i mitt eget interna MCP-verktyg?
Ja. Om ditt verktyg stöder hostad MCP ansluter du det till https://mcp.gender-api.com och skickar din Gender-API bearer-token.
Behöver jag installera något?
Nej. MCP-servern hostas av oss, så det finns inget att ladda ner eller hålla igång. Klienter som bara stöder lokala MCP-servrar använder bryggan npx mcp-remote, som laddar ner sig själv vid första starten.
Mitt AI-verktyg visar inte Gender-API-verktygen. Vad gör jag?
Starta om verktyget efter att du ändrat konfigurationen och dubbelkolla att du bytt ut platshållaren mot din riktiga API-token. Om anslutningen nekas är din token ogiltig eller utan krediter — båda visas som ett autentiseringsfel.
Har du några frågor?
