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](https://modelcontextprotocol.io) बोलता है, इसलिए यह Claude Code, Cursor, VS Code, Windsurf, Codex, Gemini CLI और हर अन्य MCP client में काम करता है।

  
    एक URL और अपनी API key चिपकाएँ। कुछ इंस्टॉल नहीं करना, हमेशा अद्यतन।
  
  
    केवल local servers समर्थित करने वाले clients के लिए। `npx` से चलता है। देखें [Run locally](/docs/mcp/run-locally)।
  

## Server URL

```text
https://mcp.captchasonic.com
```

अपनी CaptchaSonic API key को bearer token के रूप में उपयोग करके प्रमाणित करें:

```text
Authorization: Bearer sonic_xxx
```

> [!NOTE]
> यह आपके MCP client के लिए server URL है, browser में खोलने वाला पृष्ठ नहीं। अपनी API key [dashboard](https://my.captchasonic.com) से प्राप्त करें। हल किए गए solves उसी key पर सीधे API calls की तरह बिल होते हैं, और विफल solves का पैसा वापस मिलता है।

## Client सेटअप

`sonic_xxx` को अपनी API key से बदलें।

<LangTabs>
  <LangTabs.Tab label="Claude Code">

```bash
claude mcp add --transport http captchasonic https://mcp.captchasonic.com \
  --header "Authorization: Bearer sonic_xxx"
```

  </LangTabs.Tab>
  <LangTabs.Tab label="Cursor">

`~/.cursor/mcp.json` में जोड़ें (या **Settings → MCP → Add server**):

```json
{
  "mcpServers": {
    "captchasonic": {
      "url": "https://mcp.captchasonic.com",
      "headers": { "Authorization": "Bearer sonic_xxx" }
    }
  }
}
```

  </LangTabs.Tab>
  <LangTabs.Tab label="VS Code">

`.vscode/mcp.json` में जोड़ें। VS Code एक बार key माँगता है और उसे सुरक्षित रूप से संग्रहीत करता है:

```json
{
  "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 }
  ]
}
```

  </LangTabs.Tab>
  <LangTabs.Tab label="Windsurf">

`~/.codeium/windsurf/mcp_config.json` में जोड़ें:

```json
{
  "mcpServers": {
    "captchasonic": {
      "serverUrl": "https://mcp.captchasonic.com",
      "headers": { "Authorization": "Bearer sonic_xxx" }
    }
  }
}
```

  </LangTabs.Tab>
  <LangTabs.Tab label="Codex">

`~/.codex/config.toml` में जोड़ें और अपने shell में `CAPTCHASONIC_API_KEY` export करें:

```toml
[mcp_servers.captchasonic]
url = "https://mcp.captchasonic.com"
bearer_token_env_var = "CAPTCHASONIC_API_KEY"
```

  </LangTabs.Tab>
  <LangTabs.Tab label="Gemini CLI">

`~/.gemini/settings.json` में जोड़ें:

```json
{
  "mcpServers": {
    "captchasonic": {
      "httpUrl": "https://mcp.captchasonic.com",
      "headers": { "Authorization": "Bearer sonic_xxx" }
    }
  }
}
```

  </LangTabs.Tab>
  <LangTabs.Tab label="Claude Desktop">

Claude Desktop के custom connectors API key header नहीं भेज सकते, इसलिए local server का उपयोग करें। `claude_desktop_config.json` में जोड़ें (**Settings → Developer → Edit Config**):

```json
{
  "mcpServers": {
    "captchasonic": {
      "command": "npx",
      "args": ["-y", "@captchasonic/mcp-server"],
      "env": { "SONIC_API_KEY": "sonic_xxx" }
    }
  }
}
```

  </LangTabs.Tab>
</LangTabs>

कोई अन्य client: ऊपर दिए URL को Streamable HTTP transport और `Authorization: Bearer` header के साथ उपयोग करें। यदि client केवल local (stdio) servers समर्थित करता है, तो [Run locally](/docs/mcp/run-locally) देखें।

## जाँचें कि यह काम करता है

अपने agent से पूछें:

```text
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](/docs/mcp/tools)। किसी agent को यह स्वयं करने के लिए सेट अप करना: [For agents](/docs/mcp/for-agents)।
