MCP Server — शुरू करें
एक URL और अपनी API key से Claude, Cursor, VS Code, Codex या किसी भी MCP client को CaptchaSonic से जोड़ें, और किसी भी AI agent से CAPTCHAs हल करें।
CaptchaSonic MCP server किसी भी AI agent को CAPTCHAs हल करने के tools देता है: reCAPTCHA v2/v3, Cloudflare Turnstile और challenge pages, hCaptcha-style PopularCaptcha, GeeTest, MTCaptcha, AWS WAF, TikTok, Binance, OCR और बहुत कुछ। यह Model Context Protocol बोलता है, इसलिए यह Claude Code, Cursor, VS Code, Windsurf, Codex, Gemini CLI और हर अन्य MCP client में काम करता है।
Hosted server (अनुशंसित)
एक URL और अपनी API key चिपकाएँ। कुछ इंस्टॉल नहीं करना, हमेशा अद्यतन।
Locally चलाएँ
केवल local servers समर्थित करने वाले clients के लिए। npx से चलता है। देखें Run locally।
Server URL
https://mcp.captchasonic.com
अपनी CaptchaSonic API key को bearer token के रूप में उपयोग करके प्रमाणित करें:
Authorization: Bearer sonic_xxx
NOTE
यह आपके MCP client के लिए server URL है, browser में खोलने वाला पृष्ठ नहीं। अपनी API key dashboard से प्राप्त करें। हल किए गए solves उसी key पर सीधे API calls की तरह बिल होते हैं, और विफल solves का पैसा वापस मिलता है।
Client सेटअप
sonic_xxx को अपनी API key से बदलें।
claude mcp add --transport http captchasonic https://mcp.captchasonic.com \
--header "Authorization: Bearer sonic_xxx"
~/.cursor/mcp.json में जोड़ें (या Settings → MCP → Add server):
{
"mcpServers": {
"captchasonic": {
"url": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer sonic_xxx" }
}
}
}
.vscode/mcp.json में जोड़ें। VS Code एक बार key माँगता है और उसे सुरक्षित रूप से संग्रहीत करता है:
{
"servers": {
"captchasonic": {
"type": "http",
"url": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer ${input:captchasonic-key}" }
}
},
"inputs": [
{ "type": "promptString", "id": "captchasonic-key", "description": "CaptchaSonic API key", "password": true }
]
}
~/.codeium/windsurf/mcp_config.json में जोड़ें:
{
"mcpServers": {
"captchasonic": {
"serverUrl": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer sonic_xxx" }
}
}
}
~/.codex/config.toml में जोड़ें और अपने shell में CAPTCHASONIC_API_KEY export करें:
[mcp_servers.captchasonic]
url = "https://mcp.captchasonic.com"
bearer_token_env_var = "CAPTCHASONIC_API_KEY"
~/.gemini/settings.json में जोड़ें:
{
"mcpServers": {
"captchasonic": {
"httpUrl": "https://mcp.captchasonic.com",
"headers": { "Authorization": "Bearer sonic_xxx" }
}
}
}
Claude Desktop के custom connectors API key header नहीं भेज सकते, इसलिए local server का उपयोग करें। claude_desktop_config.json में जोड़ें (Settings → Developer → Edit Config):
{
"mcpServers": {
"captchasonic": {
"command": "npx",
"args": ["-y", "@captchasonic/mcp-server"],
"env": { "SONIC_API_KEY": "sonic_xxx" }
}
}
}
कोई अन्य client: ऊपर दिए URL को Streamable HTTP transport और Authorization: Bearer header के साथ उपयोग करें। यदि client केवल local (stdio) servers समर्थित करता है, तो Run locally देखें।
जाँचें कि यह काम करता है
अपने agent से पूछें:
Check my CaptchaSonic balance.
वह get_balance को कॉल करता है और आपका बैलेंस लौटाता है। यदि आपको ERROR_KEY_DOES_NOT_EXIST दिखे, तो आपकी config की key गलत है या रद्द हो चुकी है।
आपका agent क्या कर सकता है
| Tool | किसलिए उपयोग करें |
|---|---|
solve_token_captcha | reCAPTCHA v2/v3, Turnstile, Cloudflare challenge, PopularCaptcha, GeeTest, MTCaptcha। Form के साथ सबमिट करने के लिए token लौटाता है। |
solve_image_captcha | Image grids, sliders, click challenges, OCR text और audio। तुरंत answer लौटाता है। |
get_task_result | वह token प्राप्त करें जो अभी भी हल हो रहा है। |
get_balance | Wallet balance और plan limits। |
list_captcha_types | हर समर्थित type उसके आवश्यक fields के साथ। |
पूरे parameters और answer formats: Tools reference। किसी agent को यह स्वयं करने के लिए सेट अप करना: For agents।