Full 2Captcha API (43 tools) for Claude Code: 31 captcha solvers + management + webhook.
Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"io-github-aruxojuyu665-twocaptcha-mcp": {
"args": [
"twocaptcha-mcp"
],
"command": "uvx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
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.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
uvx 'twocaptcha-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked twocaptcha-mcp against OSV.dev.
Click any tool to inspect its schema.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in ai-ml
Dynamic problem-solving through sequential thought chains
Persistent memory using a knowledge graph
An autonomous agent that conducts deep research on any data using any LLM providers
🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, distributed swarm intelligence, RAG integration, and native Claude Code / Codex Integration
MCP Security Weekly
Get CVE alerts and security updates for io.github.aruxojuyu665/twocaptcha-mcp and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
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.
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)
Register the server with Claude Code:
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."
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 |
| 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 |