2CaptchaMCP

A Model Context Protocol (MCP) server implementation that integrates with 2Captcha to provide robust CAPTCHA solving capabilities for AI agents.

Features

• Balance Check: Monitor your 2Captcha account balance.
• Image Captcha: Solve traditional image-based CAPTCHAs (file, base64, or HTML).
• reCAPTCHA v2: Solve reCAPTCHA v2 and Enterprise versions.
• hCaptcha: Solve hCaptcha widgets.
• Cloudflare Turnstile: Solve Cloudflare's invisible challenge.
• Arkose Labs (FunCaptcha): Solve FunCaptcha/Arkose challenges.
• GeeTest: Solve GeeTest v3 challenges.

Installation

Running with npx

You can run the server directly using npx:

env TWOCAPTCHA_API_KEY=YOUR_API_KEY_HERE npx -y 2captcha-mcp

Note for Windows users: If you encounter issues with environment variables, try: cmd /c "set TWOCAPTCHA_API_KEY=YOUR_API_KEY_HERE && npx -y 2captcha-mcp"

Configuration

Environment Variables

• TWOCAPTCHA_API_KEY (Required): Your 2Captcha API key. You can find this in your 2Captcha Dashboard.

Usage with Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "2captcha-mcp": {
      "command": "npx",
      "args": ["-y", "2captcha-mcp"],
      "env": {
        "TWOCAPTCHA_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Available Tools

1. Balance Check (get_balance)

Check your current 2Captcha account balance.

Prompt Example:

"How much balance do I have left on 2Captcha?"

---

2. Solve Image Captcha (solve_image)

Solve an image-based CAPTCHA. Supports local file paths, base64 strings, or HTML snippets containing <img> tags.

Arguments:

• body: The image source (path, base64, or HTML).
• numeric: 0=default, 1=only digits, 2=only letters, 3=either, 4=both (optional).
• min_len / max_len: Length constraints (optional).

Prompt Example:

"Solve this captcha image: "

---

3. Solve reCAPTCHA v2 (solve_recaptcha_v2)

Solve reCAPTCHA v2 or Enterprise.

Arguments:

• pageurl: The URL of the page where the captcha is located.
• googlekey: The sitekey (data-sitekey).
• enterprise: Set to true for enterprise version.
• invisible: Set to true for invisible version.

---

4. Solve hCaptcha (solve_hcaptcha)

Solve hCaptcha widgets.

Arguments:

• pageurl: The URL of the page.
• sitekey: The hCaptcha sitekey.

---

5. Solve Turnstile (solve_turnstile)

Solve Cloudflare Turnstile challenges.

Arguments:

• pageurl: The URL of the page.
• sitekey: The Turnstile sitekey.

---

6. Solve Arkose/FunCaptcha (solve_arkose)

Solve Arkose Labs/FunCaptcha challenges.

Arguments:

• pageurl: The URL of the page.
• publickey: The Arkose public key.

---

7. Solve GeeTest (solve_geetest)

Solve GeeTest v3 challenges.

Arguments:

• pageurl: The URL of the page.
• gt: The GeeTest gt value.
• challenge: The GeeTest challenge value.