# 2Captcha MCP Server

A Model Context Protocol (MCP) server implementation that integrates with [2Captcha](https://2captcha.com) 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`:

```bash
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](https://2captcha.com/setting).

### Usage with Claude Desktop

Add the following to your `claude_desktop_config.json`:

```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: <img src='data:image/png;base64,...'>"

---

### 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.