Server MCP in hosting
Usa Gender-API direttamente negli strumenti di intelligenza artificiale
Il nostro Server MCP permette agli strumenti di IA compatibili con MCP di chiamare Gender-API direttamente. Questo significa che il tuo assistente può arricchire nomi, nomi completi, nomi ricavati dalle email e dati sul paese di origine tramite chiamate a strumenti strutturate, invece di affidarsi solo alle istruzioni nel prompt.
The easiest setup is the hosted Streamable HTTP endpoint at https://mcp.gender-api.com.
I clienti si collegano direttamente all’endpoint MCP ospitato e si autenticano con lo stesso bearer token di Gender-API che usano già per l’API.
Cosa puoi farci con questo
- Usa i dati live di Gender-API: Il tuo strumento di IA può interrogare i risultati live di Gender-API invece di inventare formati di richiesta o risposte.
- Riutilizza il tuo token esistente: Il server MCP funziona con lo stesso bearer token di Gender-API che già usi per l’API.
- Collega client compatibili con MCP: Puoi usarlo in Claude, Cursor o nei tuoi strumenti e agenti interni compatibili con MCP che supportano URL MCP ospitati.
- Mantieni la fatturazione semplice: Si applica comunque il normale utilizzo dei crediti di Gender-API, quindi non c’è nessun secondo sistema di fatturazione da imparare.
Strumenti supportati
Strumenti MCP inclusi
- query_first_name – Interroga il genere probabile in base al nome.
- query_full_name – Interroga il gender probabile in base al nome completo.
- query_email – Estrai e arricchisci un nome da un indirizzo email.
- get_country_of_origin – Ottieni i probabili paesi di origine.
- get_statistics – Controlla i crediti rimanenti e le statistiche dell’account.
Trasporto ospitato
Use the hosted Streamable HTTP endpoint at https://mcp.gender-api.com and authenticate with your existing Gender-API bearer token.
Casi d’uso MCP nel mondo reale
Arricchimento dei lead all’interno dei copiloti AI
Lascia che Claude, Cursor o un agente di vendita interno analizzi un elenco di lead, interroghi Gender-API tramite MCP e aggiunga probabili nomi di battesimo, gender e contesto sul paese d’origine prima di contattarli.
Personalizzazione del CRM e dell’assistenza clienti
Il tuo assistente di supporto può analizzare gli indirizzi email in arrivo, estrarre i nomi propri più probabili con `query_email` e creare bozze di risposta più naturali e personalizzate per i tuoi operatori.
Agenti per la pulizia dei fogli di calcolo e la ricerca
Gli agenti di pulizia dei dati con supporto MCP possono analizzare file CSV o fogli di calcolo, standardizzare le colonne dei nomi (nome di battesimo) e arricchire le righe con i risultati di Gender-API, senza dover scrivere codice API personalizzato in ogni workflow.
Automazione del marketing e segmentazione
Usa MCP negli assistenti per la creazione di campagne per generare saluti, arricchire i dati dei contatti e controllare i crediti rimanenti prima di avviare un flusso di lavoro di personalizzazione.
Come i clienti possono usarlo nei loro strumenti
1. Usa l’endpoint MCP ospitato
Se la tua piattaforma di AI supporta l’MCP remoto, collegala direttamente all’endpoint ospitato qui sotto e autenticati con il tuo normale bearer token di Gender-API.
https://mcp.gender-api.com
2. Autenticati con il tuo token API abituale
L’MCP ospitato usa lo stesso token di Gender-API che usi già per l’API. Invia il token come bearer token negli header della richiesta.
Authorization: Bearer your-api-token
3. Usa gli strumenti Gender-API inclusi
Dopo che la sessione MCP ospitata è stata inizializzata, il tuo client può chiamare gli strumenti integrati di Gender-API per l’arricchimento in tempo reale e i controlli dell’account.
query_first_name query_full_name query_email get_country_of_origin get_statistics
Così l’onboarding resta semplice: un endpoint ospitato, un token bearer e un unico set di strumenti per tutti i client MCP supportati.
Configurazioni di esempio per i client
Esempio di SDK di produzione
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',
},
},
});
Pattern di configurazione del client MCP in produzione
{
"mcpServers": {
"gender-api": {
"transport": "streamable-http",
"url": "https://mcp.gender-api.com",
"headers": {
"Authorization": "Bearer your-api-token"
}
}
}
}
I nomi esatti dei campi variano in base al client, ma ogni configurazione in hosting richiede lo stesso URL MCP e lo stesso header del bearer token.
Domande frequenti
Usa i miei crediti Gender-API normali?
Sì. Il server MCP è un sottile livello di integrazione sopra gli endpoint Gender-API esistenti, quindi si applicano ancora le normali autorizzazioni del token e l’utilizzo dei crediti.
Posso usarlo nel mio tool MCP interno?
Yes. If your tool supports hosted MCP, connect it to https://mcp.gender-api.com and send your Gender-API bearer token.