Servidor MCP hospedado
Configure em um minuto
- Copie seu token de API nas configurações da sua conta.
- Escolha sua ferramenta abaixo e cole o trecho, substituindo o token de exemplo.
- Reinicie sua ferramenta de IA e pergunte algo como: “Qual é o gênero provável do nome Andrea na Itália?”
Rode este único comando no seu terminal — é toda a configuração.
claude mcp add --transport http --header "Authorization: Bearer YOUR_API_TOKEN" gender-api https://mcp.gender-api.com
Adicione --scope user para deixar o Gender-API disponível em todos os seus projetos, e não só no atual.
O Claude Desktop se conecta por uma pequena ponte npm baixada automaticamente. Adicione isto ao seu arquivo de configuração — não precisa instalar nada na mão.
{
"mcpServers": {
"gender-api": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.gender-api.com",
"--header",
"Authorization:Bearer YOUR_API_TOKEN"
]
}
}
}
Local do arquivo de configuração:
-
macOS
~/Library/Application Support/Claude/claude_desktop_config.json -
Windows
%APPDATA%\Claude\claude_desktop_config.json
Escreva Authorization:Bearer sem espaço depois dos dois-pontos — é assim que a ponte espera.
Adicione isto em ~/.cursor/mcp.json para todos os projetos, ou em .cursor/mcp.json dentro de um projeto só.
{
"mcpServers": {
"gender-api": {
"url": "https://mcp.gender-api.com",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Adicione isto em .vscode/mcp.json no seu projeto, ou no mcp.json do usuário para habilitar em todo lugar.
{
"servers": {
"gender-api": {
"type": "http",
"url": "https://mcp.gender-api.com",
"requestInit": {
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
}
O VS Code usa servers em vez de mcpServers e espera os headers dentro de requestInit. O mesmo formato funciona no Visual Studio e nas IDEs da JetBrains.
Qualquer cliente com suporte a MCP remoto precisa apenas destes três valores:
Endpoint: https://mcp.gender-api.com Transport: streamable-http Header: Authorization: Bearer YOUR_API_TOKEN
Se o seu cliente só aceita servidores MCP locais, use a ponte npx mcp-remote mostrada na aba do Claude Desktop — ela funciona com qualquer cliente que só fale stdio.
Use a Gender-API diretamente dentro de ferramentas de IA
Nosso Servidor MCP permite que ferramentas de IA compatíveis com MCP chamem a Gender-API diretamente. Assim, seu assistente pode enriquecer primeiros nomes, nomes completos, nomes extraídos de e-mails e dados de país de origem por meio de chamadas de ferramenta estruturadas, em vez de depender apenas de instruções no prompt.
Não há nada para instalar nem hospedar: aponte sua ferramenta para https://mcp.gender-api.com e autentique com o mesmo token do Gender-API que você já usa na API.
O que você pode fazer com isso
- Use dados ao vivo da Gender-API: Tua ferramenta de IA pode consultar resultados do Gender-API em tempo real, em vez de inventar formatos de requisição ou respostas.
- Reutilize seu token existente: O servidor MCP funciona com o mesmo token de portador do Gender-API que você já usa na API.
- Conecta clientes compatíveis com MCP: Você pode usar isso no Claude, no Cursor ou nas suas próprias ferramentas e agentes internos compatíveis com MCP que oferecem suporte a URLs de MCP hospedadas.
- Mantenha o faturamento simples: O uso normal de créditos do Gender-API continua valendo, então você não precisa aprender um segundo sistema de cobrança.
Ferramentas compatíveis
Ferramentas MCP incluídas
- query_first_name – Consultar o gênero mais provável pelo primeiro nome.
- query_full_name – Consultar o gênero provável pelo nome completo.
- query_email – Extraia e enriqueça um nome a partir de um endereço de e-mail.
- get_country_of_origin – Descubra os prováveis países de origem.
- get_statistics – Confira seus créditos restantes e as estatísticas da sua conta.
Transporte hospedado
Use o endpoint Streamable HTTP hospedado em https://mcp.gender-api.com e autentique com seu token bearer do Gender-API.
Casos de uso do MCP no mundo real
Enriquecimento de leads dentro de copilotos de IA
Deixa o Claude, o Cursor ou um agente de vendas interno analisar uma lista de leads, chamar o Gender-API via MCP e adicionar prováveis primeiros nomes, gender e contexto do país de origem antes do primeiro contato.
Personalização de CRM e suporte
Teu assistente de suporte pode analisar endereços de e-mail recebidos, extrair nomes próprios prováveis com `query_email` e criar rascunhos de resposta mais naturais e personalizados para os atendentes.
Agentes de limpeza de planilhas e pesquisa
Agentes de limpeza de dados com MCP podem revisar arquivos CSV ou planilhas, padronizar colunas de primeiro nome e enriquecer as linhas com resultados da Gender-API — tudo isso sem precisar criar código de API personalizado em cada fluxo de trabalho.
Automação de marketing e segmentação
Usa o MCP em assistentes de criação de campanhas para gerar saudações, enriquecer os dados dos contatos e conferir os créditos restantes antes de lançar um fluxo de trabalho de personalização.
Está criando seu próprio cliente MCP?
Conectar com o SDK oficial do MCP
Se você está escrevendo seu próprio agente em vez de usar uma ferramenta pronta, conecte o transporte Streamable HTTP direto:
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',
},
},
});
Perguntas Frequentes
Isso usa meus créditos normais do Gender-API?
Sim. O servidor MCP é uma camada de integração leve sobre os endpoints atuais da Gender-API, então as permissões normais do token e o uso de créditos continuam valendo.
Posso usar isso na minha própria ferramenta MCP interna?
Sim. Se sua ferramenta tem suporte a MCP hospedado, conecte-a a https://mcp.gender-api.com e envie seu token bearer do Gender-API.
Preciso instalar alguma coisa?
Não. O servidor MCP é hospedado por nós, então não há nada para baixar nem manter rodando. Clientes que só aceitam servidores MCP locais usam a ponte npx mcp-remote, que se baixa sozinha na primeira execução.
Minha ferramenta de IA não mostra as ferramentas do Gender-API. E agora?
Reinicie a ferramenta depois de editar a configuração e confira se você substituiu o token de exemplo pelo seu token de API real. Se a conexão for recusada, seu token é inválido ou está sem créditos — os dois aparecem como erro de autenticação.
Tem alguma pergunta?
