Gehoste MCP-server
In één minuut ingesteld
- Kopieer je API-token uit je accountinstellingen.
- Kies hieronder je tool en plak het fragment, met je eigen token in plaats van de placeholder.
- Herstart je AI-tool en vraag iets als: “Welk geslacht heeft de naam Andrea in Italië waarschijnlijk?”
Voer dit ene commando uit in je terminal — dat is de hele installatie.
claude mcp add --transport http --header "Authorization: Bearer YOUR_API_TOKEN" gender-api https://mcp.gender-api.com
Voeg --scope user toe om Gender-API in al je projecten beschikbaar te maken in plaats van alleen in het huidige.
Claude Desktop maakt verbinding via een kleine npm-brug die automatisch wordt gedownload. Voeg dit toe aan je configuratiebestand — handmatig installeren is niet nodig.
{
"mcpServers": {
"gender-api": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.gender-api.com",
"--header",
"Authorization:Bearer YOUR_API_TOKEN"
]
}
}
}
Locatie van het configuratiebestand:
-
macOS
~/Library/Application Support/Claude/claude_desktop_config.json -
Windows
%APPDATA%\Claude\claude_desktop_config.json
Schrijf Authorization:Bearer zonder spatie na de dubbele punt — zo verwacht de brug het.
Voeg dit toe aan ~/.cursor/mcp.json voor alle projecten, of aan .cursor/mcp.json binnen één project.
{
"mcpServers": {
"gender-api": {
"url": "https://mcp.gender-api.com",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Voeg dit toe aan .vscode/mcp.json in je project, of aan de mcp.json op gebruikersniveau om het overal aan te zetten.
{
"servers": {
"gender-api": {
"type": "http",
"url": "https://mcp.gender-api.com",
"requestInit": {
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
}
VS Code gebruikt servers in plaats van mcpServers en verwacht de headers binnen requestInit. Dezelfde structuur werkt in Visual Studio en JetBrains-IDE's.
Elke client die remote MCP ondersteunt heeft alleen deze drie waarden nodig:
Endpoint: https://mcp.gender-api.com Transport: streamable-http Header: Authorization: Bearer YOUR_API_TOKEN
Ondersteunt je client alleen lokale MCP-servers, gebruik dan de npx mcp-remote-brug uit het Claude Desktop-tabblad — die werkt met elke client die alleen stdio spreekt.
Gebruik Gender-API direct in AI-tools
Onze MCP Server laat MCP-compatibele AI-tools Gender-API rechtstreeks aanroepen. Dat betekent dat je assistent voornamen, volledige namen, namen afgeleid van e-mailadressen en herkomstlandgegevens kan verrijken via gestructureerde tool-calls in plaats van alleen prompt-instructies.
Er is niets te installeren en niets te hosten: laat je tool naar https://mcp.gender-api.com wijzen en authenticeer met hetzelfde Gender-API-token dat je al voor de API gebruikt.
Wat klanten ermee kunnen doen
- Gebruik live Gender-API-gegevens: Je AI-tool kan live resultaten opvragen via Gender-API, in plaats van zelf requestformaten of responses te verzinnen.
- Hergebruik je bestaande token: De MCP-server werkt met dezelfde Gender-API bearer token die je al gebruikt voor de API.
- Verbind MCP-compatibele clients: Je kunt het gebruiken in Claude, Cursor of je eigen MCP-compatibele interne tools en agents die gehoste MCP-URL’s ondersteunen.
- Houd facturatie eenvoudig: Het normale gebruik van Gender-API-credits blijft gewoon gelden, dus je hoeft geen tweede factureringssysteem te leren.
Ondersteunde tools
Inbegrepen MCP-tools
- query_first_name – Waarschijnlijk gender opvragen op basis van voornaam.
- query_full_name – Waarschijnlijk gender opvragen op basis van de volledige naam.
- query_email – Haal een naam uit een e-mailadres en verrijk deze met extra gegevens.
- get_country_of_origin – Ontdek de meest waarschijnlijke landen van herkomst.
- get_statistics – Controleer je resterende credits en accountstatistieken.
Gehost transport
Gebruik het gehoste Streamable HTTP-endpoint op https://mcp.gender-api.com en authenticeer met je bestaande Gender-API bearer-token.
Praktische MCP-toepassingen uit de echte wereld
Leadverrijking binnen AI-copilots
Laat Claude, Cursor of een interne salesagent naar een leadlijst kijken, Gender-API via MCP aanroepen en vóór je outreach waarschijnlijk voorkomende voornamen, gender en context over het land van herkomst toevoegen.
CRM- en supportpersonalisatie
Je supportassistent kan binnenkomende e-mailadressen analyseren, met `query_email` waarschijnlijke voornamen ophalen en voor je agents natuurlijkere, persoonlijkere conceptantwoorden opstellen.
Agenten voor spreadsheet-opschoning en onderzoek
MCP-compatibele data-opschoningsagents kunnen CSV-bestanden of spreadsheets controleren, kolommen met voornamen standaardiseren en rijen verrijken met Gender-API-resultaten—zonder in elke workflow aparte API-code te hoeven schrijven.
Marketingautomatisering en segmentatie
Gebruik MCP in assistenten voor het opzetten van campagnes om aanhefteksten te genereren, contactgegevens te verrijken en je resterende credits te controleren voordat je een personalisatieworkflow start.
Bouw je je eigen MCP-client?
Verbinden met de officiële MCP-SDK
Schrijf je je eigen agent in plaats van een kant-en-klare tool te gebruiken, verbind dan direct het Streamable HTTP-transport:
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',
},
},
});
Veelgestelde vragen
Gebruikt dit mijn normale Gender-API-credits?
Ja. De MCP-server is een dunne integratielaag bovenop de bestaande Gender-API-endpoints, dus de normale tokenrechten en het creditverbruik blijven gewoon van toepassing.
Kan ik het gebruiken in mijn eigen interne MCP-tool?
Ja. Als je tool gehoste MCP ondersteunt, verbind die dan met https://mcp.gender-api.com en stuur je Gender-API bearer-token mee.
Moet ik iets installeren?
Nee. De MCP-server hosten wij, dus je hoeft niets te downloaden of te laten draaien. Clients die alleen lokale MCP-servers ondersteunen gebruiken de npx mcp-remote-brug, die zichzelf bij de eerste start downloadt.
Mijn AI-tool laat de Gender-API-tools niet zien. Wat nu?
Herstart de tool nadat je de configuratie hebt aangepast en controleer of je de placeholder door je echte API-token hebt vervangen. Wordt de verbinding geweigerd, dan is je token ongeldig of zonder credits — beide verschijnen als een authenticatiefout.
Heb je vragen?
