developer-toolsapi_key

Twocaptcha

2Captcha is a service that provides automated CAPTCHA solving solutions, enabling developers to bypass various types of CAPTCHAs in their applications.

Verdict

The Twocaptcha MCP lets your team programmatically solve CAPTCHAs during automated workflows — reCAPTCHA, hCaptcha, image challenges, and more. @mention it in a Space when you're building scrapers, testing auth flows, or running QA scripts that hit CAPTCHA walls. It submits the challenge to Twocaptcha's solver network and returns the token you need to proceed. Best for engineering and QA teams who automate browser tasks. You'll need a Twocaptcha account with credits; each solve consumes balance, and complex CAPTCHAs can take 10-60 seconds to return.

Common use cases

  • Automate QA tests blocked by reCAPTCHA
  • Scrape competitor pricing behind CAPTCHA gates
  • Test authentication flows with hCaptcha
  • Bypass image challenges in CI pipelines
  • Validate CAPTCHA integration in staging

Integration

Vendor
Twocaptcha
Category
developer-tools
Auth
API_KEY
Tools
1
Composio slug
twocaptcha

Tools

  • Create CAPTCHA Task

    Tool to create a new captcha-solving task. use when you need to initiate solving of any supported captcha type. call after assembling captcha parameters.

Setup

Setup guide

  1. 11. Sign up at twocaptcha.com and fund your account with credits (pricing varies by CAPTCHA type). 2. Navigate to your account dashboard and copy your API key from the settings panel. 3. In Switchy, open your workspace settings and click 'Add Integration' under the MCP section. 4. Select Twocaptcha from the list and paste your API key when prompted. 5. Click 'Connect' — Switchy will validate the key against Twocaptcha's API. 6. Open any Space, type '@Twocaptcha create a task for this reCAPTCHA sitekey: [your-key] on [your-url]', and send. 7. The MCP will return a task ID; poll it or wait for the solved token in the response. 8. Check your Twocaptcha dashboard to confirm the task logged and credits deducted.

What teammates see: by default, memories from Twocaptcha are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Spaces have used this MCP together with a given model.

How Switchy teams use it

Not enough Spaces yet to publish anonymised usage stats (we require ≥ 50 Spaces per week).

Starter prompts

Solve reCAPTCHA v2

@Twocaptcha create a task to solve reCAPTCHA v2 with sitekey 6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ- on https://www.google.com/recaptcha/api2/demo
Open in a Space →

Solve hCaptcha

@Twocaptcha create a task for hCaptcha with sitekey 10000000-ffff-ffff-ffff-000000000001 on https://accounts.hcaptcha.com/demo
Open in a Space →

Solve Image CAPTCHA

@Twocaptcha create a task to solve this base64 image CAPTCHA: [paste base64 string here] with numeric characters only
Open in a Space →

Solve reCAPTCHA v3

@Twocaptcha create a task for reCAPTCHA v3 with sitekey 6LdyC2cUAAAAACGuDKpXeDorzUDWXmdqeg-xy696 on https://2captcha.com/demo/recaptcha-v3 with action 'demo' and min score 0.7
Open in a Space →

Solve FunCaptcha

@Twocaptcha create a task for FunCaptcha with public key 804380F4-6844-FFA1-ED4E-5877CA1F1EA4 on https://funcaptcha.com/tile-game-lite-mode
Open in a Space →

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@twocaptcha I need to solve a reCAPTCHA v2 for https://example.com/login with site key 6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-

Output

Task created successfully with ID 72457362895. The reCAPTCHA v2 challenge has been queued for solving by Twocaptcha's worker network. Typical solve time is 10-30 seconds depending on current queue load. Once solved, you'll receive a response token that can be submitted with your login form. Check task status using the returned task ID to retrieve the solution token.

Notes

This example shows the primary workflow: submitting a CAPTCHA challenge and receiving a task ID. You'll need to poll separately for the solution (not shown here). Requires valid API credits in your Twocaptcha account. Response times vary with service load—budget 30-60 seconds for complex CAPTCHAs during peak hours.

Prompt

@twocaptcha Create a task to solve this hCaptcha with site key a5f74b19-9e45-40e0-b45d-47ff91b7a6c2 on https://discord.com/register

Output

hCaptcha task initiated with ID 72457363012. The challenge parameters have been forwarded to available solvers in the Twocaptcha network. hCaptcha typically requires 15-45 seconds to solve. You'll receive a token string upon completion that must be included in your registration request's h-captcha-response field within 2 minutes before it expires.

Notes

Demonstrates hCaptcha support, a common alternative to reCAPTCHA. The MCP handles task creation but doesn't automatically poll for completion—you'll need follow-up logic to retrieve the solved token. Be aware that solved tokens have short expiration windows (typically 120 seconds), so coordinate your form submission timing accordingly.

Prompt

@twocaptcha I'm hitting rate limits on an API protected by Cloudflare Turnstile. Can you solve the challenge for https://api.example.com with site key 0x4AAAAAAADnPIDROzbs0Wjw?

Output

Cloudflare Turnstile task created with ID 72457363089. This challenge type typically solves in 20-40 seconds. Turnstile tokens are single-use and domain-locked, so the returned solution will only work for api.example.com requests. Once you receive the solved token, include it in your API request's cf-turnstile-response header or form field as specified by the API's documentation.

Notes

Shows support for Cloudflare's newer Turnstile system, increasingly common on developer APIs. Important limitation: Turnstile tokens are bound to the specific domain and often the IP address that requested them. If your automation runs from multiple IPs or the API enforces strict fingerprinting, you may need to solve a fresh challenge per request. Costs 1-2 credits per solve.

Use-case deep-dives

Automated testing with CAPTCHA gates

When this MCP saves QA cycles on protected staging environments

A 6-person engineering team runs nightly Playwright tests against a staging environment that sits behind Cloudflare's Turnstile CAPTCHA. Without automated solving, QA engineers manually complete CAPTCHAs each morning before tests can proceed, burning 20-30 minutes daily. The Twocaptcha MCP solves this by letting your test suite programmatically request CAPTCHA solutions via a single API key—no per-user credentials, no browser automation hacks. The trade-off: each solve costs $0.50-$2.99 depending on CAPTCHA type, so a 50-test suite hitting 10 CAPTCHAs nightly runs $150-$900/month. This math works when your QA team's hourly rate exceeds the solve cost, typically at 4+ engineers. If your staging environment can whitelist CI IPs instead, do that first—it's free and faster.

Competitive intelligence web scraping

When this MCP unblocks price monitoring at small scale

A 3-person e-commerce ops team monitors competitor pricing across 40 retailer sites twice daily to adjust their own catalog. Half those sites deploy reCAPTCHA v2 or hCaptcha after the first few requests, killing their Python scraper. The Twocaptcha MCP handles this by offloading CAPTCHA solving to human workers—your scraper pauses, submits the challenge via the MCP's single tool, waits 10-30 seconds for a solution, then continues. At 80 CAPTCHAs daily and $1.50 average cost, that's $3,600/year versus hiring a part-time analyst at $25k. The boundary: if you're scraping 500+ pages daily, solve costs balloon past $20k/year and you need a residential proxy network instead. For sub-100-page monitoring, this MCP is the pragmatic unlock.

Customer account recovery workflows

When this MCP doesn't fit internal support tooling

A 10-person SaaS support team fields 30 account recovery requests daily, each requiring a CAPTCHA verification before password reset. The team considers automating this via the Twocaptcha MCP to speed up ticket resolution. This is the wrong call. The MCP's single tool creates tasks for external CAPTCHA solving—it's built for scenarios where your system encounters third-party CAPTCHAs, not for solving CAPTCHAs you control. If you own the CAPTCHA (via Google reCAPTCHA Enterprise or similar), you already have server-side verification APIs that skip the visual challenge entirely for trusted contexts. Use those. The Twocaptcha MCP only makes sense when you're interacting with someone else's CAPTCHA and have no backend access. For internal workflows, it adds cost and latency with no benefit.

Frequently asked

What does the Twocaptcha MCP do in Switchy?

It lets your AI agents submit CAPTCHA challenges to Twocaptcha's human-solving service and retrieve the solved tokens. When an agent hits a CAPTCHA during web automation or scraping, it calls the Create CAPTCHA Task tool with the challenge parameters, waits for Twocaptcha workers to solve it, then uses the returned token to proceed. You still pay Twocaptcha's per-solve fees on top of your Switchy plan.

Do I need a Twocaptcha account to use this MCP?

Yes. You authenticate with a Twocaptcha API key, which means you need an active Twocaptcha account with credit loaded. Switchy doesn't provide CAPTCHA-solving itself—it just connects your agents to Twocaptcha's service. Grab your API key from the Twocaptcha dashboard and paste it into Switchy's connection flow during setup.

Can the MCP solve reCAPTCHA v3 and hCaptcha?

Yes, if Twocaptcha supports the CAPTCHA type. The Create CAPTCHA Task tool accepts parameters for reCAPTCHA v2, v3, hCaptcha, image CAPTCHAs, and other formats Twocaptcha handles. You pass the site URL, CAPTCHA key, and type; Twocaptcha's workers solve it and return the token. Check Twocaptcha's docs for the full list of supported challenge types and required parameters.

How is this different from calling Twocaptcha's API directly?

It's the same underlying service, but the MCP wraps Twocaptcha's API so your AI agents can solve CAPTCHAs mid-conversation without you writing HTTP requests. If you're already scripting Twocaptcha calls in Python or Node, you won't gain much. If you want agents to handle web automation autonomously—scraping, form fills, account creation—the MCP removes the integration boilerplate.

Who on the team should connect the Twocaptcha MCP?

Whoever manages your Twocaptcha account and has the API key. This is typically a developer or ops lead, since CAPTCHA-solving is part of automation workflows, not everyday business tasks. Once connected, any team member can invoke agents that use the MCP, but you'll want to monitor Twocaptcha spend—each solve costs money, and agents can burn through credit quickly if misconfigured.

Data last verified 607 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.