एक मिनट में सेट अप करो

अपना API टोकन अपनी अकाउंट सेटिंग्स से कॉपी करो।
नीचे से अपना टूल चुनो और स्निपेट पेस्ट करो, टोकन प्लेसहोल्डर की जगह अपना टोकन डालो।
अपना AI टूल रीस्टार्ट करो और उससे कुछ ऐसा पूछो: “इटली में Andrea नाम का लिंग क्या होने की संभावना है?”

टर्मिनल में यह एक कमांड चलाओ — पूरा सेटअप बस इतना ही है।

claude mcp add --transport http --header "Authorization: Bearer YOUR_API_TOKEN" gender-api https://mcp.gender-api.com

Gender-API को सिर्फ़ मौजूदा प्रोजेक्ट के बजाय अपने सभी प्रोजेक्ट्स में उपलब्ध कराने के लिए --scope user जोड़ो।

Claude Desktop एक छोटे npm ब्रिज से जुड़ता है, जो अपने आप डाउनलोड हो जाता है। इसे अपनी कॉन्फ़िग फ़ाइल में जोड़ो — मैन्युअल इंस्टॉल की ज़रूरत नहीं।

{
  "mcpServers": {
    "gender-api": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.gender-api.com",
        "--header",
        "Authorization:Bearer YOUR_API_TOKEN"
      ]
    }
  }
}

कॉन्फ़िग फ़ाइल का स्थान:

macOS ~/Library/Application Support/Claude/claude_desktop_config.json
Windows %APPDATA%\Claude\claude_desktop_config.json

Authorization:Bearer को कोलन के बाद बिना स्पेस लिखो — ब्रिज इसी रूप की अपेक्षा करता है।

सभी प्रोजेक्ट्स के लिए इसे ~/.cursor/mcp.json में जोड़ो, या किसी एक प्रोजेक्ट के अंदर .cursor/mcp.json में।

{
  "mcpServers": {
    "gender-api": {
      "url": "https://mcp.gender-api.com",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

इसे अपने प्रोजेक्ट की .vscode/mcp.json में जोड़ो, या हर जगह चालू करने के लिए यूज़र-स्तर की mcp.json में।

{
  "servers": {
    "gender-api": {
      "type": "http",
      "url": "https://mcp.gender-api.com",
      "requestInit": {
        "headers": {
          "Authorization": "Bearer YOUR_API_TOKEN"
        }
      }
    }
  }
}

VS Code mcpServers की जगह servers इस्तेमाल करता है और हेडर requestInit के अंदर चाहता है। यही ढाँचा Visual Studio और JetBrains IDEs में भी काम करता है।

रिमोट MCP सपोर्ट करने वाले किसी भी क्लाइंट को सिर्फ़ ये तीन वैल्यू चाहिए:

Endpoint:  https://mcp.gender-api.com
Transport: streamable-http
Header:    Authorization: Bearer YOUR_API_TOKEN

अगर तुम्हारा क्लाइंट सिर्फ़ लोकल MCP सर्वर सपोर्ट करता है, तो Claude Desktop टैब में दिखाया गया npx mcp-remote ब्रिज इस्तेमाल करो — यह सिर्फ़ stdio वाले हर क्लाइंट के साथ काम करता है।

AI टूल्स के अंदर सीधे Gender-API का इस्तेमाल करो

हमारा MCP Server MCP‑compatible AI टूल्स को Gender‑API को सीधे कॉल करने देता है। इसका मतलब है कि तुम्हारा असिस्टेंट सिर्फ़ प्रॉम्प्ट‑आधारित निर्देशों पर निर्भर रहने के बजाय, structured tool calls के ज़रिए first names, full names, email से निकले नाम, और country‑of‑origin डेटा को आसानी से enrich कर सकता है।

कुछ इंस्टॉल करने या होस्ट करने की ज़रूरत नहीं: अपने टूल को https://mcp.gender-api.com पर पॉइंट करो और उसी Gender-API टोकन से प्रमाणित करो जो तुम API के लिए पहले से इस्तेमाल करते हो।

ग्राहक इससे क्या कर सकते हैं

लाइव Gender-API डेटा का इस्तेमाल करो: तुमचं AI टूल विनाकारण रिक्वेस्ट फॉरमॅट्स किंवा रिस्पॉन्सेस बनवण्याऐवजी थेट लाईव्ह Gender-API रिझल्ट्स क्वेरी करू शकतं.
अपना मौजूदा टोकन फिर से इस्तेमाल करो: MCP सर्वर उसी Gender-API bearer token के साथ काम करता है, जो तुम पहले से API के लिए इस्तेमाल कर रहे हो।
MCP-कम्पैटिबल क्लाइंट्स कनेक्ट करो: तू हे Claude, Cursor, किंवा तुझ्या स्वतःच्या MCP-सुसंगत इंटरनल टूल्स आणि एजंट्समध्ये वापरू शकतोस, जे hosted MCP URLs ला सपोर्ट करतात.
बिलिंग को आसान रखो: Normal Gender-API क्रेडिट उपयोग अभी भी लागू होता है, इसलिए सीखने के लिए कोई दूसरा बिलिंग सिस्टम नहीं है।

समर्थित टूल्स

MCP टूल्स शामिल हैं

query_first_name – पहले नाम से संभावित जेंडर पता करें।
query_full_name – पूरा नाम देकर संभावित लिंग (पुरुष/महिला) पता करें।
query_email – ईमेल पते से नाम निकालो और उसे और बेहतर/पूरा करो।
get_country_of_origin – संभावित मूल देश जानो।
get_statistics – बचे हुए क्रेडिट्स और अकाउंट के आँकड़े जाँचो।

होस्टेड ट्रांसपोर्ट

होस्ट किया गया Streamable HTTP एंडपॉइंट https://mcp.gender-api.com पर इस्तेमाल करो और अपने मौजूदा Gender-API बियरर टोकन से प्रमाणित करो।

वास्तविक दुनिया में MCP के उपयोग के उदाहरण

AI कोपायलट्स के अंदर लीड एनरिचमेंट

Claude, Cursor, या तुम्हारा इंटरनल सेल्स एजेंट लीड लिस्ट को देखे, MCP के ज़रिए Gender-API कॉल करे, और आउटरीच से पहले संभावित फर्स्ट नेम, gender, और country-of-origin का कॉन्टेक्स्ट जोड़ दे।

CRM और सपोर्ट पर्सनलाइज़ेशन

तुम्हारा सपोर्ट असिस्टेंट आने वाले ईमेल एड्रेस को जाँच सकता है, `query_email` के साथ संभावित पहला नाम निकाल सकता है, और एजेंट्स के लिए ज़्यादा नैचुरल, पर्सनलाइज़्ड ड्राफ्ट रिप्लाईज़ तैयार कर सकता है।

स्प्रेडशीट की सफाई और रिसर्च एजेंट्स

MCP-सक्षम डेटा-क्लीनिंग एजेंट CSV फ़ाइलों या स्प्रेडशीट्स की समीक्षा कर सकते हैं, पहले-नाम वाले कॉलम्स को एक जैसा (स्टैंडर्ड) बना सकते हैं, और हर वर्कफ़्लो में अलग से कस्टम API कोड लिखे बिना ही Gender-API के नतीजों से हर रो (row) को एनरिच कर सकते हैं।

मार्केटिंग ऑटोमेशन और सेगमेंटेशन

पर्सनलाइज़ेशन वर्कफ़्लो शुरू करने से पहले, campaign-building assistants में MCP का इस्तेमाल करके सल्यूटेशन जनरेट करो, कॉन्टैक्ट डेटा को एनरिच करो, और बचे हुए क्रेडिट्स चेक कर लो।

अपना MCP क्लाइंट बना रहे हो?

आधिकारिक MCP SDK से कनेक्ट करो

अगर तुम कोई तैयार टूल इस्तेमाल करने के बजाय अपना एजेंट लिख रहे हो, तो 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',
    },
  },
});

अक्सर पूछे जाने वाले प्रश्न

01

क्या इससे मेरे सामान्य Gender-API क्रेडिट्स इस्तेमाल होंगे?

हाँ। MCP सर्वर मौजूदा Gender-API एंडपॉइंट्स के ऊपर एक हल्की इंटीग्रेशन लेयर है, इसलिए सामान्य टोकन परमिशन और क्रेडिट उपयोग के नियम यहाँ भी लागू रहते हैं।

02

क्या मैं इसे अपने ही इंटरनल MCP टूल में इस्तेमाल कर सकता/सकती हूँ?

हाँ। अगर तुम्हारा टूल होस्टेड MCP सपोर्ट करता है, तो उसे https://mcp.gender-api.com से जोड़ो और अपना Gender-API बियरर टोकन भेजो।

03

क्या मुझे कुछ इंस्टॉल करना होगा?

नहीं। MCP सर्वर हम होस्ट करते हैं, इसलिए डाउनलोड करने या चलाते रहने के लिए कुछ नहीं है। जो क्लाइंट सिर्फ़ लोकल MCP सर्वर सपोर्ट करते हैं, वे npx mcp-remote ब्रिज इस्तेमाल करते हैं, जो पहली बार शुरू होने पर खुद डाउनलोड हो जाता है।

04

मेरा AI टूल Gender-API के टूल्स नहीं दिखा रहा। अब क्या करूँ?

कॉन्फ़िग बदलने के बाद टूल रीस्टार्ट करो, और दोबारा जाँच लो कि तुमने टोकन प्लेसहोल्डर की जगह अपना असली API टोकन डाला है। अगर कनेक्शन अस्वीकार हो रहा है, तो तुम्हारा टोकन अमान्य है या उसके क्रेडिट खत्म हैं — दोनों ही प्रमाणीकरण त्रुटि के रूप में दिखते हैं।

होस्टेड MCP सर्वर