solve_captcha
Solve web CAPTCHA challenges (Turnstile, hCaptcha, reCAPTCHA v2, Arkose, Cloudflare) and return a valid solution token. Automatically retries once on failure without double charging. Requires x402 payment on Base.
When to use: Use when an agent encounters a bot wall or CAPTCHA challenge during automated web workflows. When NOT to use: Do NOT use for non-CAPTCHA auth, 2FA/OTP codes, or general login forms.
Parameters:
type(string, required): CAPTCHA type ('turnstile', 'hcaptcha', 'recaptcha', 'arkose', 'cloudflare').sitekey(string, required): Public sitekey extracted from the target page DOM.url(string, required): Full target webpage URL hosting the challenge.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"type": "<type>",
"sitekey": "<sitekey>",
"url": "<url>"
},
"name": "solve_captcha"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | The full target page URL where the CAPTCHA challenge is hosted. | |
| type | Yes | The specific type of CAPTCHA challenge encountered on the target page. | |
| sitekey | Yes | The CAPTCHA sitekey parameter extracted from the target page DOM or iframe. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| token | Yes | The resulting CAPTCHA response token to submit to the form | |
| method | No | Solving method or backend engine used | |
| solved | Yes | Whether the CAPTCHA challenge was successfully solved | |
| elapsed | No | Time taken in seconds to solve the challenge |