MCP के ज़रिए AI एजेंट कनेक्ट करें

अपना क्लाइंट चुनें

एंडपॉइंट: https://mcp.fairvalid.com/mcp। ट्रांसपोर्ट: Streamable HTTP।

API कुंजी या OAuth साइन-इन से कनेक्ट करें। योग्य ChatGPT, Claude और Grok कनेक्शन OAuth का उपयोग कर सकते हैं; अपने क्लाइंट के खाते और भूमिका संबंधी आवश्यकताएँ नीचे देखें। Codex, Claude Code और Hermes सीधे API-कुंजी कनेक्शन का भी समर्थन करते हैं।

API-कुंजी क्लाइंट के लिए, वर्कस्पेस Owner या Manager के रूप में API कुंजियाँ में एक लेबल वाली Test कुंजी बनाएँ। इसे क्लाइंट की सुरक्षित क्रेडेंशियल्स या दस्तावेज़ित एनवायरनमेंट सेटिंग्स में सहेजें। किसी कुंजी को कभी भी प्रॉम्प्ट, टूल आर्ग्युमेंट, URL या कमिट किए गए कॉन्फ़िगरेशन में न डालें।

OAuth प्रक्रिया साइन-इन और सहमति के लिए fairvalid.com खोलती है। आप एक मौजूदा Live API कुंजी चुनते हैं जो अनुरोधित अनुमतियों को कवर करती हो, और उसके वर्कस्पेस तथा आजीवन सीमा की समीक्षा करते हैं। स्वीकृति देने पर अनुरोधित अनुमतियाँ एक साथ, उस कुंजी के स्कोप के भीतर, प्रदान की जाती हैं। इसमें आपसे वह कुंजी AI क्लाइंट में पेस्ट करने को नहीं कहा जाता। चुनी गई कुंजी को रद्द करने से उसके कनेक्शन भी समाप्त हो जाते हैं। OAuth लाइव कुंजियों का उपयोग करता है; सैंडबॉक्स के लिए सीधे Test-कुंजी कनेक्शन का उपयोग करें।

क्लाइंट निर्देशों की समीक्षा 23 अक्टूबर 2026 को की गई। होस्ट किए गए MCP प्रोटोकॉल ने आधिकारिक SDK के साथ प्रोडक्शन स्वीकृति परीक्षण पास किया है। इसका अर्थ यह नहीं कि हर नामित क्लाइंट का परीक्षण हुआ है; इस पर निर्भर होने से पहले अपने क्लाइंट में कनेक्शन जाँच पूरी करें।

ChatGPT

नीचे दिए OAuth सेटअप का उपयोग करें। मौजूदा कस्टम MCP कनेक्शन के लिए वेब पर ChatGPT Business या Enterprise/Edu और MCP के साथ प्लगइन बनाने की अनुमति आवश्यक है। Business के लिए एडमिन या ओनर आवश्यक है; Enterprise/Edu चुने हुए सदस्यों को अधिकृत कर सकता है।

1. Plugins खोलें, प्लस बटन चुनें, फिर Add custom MCP server चुनें। मौजूदा Plugins प्रक्रिया के लिए Developer Mode की ज़रूरत नहीं है।
2. कनेक्शन का नाम FairValid रखें और सार्वजनिक HTTPS एंडपॉइंट के रूप में https://mcp.fairvalid.com/mcp दर्ज करें।
3. स्वचालित क्लाइंट पंजीकरण के साथ OAuth चुनें। FairValid सार्वजनिक क्लाइंट पंजीकरण का उपयोग करता है: आपको क्लाइंट ID या क्लाइंट सीक्रेट देने की आवश्यकता नहीं है। किसी भी फ़ील्ड में कभी API कुंजी दर्ज न करें।
4. ऊपर बताए अनुसार FairValid साइन-इन और सहमति पूरी करें। ChatGPT की चेतावनी की समीक्षा करें, फिर Create as a plugin चुनें और खोजे गए छह टूल की जाँच करें।
5. प्लगइन इंस्टॉल करें, नई बातचीत खोलें, @ टाइप करें और FairValid चुनें। लाइव सत्यापन का अनुरोध करने से पहले नीचे दी गई केवल-पढ़ने वाली कनेक्शन जाँच चलाएँ।

आधिकारिक दस्तावेज़: OpenAI: कस्टम MCP सर्वर कनेक्ट करें · OpenAI: OAuth प्रमाणीकरण

Claude वेब और डेस्कटॉप

OAuth के साथ रिमोट कस्टम कनेक्टर का उपयोग करें। यह Claude वेब और Desktop पर एक ही खाता-आधारित कनेक्शन है; यह Anthropic के सर्वरों के माध्यम से चलता है। Team और Enterprise पर, संगठन का Owner पहले कनेक्टर जोड़ता है। संगठन लाइब्रेरी प्रबंधित करने वाली कस्टम भूमिका वाले Enterprise सदस्य भी इसे जोड़ सकते हैं।

Some organizations have a Request headers beta. For that alternative, choose No sign-in and add a required Authorization header with the full value Bearer <your FairValid API key>. If Request headers is absent, use OAuth or the Claude Code instructions below. The API key is not an OAuth client secret.

1. Customize → Connectors → Add custom connector खोलें। प्रबंधित संगठन के लिए, मालिक या योग्य Enterprise भूमिका वाला व्यक्ति Organization settings → Connectors → Add → Custom → Web से शुरू करता है।
2. FairValid और https://mcp.fairvalid.com/mcp दर्ज करें।
3. Sign in now चुनें। यदि OAuth क्लाइंट का विकल्प दिखे, तो Register automatically चुनें। मैन्युअल रूप से पंजीकृत क्लाइंट ID और सीक्रेट फ़ील्ड खाली छोड़ दें।
4. fairvalid.com पर साइन इन करें, चुनी गई लाइव कुंजी और अनुमतियाँ देखें, और कनेक्शन स्वीकृत करें। बातचीत के कनेक्टर नियंत्रणों से FairValid चालू करें।
5. नीचे दी गई केवल-पढ़ने वाली कनेक्शन जाँच चलाएँ। सैंडबॉक्स जाँच का उपयोग केवल तभी करें जब आपने Request headers के ज़रिए Test API कुंजी से कनेक्ट किया हो।

आधिकारिक दस्तावेज़: Anthropic: कस्टम कनेक्टर और प्रमाणीकरण · Anthropic: रिमोट कनेक्टर की उपलब्धता

Claude Code

Claude Code सीधे API-कुंजी कनेक्शन का समर्थन करता है। पहली जाँच के लिए Test कुंजी का उपयोग करते हुए, Claude Code को लॉन्च करने वाले एनवायरनमेंट में FAIRVALID_API_KEY सेट करें। वास्तविक सीक्रेट को प्रोजेक्ट फ़ाइलों से बाहर रखें।

1. नीचे दिए गए कॉन्फ़िगरेशन को प्रोजेक्ट की .mcp.json फ़ाइल में मर्ज करें। मौजूदा सर्वर बनाए रखें। फ़ाइल में केवल environment reference ही लिखा जाना चाहिए; कुंजी का मान नहीं।
2. FAIRVALID_API_KEY उपलब्ध रखते हुए Claude Code लॉन्च करें। अनुरोध किए जाने पर प्रोजेक्ट का MCP कॉन्फ़िगरेशन स्वीकृत करें।
3. claude mcp list चलाएँ, फिर सत्र में /mcp देखें। पुष्टि करें कि FairValid कनेक्ट होता है और छह टूल उपलब्ध कराता है, फिर नीचे दी गई सैंडबॉक्स जाँच करें।

{
  "mcpServers": {
    "fairvalid": {
      "type": "http",
      "url": "https://mcp.fairvalid.com/mcp",
      "headers": {
        "Authorization": "Bearer ${FAIRVALID_API_KEY}"
      }
    }
  }
}

आधिकारिक दस्तावेज़: Anthropic: Claude Code MCP कॉन्फ़िगरेशन

Hermes Agent

ये निर्देश NousResearch Hermes Agent के लिए हैं। इसका रिमोट HTTP ट्रांसपोर्ट bearer हेडर का समर्थन करता है। CLI कुंजी को आपकी सक्रिय प्रोफ़ाइल की .env फ़ाइल में MCP_FAIRVALID_API_KEY के रूप में संग्रहीत करता है और config.yaml में एक एनवायरनमेंट संदर्भ रखता है।

1. नीचे दिया गया add कमांड चलाएँ। प्रमाणीकरण आवश्यक है या नहीं, यह पूछे जाने पर हाँ चुनें, फिर मास्क किए गए API key / Bearer token प्रॉम्प्ट में एक Test API कुंजी दर्ज करें।
2. खोजे गए टूल की समीक्षा करें और अपनी ज़रूरत के FairValid टूल सक्षम करें। सेटअप का सफलतापूर्वक कनेक्ट होना ज़रूरी है; किसी त्रुटि के बाद अक्षम कनेक्शन को सहेजना सफल सेटअप नहीं माना जाता।
3. hermes mcp test fairvalid चलाएँ, फिर नया सत्र शुरू करें या /reload-mcp चलाएँ। नीचे दी गई सैंडबॉक्स जाँच करें। Hermes टूल के नामों में अपने सर्वर-नाम का प्रीफ़िक्स जोड़ सकता है।

hermes mcp add fairvalid \
  --url https://mcp.fairvalid.com/mcp \
  --auth header

hermes mcp test fairvalid

आधिकारिक दस्तावेज़: NousResearch: MCP कॉन्फ़िगरेशन · NousResearch: MCP कनेक्शन जाँचें · NousResearch: header-auth CLI इम्प्लीमेंटेशन

Grok Bot और Grok

Grok Bot और Grok.com में सेटअप की जगहें अलग-अलग हैं। अपने निजी Grok Bot में, नीचे दिए गए अनुरोध से Bot को FairValid जोड़ने के लिए कहें। यह तरीका तब भी काम करता है जब जानकारी पैनल में केवल Details, Library और Computer दिखें और कोई Setup सेक्शन न हो।

Team Bots इसके अतिरिक्त Bot के मालिक या प्रबंधकों को info pane → Setup → Plugins दिखाते हैं। इस सेटअप के लिए डेस्कटॉप ऐप में Team Bot एक्सेस आवश्यक है। OAuth का उपयोग होने पर हर साथी अपने खाते से साइन इन करता है।

Grok.com में grok.com/connectors → New Connector → Custom पर जाएँ। https://mcp.fairvalid.com/mcp दर्ज करें और प्रमाणीकरण पूरा करें। Business और Enterprise टीमों में पहले उनके एडमिनिस्ट्रेटर को कनेक्टर उपलब्ध कराना पड़ सकता है। यह Grok Bot प्लगइन से अलग कनेक्शन है।

xAI API से बनाया गया बॉट भी अलग है: उसका डेवलपर सर्वर कोड में रिमोट MCP हेडर कॉन्फ़िगर करता है। ये निर्देश यह दावा नहीं करते कि Grok Bot कोई सामान्य Authorization-हेडर फ़ील्ड प्रदान करता है।

1. नीचे दिए गए अनुरोध का उपयोग करके अपने Bot से कस्टम Remote HTTPS MCP कनेक्शन जोड़ने को कहें। Team Bot के लिए, उसका मालिक या मैनेजर Setup → Plugins का भी उपयोग कर सकता है।
2. When the Bot shows the FairValid authorization card, select Authorize to open OAuth sign-in. Keep API keys out of the request and any server command.
3. fairvalid.com पर FairValid सहमति पूरी करें। जहाँ आवश्यक हो, हर टीम सदस्य अपना खाता स्वयं कनेक्ट करता है।
4. Bot से FairValid के टूल की सूची बनाने और नीचे दी गई केवल-पढ़ने वाली कनेक्शन जाँच चलाने को कहें। केवल टूल मिल जाने से यह साबित नहीं होता कि कोई वेरिफ़िकेशन पूरा हुआ।

Add FairValid as a custom Remote HTTPS MCP server at
https://mcp.fairvalid.com/mcp using OAuth.
Show me the sign-in flow, then list its tools.
Do not submit any email verification yet.

आधिकारिक दस्तावेज़: xAI: Grok Bot प्लगइन और Remote HTTPS · xAI: Grok.com कस्टम कनेक्टर · xAI: API डेवलपर्स के लिए रिमोट MCP

Codex

Codex से सीधे API-कुंजी कनेक्शन का उपयोग करें। Codex प्रोसेस के लिए उपलब्ध एनवायरनमेंट में FAIRVALID_API_KEY सेट करें और अपनी पहली जाँच के लिए Test कुंजी का उपयोग करें। अलग से लॉन्च किया गया डेस्कटॉप ऐप शायद आपके टर्मिनल का एनवायरनमेंट इनहेरिट न करे।

1. रिमोट Streamable HTTP सर्वर को रजिस्टर करने के लिए नीचे दिया गया कमांड चलाएँ। यह कमांड API कुंजी नहीं, बल्कि एनवायरनमेंट वेरिएबल का नाम संग्रहीत करता है।
2. codex mcp list चलाएँ और एक नया Codex सत्र शुरू करें ताकि वह कनेक्शन लोड कर सके। पुष्टि करें कि FairValid सत्र के MCP टूल में दिखाई देता है।
3. अगर आप Codex ऐप का उपयोग कर रहे हैं, तो वेरिएबल को उसके एक्ज़ीक्यूशन होस्ट पर उपलब्ध कराएँ और ज़रूरत के अनुसार ऐप रीस्टार्ट करें या नया सेशन खोलें। यह न मानें कि CLI सेटअप सफल होने से पहले से चल रहे ऐप का एनवायरनमेंट बदल गया है।
4. खोजे गए छह टूल की पुष्टि करें और नीचे दी गई सैंडबॉक्स जाँच करें।

codex mcp add fairvalid \
  --url https://mcp.fairvalid.com/mcp \
  --bearer-token-env-var FAIRVALID_API_KEY

codex mcp list

आधिकारिक दस्तावेज़: OpenAI: Codex MCP कॉन्फ़िगरेशन

काम सबमिट करने से पहले कनेक्शन जाँचें

नीचे सूचीबद्ध सभी छह टूल के खोजे जाने की पुष्टि करें। कोई क्लाइंट टूल के नामों में अपना उपसर्ग जोड़ सकता है। खोज से कनेक्शन की पुष्टि होती है, सफल सत्यापन की नहीं।

OAuth या Live API key के साथ, बैलेंस की अनुमति दें और सबसे पहले एजेंट से बिना किसी आर्ग्युमेंट के fairvalid_get_balance कॉल करने को कहें। बैलेंस पढ़ने में कोई सत्यापन क्रेडिट इस्तेमाल नहीं होता। sandbox उदाहरणों को लाइव कनेक्शन से सबमिट न करें।

Test API key के साथ, इसके बजाय नीचे दी गई sandbox जाँच का पालन करें। लाइव सत्यापन क्रेडिट आरक्षित और खर्च कर सकता है; ऐसा पता चुनें जिसे जाँचने के लिए आप अधिकृत हैं और सबमिशन का स्पष्ट रूप से अनुरोध करें।

अगर कनेक्शन विफल हो, तो खाते की कनेक्टर अनुमतियाँ, एंडपॉइंट, छूटे हुए एनवायरनमेंट वेरिएबल, और की या ग्रांट का रद्द होना जाँचें। अनुमति या खर्च-सीमा से जुड़ी त्रुटियों के लिए, दोबारा कोशिश करने से पहले दिए गए स्कोप या सीमा की समीक्षा करें; नई idempotency key से कारण ठीक नहीं होता।

मुफ़्त सैंडबॉक्स जाँच से शुरू करें

fv_test_ कुंजी का उपयोग करें और नीचे दिए उदाहरण के साथ fairvalid_verify_email कॉल करें। टेस्ट-कुंजी से एकल-पते की जाँच सीधे एक सिमुलेटेड परिणाम लौटाती है। इसमें कोई प्रदाता कॉल नहीं होती, कोई लाइव सत्यापन नहीं बनता और कोई क्रेडिट उपयोग नहीं होता।

अन्य आरक्षित उदाहरण हैं undeliverable@example.com, risky@example.com, unknown@example.com, pending@example.com और error@example.com। Pending और error जानबूझकर किए गए सिमुलेशन हैं, असली मेलबॉक्स जाँच नहीं। एकल-पते वाले pending उदाहरण में पोल करने के लिए कोई जॉब नहीं होता।

{
  "email": "deliverable@example.com",
  "idempotency_key": "agent-demo-2026-10-23"
}

टूल और अनुमतियाँ

fairvalid_verify_email, email और idempotency_key लेता है। fairvalid_submit_job, 1 से 5,000 पतों के लिए emails, idempotency_key और एक वैकल्पिक name लेता है। लाइव सबमिशन के लिए submit स्कोप आवश्यक है।

fairvalid_get_job स्थिति पढ़ने के लिए job_id लेता है। fairvalid_get_results, job_id और वैकल्पिक cursor, filter और search लेता है, ताकि एक बार में अधिकतम 50 परिणाम पढ़े जा सकें। लाइव रीड के लिए read स्कोप आवश्यक है।

fairvalid_cancel_job, job_id लेता है और रद्दीकरण का अनुरोध करता है; जो जाँचें चल रही हैं, वे पूरी हो सकती हैं। लाइव रद्दीकरण के लिए submit स्कोप आवश्यक है। fairvalid_get_balance कोई आर्ग्युमेंट नहीं लेता और इसके लिए balance स्कोप वाली लाइव कुंजी आवश्यक है। टेस्ट कुंजियाँ लाइव क्रेडिट बैलेंस नहीं पढ़ सकतीं।

कुंजियाँ ही वर्कस्पेस तय करती हैं। टूल कोई API-कुंजी या वर्कस्पेस आर्ग्युमेंट स्वीकार नहीं करते। स्कोप जाँच, रद्दीकरण, खर्च सीमाएँ और वर्कस्पेस क्रेडिट नियम MCP पर भी ठीक उसी तरह लागू होते हैं जैसे ग्राहक API पर।

किसी लाइव जॉब को उसके परिणामों तक ट्रैक करें

OAuth या fv_live_ key के साथ, एकल और बल्क दोनों सत्यापन एसिंक्रोनस जॉब सबमिट करते हैं। स्वीकृत प्रतिक्रिया और job_id का मतलब है कि काम स्वीकार कर लिया गया है, यह नहीं कि मेलबॉक्स जाँच पूरी हो गई है। प्रोसेसिंग का समय कतार और सत्यापन प्रदाता पर निर्भर करता है।

जॉब फ़्लो के सैंडबॉक्स अभ्यास के लिए, आरक्षित उदाहरण पतों के साथ fairvalid_submit_job कॉल करें। सैंडबॉक्स जॉब बिना प्रोवाइडर कॉल या क्रेडिट उपयोग के स्टेट, परिणाम, रद्दीकरण और रीप्ले का समर्थन करते हैं।

1. स्थिर idempotency_key के साथ एक बार सबमिट करें और लौटाया गया job_id सहेज कर रखें।
2. उस job_id के साथ fairvalid_get_job कॉल करें। पोलिंग अनुरोधों के बीच अंतराल रखें और अस्थायी विफलताओं के दौरान अंतराल बढ़ाएँ।
3. उसी job_id के साथ fairvalid_get_results कॉल करें। हर next_cursor को cursor के रूप में वापस भेजें, जब तक next_cursor null न हो जाए। cursor मूल फ़िल्टर और खोज को बनाए रखता है।
4. जॉब की स्थिति और हर परिणाम, दोनों जाँचें। अज्ञात, कैच-ऑल और अभी-जाँच-में परिणाम इस बात का प्रमाण नहीं हैं कि मेलबॉक्स मान्य है।

डुप्लिकेट काम बनाए बिना फिर से आज़माएँ

दोनों सबमिशन टूल के लिए 8 से 128 अक्षरों, अंकों, बिंदुओं, कोलन, अंडरस्कोर या हाइफ़न वाली idempotency_key ज़रूरी है। अनिश्चित जवाब मिलने पर उसी API कुंजी या OAuth कनेक्शन, idempotency_key और बिना बदले इनपुट के साथ फिर से कोशिश करें। रीप्ले अंतर्निहित API कुंजी तक सीमित है: OAuth एक्सेस टोकन को रोटेट करने से वही पहचान बनी रहती है, लेकिन कोई दूसरी API कुंजी चुनकर दोबारा सबमिट करने से एक और रन बन सकता है। मौजूदा idempotency key के साथ बदला हुआ जॉब पेलोड अस्वीकार कर दिया जाता है। नई idempotency key का उपयोग केवल जानबूझकर नया रन शुरू करने के लिए करें।

परिणाम पढ़ने से पहले isError जाँचें। ग्राहक API तक पहुँचने वाली कॉल में structuredContent के भीतर उसका रिस्पॉन्स और HTTP स्टेटस शामिल होता है; आर्ग्युमेंट-सत्यापन त्रुटियाँ केवल टेक्स्ट सामग्री लौटा सकती हैं। API त्रुटि का code देखें और किसी भी पुनःप्रयास संकेत का पालन करें। टाइमआउट या अस्थायी त्रुटि यह साबित नहीं करती कि मूल सबमिशन नहीं हुआ था।

लाइव कुंजियाँ वर्कस्पेस क्रेडिट खर्च कर सकती हैं। किसी स्वायत्त एजेंट को कनेक्ट करने से पहले आजीवन सीमा तय करें: काटे गए और आरक्षित, दोनों क्रेडिट गिने जाते हैं। पूर्ण हुई valid और invalid जाँचों में एक क्रेडिट लगता है; unknown, अनसुलझे catch-all और तकनीकी विफलताओं पर सत्यापन की कोई शुद्ध क्रेडिट कटौती नहीं होती।