Servidor MCP alojado
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.
The easiest setup is the hosted Streamable HTTP endpoint at https://mcp.gender-api.com.
Los clientes se conectan directamente al endpoint MCP alojado y se autentican con el mismo token bearer de Gender-API que ya usan 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
Use the hosted Streamable HTTP endpoint at https://mcp.gender-api.com and authenticate with your existing Gender-API bearer token.
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.
Cómo pueden usarlo tus clientes en sus propias herramientas
1. Usa el endpoint MCP alojado
Si tu plataforma de IA es compatible con MCP remoto, conéctala directamente al endpoint alojado que aparece abajo y autentícate con tu token bearer habitual de Gender-API.
https://mcp.gender-api.com
2. Autentícate con tu token de API habitual
Hosted MCP usa el mismo token de Gender-API que ya utilizas para la API. Envíalo como token bearer en las cabeceras de la solicitud.
Authorization: Bearer your-api-token
3. Usa las herramientas de Gender-API incluidas
Después de que se inicialice la sesión MCP alojada, tu cliente puede llamar a las herramientas integradas de Gender-API para el enriquecimiento en tiempo real y la verificación de la cuenta.
query_first_name query_full_name query_email get_country_of_origin get_statistics
Eso mantiene el onboarding sencillo: un único endpoint alojado, un token bearer y un solo conjunto de herramientas para todos los clientes MCP compatibles.
Configuraciones de ejemplo del cliente
Ejemplo de SDK en producción
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',
},
},
});
Patrón de configuración del cliente MCP para producción
{
"mcpServers": {
"gender-api": {
"transport": "streamable-http",
"url": "https://mcp.gender-api.com",
"headers": {
"Authorization": "Bearer your-api-token"
}
}
}
}
Los nombres exactos de los campos varían según el cliente, pero cualquier configuración alojada necesita la misma URL de MCP y el encabezado de token bearer.
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?
Yes. If your tool supports hosted MCP, connect it to https://mcp.gender-api.com and send your Gender-API bearer token.