# Twocaptcha — how to use (mcp.ai)

Connect your Twocaptcha account and use 5 tools for developer tools straight from your AI agent. Connect with your own API key. 2Captcha is a service that provides automated CAPTCHA solving solutions, enabling developers to bypass various types of CAPTCHAs in their applications.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_twocaptcha?ms=1787295900000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `twocaptcha_create_task`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/twocaptcha`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/twocaptcha/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/twocaptcha/create/task` — Creates a new CAPTCHA-solving task and returns a taskId for retrieving results. Supports multiple captcha types: reCAPTCHA v2/v3, hCaptcha, image recognition, and more. After creating a task, use the 
  - body: { task: object, softId?: integer, clientKey: string, callbackUrl?: string, languagePool?: string }
- `POST https://api.mcp.ai/api/twocaptcha/get/balance` — Tool to retrieve your 2Captcha account balance in USD. Use when you need to check available funds before creating captcha-solving tasks.
  - body: { clientKey: string }
- `POST https://api.mcp.ai/api/twocaptcha/report/incorrect` — Report that a CAPTCHA solution was declined by the target website. Use this action to provide feedback when a solved CAPTCHA is rejected, enabling 2Captcha to improve accuracy and potentially issue re
  - body: { taskId: integer, clientKey: string }
- `POST https://api.mcp.ai/api/twocaptcha/report/incorrect/image/captcha` — Report that an image captcha solution was incorrect. Alias for reportIncorrect method. Use this when you receive an incorrect captcha solution from 2Captcha to report the issue. Made for compatibility
  - body: { taskId: integer, clientKey: string }
- `POST https://api.mcp.ai/api/twocaptcha/test/request` — Debug method to verify how the API parses request parameters. Use when troubleshooting integration issues or validating parameter formats.
  - body: { clientKey: string }

## Example prompts
- "What can I do in Twocaptcha?"
- "Show me a summary of my Twocaptcha account"

## More
- Page: https://mcp.ai/twocaptcha
- Agent spec (llms.txt): https://mcp.ai/twocaptcha/llms.txt
- Postman collection: https://mcp.ai/twocaptcha/postman.json