# Captcha Solver — how to use (mcp.ai)

Resolve reCAPTCHA v2/v3, hCaptcha, Cloudflare Turnstile e captchas de imagem. Hospedado pela plataforma, sem credenciais, pague por solve com crédito pré-pago.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_captcha?ms=1781044260000`
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. `captcha_get_result`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/captcha`
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/captcha/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/captcha/get/result` — Consulta o resultado de uma task de captcha já criada, pelo task_id. Não é cobrado (a cobrança ocorre na solve que criou a task).
  - body: { task_id: string, task_ids?: string[] }
- `POST https://api.mcp.ai/api/captcha/solve/hcaptcha` — Resolve um desafio hCaptcha. Retorna o token pra submeter no site alvo. Cobrado em créditos por solve.
  - body: { website_url: string, website_key: string }
- `POST https://api.mcp.ai/api/captcha/solve/image` — Resolve um captcha de imagem (texto distorcido). Envie a imagem em base64; retorna o texto reconhecido. Cobrado em créditos por solve.
  - body: { body_base64: string, module?: string, case_sensitive?: boolean }
- `POST https://api.mcp.ai/api/captcha/solve/recaptcha/v2` — Resolve um desafio reCAPTCHA v2. Retorna um token (gRecaptchaResponse) pra submeter no site alvo. Cobrado em créditos pré-pagos por solve.
  - body: { website_url: string, website_key: string, is_invisible?: boolean }
- `POST https://api.mcp.ai/api/captcha/solve/recaptcha/v3` — Resolve um desafio reCAPTCHA v3. Retorna um token (gRecaptchaResponse). Informe a page_action esperada pelo site. Cobrado em créditos por solve.
  - body: { website_url: string, website_key: string, page_action?: string, min_score?: number }
- `POST https://api.mcp.ai/api/captcha/solve/turnstile` — Resolve um desafio Cloudflare Turnstile. Retorna o token. Cobrado em créditos por solve.
  - body: { website_url: string, website_key: string, action?: string, cdata?: string }

## Example prompts
- "Resolva o reCAPTCHA v2 desta página (site_key X) e me devolva o token"
- "Resolva o Turnstile do site Y"
- "Qual meu saldo de créditos do Captcha Solver?"

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