Servidor MCP alojado
Configúralo en un minuto
- Copia tu token de API desde los ajustes de tu cuenta.
- Elige tu herramienta abajo y pega el fragmento, sustituyendo el token de ejemplo.
- Reinicia tu herramienta de IA y pregúntale algo como: «¿Qué género es más probable para el nombre Andrea en Italia?»
Ejecuta este único comando en tu terminal — esa es toda la configuración.
claude mcp add --transport http --header "Authorization: Bearer YOUR_API_TOKEN" gender-api https://mcp.gender-api.com
Añade --scope user para tener Gender-API disponible en todos tus proyectos y no solo en el actual.
Claude Desktop se conecta mediante un pequeño puente npm que se descarga automáticamente. Añade esto a tu archivo de configuración — no hace falta instalar nada a mano.
{
"mcpServers": {
"gender-api": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.gender-api.com",
"--header",
"Authorization:Bearer YOUR_API_TOKEN"
]
}
}
}
Ubicación del archivo de configuración:
-
macOS
~/Library/Application Support/Claude/claude_desktop_config.json -
Windows
%APPDATA%\Claude\claude_desktop_config.json
Escribe Authorization:Bearer sin espacio después de los dos puntos — así lo espera el puente.
Añade esto en ~/.cursor/mcp.json para todos los proyectos, o en .cursor/mcp.json dentro de un solo proyecto.
{
"mcpServers": {
"gender-api": {
"url": "https://mcp.gender-api.com",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Añade esto en .vscode/mcp.json de tu proyecto, o en el mcp.json de usuario para activarlo en todas partes.
{
"servers": {
"gender-api": {
"type": "http",
"url": "https://mcp.gender-api.com",
"requestInit": {
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
}
VS Code usa servers en lugar de mcpServers y espera las cabeceras dentro de requestInit. La misma estructura funciona en Visual Studio y en los IDE de JetBrains.
Cualquier cliente compatible con MCP remoto solo necesita estos tres valores:
Endpoint: https://mcp.gender-api.com Transport: streamable-http Header: Authorization: Bearer YOUR_API_TOKEN
Si tu cliente solo admite servidores MCP locales, usa el puente npx mcp-remote que aparece en la pestaña de Claude Desktop — funciona con cualquier cliente que solo hable stdio.
Usa Gender-API directamente dentro de herramientas de IA
Nuestro Servidor MCP permite que las herramientas de IA compatibles con MCP llamen a Gender-API directamente. Eso significa que tu asistente puede enriquecer nombres de pila, nombres completos, nombres obtenidos a partir de emails y datos del país de origen mediante llamadas de herramientas estructuradas, en lugar de depender solo de instrucciones en el prompt.
No hay nada que instalar ni alojar: apunta tu herramienta a https://mcp.gender-api.com y autentícate con el mismo token de Gender-API que ya usas para la API.
Lo que puedes hacer con esto
- Usa datos en vivo de Gender-API: Tu herramienta de IA puede consultar resultados en vivo de Gender-API en lugar de inventarse formatos de solicitud o respuestas.
- Reutiliza tu token existente: El servidor MCP funciona con el mismo token Bearer de Gender-API que ya usas para la API.
- Conecta clientes compatibles con MCP: Puedes usarlo en Claude, Cursor o en tus propias herramientas y agentes internos compatibles con MCP que admitan URL de MCP alojadas.
- Mantén la facturación sencilla: Se sigue aplicando el uso normal de créditos de Gender-API, así que no tienes que aprender un segundo sistema de facturación.
Herramientas compatibles
Herramientas MCP incluidas
- query_first_name – Consultar el género probable a partir del nombre.
- query_full_name – Consulta el género más probable a partir del nombre completo.
- query_email – Extrae y enriquece un nombre a partir de una dirección de correo electrónico.
- get_country_of_origin – Obtén los países de origen más probables.
- get_statistics – Consulta los créditos restantes y las estadísticas de tu cuenta.
Transporte alojado
Usa el endpoint Streamable HTTP alojado en https://mcp.gender-api.com y autentícate con tu token bearer de Gender-API.
Casos de uso de MCP en el mundo real
Enriquecimiento de leads dentro de copilotos de IA
Deja que Claude, Cursor o un agente de ventas interno revise una lista de leads, llame a Gender-API a través de MCP y añada nombres de pila probables, género y contexto del país de origen antes de contactarles.
Personalización del CRM y del soporte técnico
Tu asistente de soporte puede analizar las direcciones de correo entrantes, extraer los nombres de pila más probables con `query_email` y crear borradores de respuesta más naturales y personalizados para los agentes.
Agentes de limpieza de hojas de cálculo y de investigación
Los agentes de limpieza de datos con MCP pueden revisar archivos CSV u hojas de cálculo, estandarizar las columnas de nombres de pila y enriquecer las filas con los resultados de Gender-API, sin necesidad de escribir código personalizado de la API en cada flujo de trabajo.
Automatización y segmentación de marketing
Usa MCP en tus asistentes de creación de campañas para generar saludos, enriquecer los datos de tus contactos y comprobar los créditos restantes antes de lanzar un flujo de trabajo de personalización.
¿Estás creando tu propio cliente MCP?
Conectar con el SDK oficial de MCP
Si escribes tu propio agente en lugar de usar una herramienta ya hecha, conecta directamente el transporte 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',
},
},
});
Preguntas frecuentes
¿Esto usa mis créditos normales de Gender-API?
Sí. El servidor MCP es una capa ligera de integración sobre los endpoints existentes de Gender-API, así que se siguen aplicando los permisos normales del token y el uso de créditos.
¿Puedo usarlo en mi propia herramienta MCP interna?
Sí. Si tu herramienta admite MCP alojado, conéctala a https://mcp.gender-api.com y envía tu token bearer de Gender-API.
¿Necesito instalar algo?
No. El servidor MCP lo alojamos nosotros, así que no hay nada que descargar ni mantener en marcha. Los clientes que solo admiten servidores MCP locales usan el puente npx mcp-remote, que se descarga solo al arrancar por primera vez.
Mi herramienta de IA no muestra las herramientas de Gender-API. ¿Qué hago?
Reinicia la herramienta después de editar su configuración y comprueba que has sustituido el token de ejemplo por tu token de API real. Si se rechaza la conexión, tu token no es válido o se ha quedado sin créditos — ambos casos aparecen como un error de autenticación.
Have any questions?
