2Captcha MCP

Name: 2Captcha MCP
Author: aruxojuyu665

de aruxojuyu665versión 0.6.1i★ 5iSe ejecuta en tu computadora

Nombre en el registroio.github.aruxojuyu665/twocaptcha-mcp

Cómo instalar

What it does

Full 2Captcha API (43 tools) for Claude Code: 31 captcha solvers + management + webhook.

Connects Se ejecuta en tu computadora
Account or key Needs 2Captcha_API_KEY
Category Herramientas para desarrolladores

Instalación

Elige la app de IA que usas y copia la configuración.

Pasó 3/3 revisiones · Funciona en tu computadora

Primero: ¿qué IA usas?

ClaudeWeb · app · móvilChatGPTWebClaude CodeTerminalCursorEditor de códigoVS CodeEditor de códigoOtrasOtras apps

Elige tu app y los pasos aparecen abajo.

Funciona con Claude, pero hay que preparar algo antes

Necesitas una clave de 2Captcha MCP (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

Instala Python (uv)
Una sola vez; sirve para todos los servidores que necesitan Python (uv)
Abrir la página de descarga de Python (uv) ↗
Hecho
Regístrate y crea una clave de 2Captcha MCP
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
Hecho
Abre el archivo de configuración de la app de Claude de escritorio
SettingsDeveloperEdit Config
Hecho

Pega esta configuración y guarda el archivo

{
  "mcpServers": {
    "twocaptcha": {
      "command": "uvx",
      "args": [
        "twocaptcha-mcp"
      ],
      "env": {
        "2Captcha_API_KEY": "your-value"
      }
    }
  }
}

Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

Hecho

Cierra Claude y vuelve a abrirlo
Hecho
Pruébalo
Usa 2Captcha MCP y dime qué puedes hacer por mí; luego muéstrame una cosa
✓ Si Claude dice que está usando 2Captcha MCP o muestra una herramienta de 2Captcha MCP en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar 2Captcha MCP

2Captcha MCP se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar 2Captcha MCP

Pasos para Claude →Necesitas una clave de 2Captcha MCP (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Pasos para Claude Code →Necesitas una clave de 2Captcha MCP (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)
Pasos para Cursor →Necesitas una clave de 2Captcha MCP (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)
Pasos para VS Code →Necesitas una clave de 2Captcha MCP (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)

B · Otros en Herramientas para desarrolladores que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Sentry✓ ChatGPT
Compiler Explorer✓ ChatGPT
GitDiagram✓ ChatGPT

Funciona con Claude Code, pero hay que preparar algo antes

Necesitas una clave de 2Captcha MCP (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)

Instala Python (uv)
Una sola vez; sirve para todos los servidores que necesitan Python (uv)
Abrir la página de descarga de Python (uv) ↗
Hecho
Regístrate y crea una clave de 2Captcha MCP
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
Hecho
Abre la Terminal
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
Hecho
4
Pega este comando y pulsa Enter
```
claude mcp add --scope user twocaptcha --env 2Captcha_API_KEY=your-value -- uvx twocaptcha-mcp
```
Cambia “your-value” por tu clave antes de pulsar Enter
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Hecho
Escribe /mcp en Claude Code
Deberías ver 2Captcha MCP en la lista como conectado
Hecho
Pruébalo
Usa 2Captcha MCP y dime qué puedes hacer por mí; luego muéstrame una cosa
✓ Si Claude Code dice que está usando 2Captcha MCP o muestra una herramienta de 2Captcha MCP en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor, pero hay que preparar algo antes

Necesitas una clave de 2Captcha MCP (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)

Instala Python (uv)
Una sola vez; sirve para todos los servidores que necesitan Python (uv)
Abrir la página de descarga de Python (uv) ↗
Hecho
Regístrate y crea una clave de 2Captcha MCP
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
Hecho
Pulsa este botón para abrir Cursor
Abrir en Cursor
Cursor te pedirá confirmar; pulsa Install
Hecho
Escribe tu clave
En la configuración de 2Captcha MCP, 2Captcha_API_KEY está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Hecho
Abre el chat de IA de Cursor en modo Agent
Hecho
Pruébalo
Usa 2Captcha MCP y dime qué puedes hacer por mí; luego muéstrame una cosa
✓ Si Cursor dice que está usando 2Captcha MCP o muestra una herramienta de 2Captcha MCP en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code, pero hay que preparar algo antes

Necesitas una clave de 2Captcha MCP (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)

Instala Python (uv)
Una sola vez; sirve para todos los servidores que necesitan Python (uv)
Abrir la página de descarga de Python (uv) ↗
Hecho
Regístrate y crea una clave de 2Captcha MCP
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
Hecho
Pulsa este botón para abrir VS Code
Abrir en VS Code
VS Code te pedirá confirmar; pulsa Install
Hecho
Escribe tu clave
En la configuración de 2Captcha MCP, 2Captcha_API_KEY está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Hecho
Abre el chat de IA de VS Code en modo Agent
Hecho
Pruébalo
Usa 2Captcha MCP y dime qué puedes hacer por mí; luego muéstrame una cosa
✓ Si VS Code dice que está usando 2Captcha MCP o muestra una herramienta de 2Captcha MCP en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa 2Captcha MCP💬 Conversación →

Para desarrolladores: comandos de Terminal y configuración JSON

Instalado en tu computadora

Claude Code

claude mcp add --scope user twocaptcha --env 2Captcha_API_KEY=your-value -- uvx twocaptcha-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "twocaptcha": {
      "command": "uvx",
      "args": [
        "twocaptcha-mcp"
      ],
      "env": {
        "2Captcha_API_KEY": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "twocaptcha": {
      "command": "uvx",
      "args": [
        "twocaptcha-mcp"
      ],
      "env": {
        "2Captcha_API_KEY": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "twocaptcha": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "twocaptcha-mcp"
      ],
      "env": {
        "2Captcha_API_KEY": "your-value"
      }
    }
  }
}

Valores que debes completar

2Captcha_API_KEY secreto obligatorio env
2Captcha account API key (https://2captcha.com/setting)

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Estrellas de GitHub i: 5
Descargas por semanai: 20/sem
Licencia i: MIT
Conexión: Se ejecuta en tu computadora
Transporte: stdio
Última versióni: 0.6.1
Categoríai: Herramientas para desarrolladores
Publicado en el registroi: 5 may 2026
Último cambio de códigoi: 20 jul 2026
Creador: aruxojuyu665
Paquetes: pypi: twocaptcha-mcp
Repo: 0-SOFT/2Captcha-MCP
Estado en el registro: Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se ejecutan en tu computadora en

Claude Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Raycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 12 nov 2026

✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub 0-SOFT, dueña del repo
✓ Superada
Sigue en mantenimiento
Último cambio de código: hace 4 meses
✓ Superada
Tiene licencia
Usa MIT
– No aplica
El endpoint responde
Este se ejecuta en tu computadora; no hay endpoint en internet
– No aplica
Inicio de sesión con OAuth
Se ejecuta en tu computadora y usa ajustes locales en su lugar
… Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión con Google para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión con Google para escribir una reseña

Comparado con otros en Herramientas para desarrolladoresi

Más estrellas que el 85% de los otros 5811 servidores de esta categoría
Publicado en el registro más recientemente que el 10% de los otros 5811 servidores de esta categoría
Revisiones básicas iguales o mejores que el 100% de los otros 5811 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro 2Captcha MCP?

Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: 2Captcha_API_KEY

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hace 4 meses, y la última versión (0.6.1) llegó al registro hace 6 meses.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv) en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: REA, GitHub, Serena MCP: the IDE for your agent

Otros de la misma categoría

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

REA

Reverse engineer anything from your terminal or agent with one CLI and MCP server.

de morlutoMuy usado↓ 388,7 mil/sem★ 453,3 milActualizado hoy

Se ejecuta en tu computadora

Instalar

GitHub

Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.

de githubMuy usado★ 34,4 milActualizado hace 9 días

Computadora o nube

Instalar

Serena MCP: the IDE for your agent

A powerful toolkit for coding, providing semantic retrieval and editing capabilities.

de oraiosMuy usado↓ 35,2 mil/sem★ 31,3 milActualizado hace 6 meses

Se ejecuta en tu computadora

Instalar

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

2Captcha MCP

MCP server exposing the full 2Captcha API surface — 31 captcha types, 5 management tools, 3 pingback CRUD tools, 3 webhook event-store tools, and 1 composite solve-and-wait tool (43 tools total) — to Claude Code via stdio.

Built on the official 2captcha-python SDK (AsyncTwoCaptcha), so retry/polling/parsing are handled upstream and every captcha type the SDK supports is available the moment the SDK adds it.

Quick start

pip install twocaptcha-mcp

or for development:

pip install -e ".[dev]"

Create a .env next to the project root:

2Captcha_API_KEY=your_2captcha_key_here

Verify it works:

python -m twocaptcha_mcp           # starts the stdio server (Ctrl+C to stop)

claude mcp add 2captcha -e 2Captcha_API_KEY=your_2captcha_key_here -- python -m twocaptcha_mcp

After a claude restart, prompt the model with:

"Use twocaptcha_balance to check my account."

Configuration

All settings are environment-driven. Aliases in priority order:

Setting	Aliases	Default	Range
API key (required)	`2Captcha_API_KEY`, `TWOCAPTCHA_API_KEY`, `2CAPTCHA_API_KEY`, `API_KEY_2CAPTCHA`	—	—
Server	`TWOCAPTCHA_SERVER`	`2captcha.com`	`2captcha.com`, `rucaptcha.com`
Default timeout	`TWOCAPTCHA_DEFAULT_TIMEOUT`	`120` s	1..600
reCAPTCHA timeout	`TWOCAPTCHA_RECAPTCHA_TIMEOUT`	`600` s	1..1200
Polling interval	`TWOCAPTCHA_POLLING_INTERVAL`	`10` s	1..120
Soft id	`TWOCAPTCHA_SOFT_ID`	`4580`	—
Log level	`TWOCAPTCHA_LOG_LEVEL`	`INFO`	DEBUG/INFO/WARNING/ERROR/CRITICAL
Default pingback URL	`TWOCAPTCHA_DEFAULT_CALLBACK`	_unset_	https URL

Tools

Captcha solvers (31)

Tool	SDK method	Required arguments
`twocaptcha_solve_normal`	`normal`	`file_path` xor `file_base64`
`twocaptcha_solve_text`	`text`	`text`
`twocaptcha_solve_audio`	`audio`	file (xor), `audio_lang`
`twocaptcha_solve_grid`	`grid`	file (xor)
`twocaptcha_solve_canvas`	`canvas`	file (xor)
`twocaptcha_solve_coordinates`	`coordinates`	file (xor)
`twocaptcha_solve_rotate`	`rotate`	`files: list`
`twocaptcha_solve_vkimage`	`vkimage`	`files`, `steps`
`twocaptcha_solve_recaptcha`	`recaptcha`	`sitekey`, `url`, `version`, `enterprise`
`twocaptcha_solve_hcaptcha`	`hcaptcha`	`sitekey`, `url`
`twocaptcha_solve_turnstile`	`turnstile`	`sitekey`, `url` (+ `data`/`pagedata` for CF Challenge)
`twocaptcha_solve_funcaptcha`	`funcaptcha`	`sitekey`, `url`
`twocaptcha_solve_geetest`	`geetest`	`gt`, `challenge`, `url`
`twocaptcha_solve_geetest_v4`	`geetest_v4`	`captcha_id`, `url`
`twocaptcha_solve_capy`	`capy`	`sitekey`, `url`
`twocaptcha_solve_keycaptcha`	`keycaptcha`	`s_s_c_user_id`, `s_s_c_session_id`, two signs, `url`
`twocaptcha_solve_lemin`	`lemin`	`captcha_id`, `div_id`, `url`
`twocaptcha_solve_mtcaptcha`	`mtcaptcha`	`sitekey`, `url`
`twocaptcha_solve_friendly_captcha`	`friendly_captcha`	`sitekey`, `url`
`twocaptcha_solve_cutcaptcha`	`cutcaptcha`	`misery_key`, `apikey`, `url`
`twocaptcha_solve_amazon_waf`	`amazon_waf`	`sitekey`, `iv`, `context`, `url`
`twocaptcha_solve_tencent`	`tencent`	`app_id`, `url`
`twocaptcha_solve_atb_captcha`	`atb_captcha`	`app_id`, `api_server`, `url`
`twocaptcha_solve_datadome` ⚑	`datadome`	`proxy`, `user_agent`, `captcha_url`, `pageurl`
`twocaptcha_solve_captchafox` ⚑	`captchafox`	`proxy`, `user_agent`, `sitekey`, `pageurl`
`twocaptcha_solve_vkcaptcha` ⚑	`vkcaptcha`	`proxy`, `user_agent`, `redirect_uri`
`twocaptcha_solve_prosopo`	`prosopo`	`sitekey`, `pageurl`
`twocaptcha_solve_temu`	`temu`	`body`, `part1..3`
`twocaptcha_solve_altcha`	`altcha`	`pageurl`
`twocaptcha_solve_cybersiara`	`cybersiara`	`master_url_id`, `pageurl`, `cyber_user_agent`
`twocaptcha_solve_yandex_smart`	`yandex_smart`	`sitekey`, `url`

⚑ — proxy and user_agent are required by the SDK signature.

All solver tools accept the same set of optional kwargs (mixin SolverKwargs):

proxy: {type, uri} (HTTP/HTTPS/SOCKS4/SOCKS5)
pingback: HttpUrl — per-call pingback URL (must be pre-registered)
soft_id: int
cookies: str
user_agent: str
lang: str
header_acao: 0|1

Management (5)

twocaptcha_balance — current balance in USD
twocaptcha_report_good / twocaptcha_report_bad — report a captcha id within 15 minutes
twocaptcha_get_result — poll a captcha id manually (paired with send_raw)
twocaptcha_send_raw — escape hatch for SDK methods this server does not yet expose

Pingback CRUD (3)

twocaptcha_register_pingback — whitelist a callback URL
twocaptcha_list_pingbacks — list whitelisted addresses
twocaptcha_delete_pingback — delete one or addr="all"

Development

pytest --cov=twocaptcha_mcp --cov-branch --cov-fail-under=92 -v

ruff check . && ruff format --check . mypy --strict twocaptcha_mcp

Run live tests against the real 2Captcha API (consumes credits):

pytest -m live --run-live          # balance + solve_normal + concurrent_balance

pytest -m e2e --run-e2e # full MCP protocol roundtrip via mcp.client.session

Architecture

twocaptcha_mcp/

├── main.py # stdio entrypoint ├── server.py # build_server + dispatch_tool_call ├── config.py # pydantic-settings (.env) ├── logger.py # stderr-only logger (stdout is reserved for stdio MCP) ├── client/ │ ├── solver.py # SolverClient — async wrapper over AsyncTwoCaptcha │ ├── pingback.py # httpx wrapper for legacy res.php │ ├── rate_limiter.py # async sliding-window per-method rate limiter │ └── errors.py # internal CaptchaError hierarchy ├── schemas/ # Pydantic request/response models per captcha family ├── tools/ # @captcha_tool handlers per captcha family + composite └── webhook_receiver/ # Starlette app + SQLite store (twocaptcha-mcp-webhook)

Tool handlers depend only on the SolverClient / PingbackClient abstractions — the SDK is never imported from a handler. Adding a new captcha type is a 3-step process: schema → tool handler → snapshot test count bump.

Webhook receiver (optional, since 0.3.0)

For long-running solves (recaptcha v3 up to 600 s), the polling-mode SDK call holds the MCP request slot for the entire duration. Run the optional twocaptcha-mcp-webhook server to flip into pingback mode — 2Captcha POSTs the result to your URL, the receiver writes it to SQLite, and the MCP tools read asynchronously without blocking.

Composite tool: twocaptcha_solve_and_wait_pingback sends the captcha and waits on the local store
Read tools: twocaptcha_pingback_events_list/get/clear
Deployment: docs/DEPLOY-WEBHOOK.md
Troubleshooting: TROUBLESHOOTING.md

Contributing

See CONTRIBUTING.md for the dev loop, code conventions, and the SemVer policy for the MCP tool surface.

Security

See SECURITY.md. Vulnerabilities are reported privately via GitHub Security Advisory.

License

MIT — see LICENSE.

Registry verification — mcp-name: io.github.aruxojuyu665/twocaptcha-mcp

2Captcha MCP

What it does

Instalación

Instala Python (uv)

Regístrate y crea una clave de 2Captcha MCP

Abre el archivo de configuración de la app de Claude de escritorio

Pega esta configuración y guarda el archivo

Cierra Claude y vuelve a abrirlo

Pruébalo

Lo que puedes hacer en su lugar

Instala Python (uv)

Regístrate y crea una clave de 2Captcha MCP

Abre la Terminal

Pega este comando y pulsa Enter

Escribe /mcp en Claude Code

Pruébalo

Instala Python (uv)

Regístrate y crea una clave de 2Captcha MCP

Pulsa este botón para abrir Cursor

Escribe tu clave

Abre el chat de IA de Cursor en modo Agent

Pruébalo

Instala Python (uv)

Regístrate y crea una clave de 2Captcha MCP

Pulsa este botón para abrir VS Code

Escribe tu clave

Abre el chat de IA de VS Code en modo Agent

Pruébalo

Instalado en tu computadora

Valores que debes completar

De un vistazo

Qué apps pueden usarlo

Qué puede hacer

Revisiones básicasi

El creador coincide con el repo

Sigue en mantenimiento

Tiene licencia

El endpoint responde

Inicio de sesión con OAuth

Sin instrucciones ocultas en las descripciones de herramientas

Conversación

Reseñas de usuarios

Comparado con otros en Herramientas para desarrolladoresi

Preguntas frecuentes

Otros de la misma categoría

REA

GitHub

Serena MCP: the IDE for your agent

README del creador

2Captcha MCP

Quick start

or for development:

Configuration

Tools

Captcha solvers (31)

Management (5)

Pingback CRUD (3)

Development

Architecture

Webhook receiver (optional, since 0.3.0)

Contributing

Security

License