Captcha solving for agents · For Claude
For Claude
Claude can hold the tool. It should not hold the run.
Claude Desktop can add a remote tool. Once the desk is in that config, a captcha is something Claude calls, not something it asks you to solve in the middle of the chat.
type RecaptchaV2
websiteURL · websiteKey
answer · placed · continue
The problem
The chat is a bad place to wait for a click.
You are in a long conversation. Claude is filling a form, reading a page, or finishing a signup. A check appears. If the only move is to stop and ask you, the conversation becomes a queue. You have to switch into the browser, solve the letters or the boxes, and come back to say continue.
That pause is the babysitting. It also misses the clock. A widget token lasts about two minutes. A person stepping out of the chat to deal with it is usually slower than that, so the first answer is wasted and Claude asks again.
A plain request in the chat does not give Claude a way to fetch the token. The desk has to be installed as a tool. Then Claude sends the captcha, reads the answer, and goes on. You stay in the conversation you actually wanted.
What you do
Add the server once. Tell the chat to use it.
- Claude Desktop reads a JSON config under Settings, Developer, Edit Config.
- The captell server uses the seat’s key. Balance and solves show up on your desk.
- The first sentence of the note tells Claude to call the server when a captcha appears, and to use the answer that comes back.
- 01Copy the note from the desk, with Claude selected.
- 02Open Claude Desktop settings, then Developer, then Edit Config, and merge the JSON.
- 03Restart Claude. Paste the first sentence of the note into the chat so the habit is explicit.
Sample
Claude Desktop config
Merge this into the existing config. Do not throw away other servers.
When a captcha appears, send it through the captell server and use the answer that comes back.
{
"mcpServers": {
"captell": {
"url": "https://captell.run/api/mcp",
"headers": {
"Authorization": "Bearer ct_live_your_key"
}
}
}
}
A picture of letters, including a phpBB Bestätigungscode, is one tight crop of only the code, at least 100 bytes. Subject: ImageToText. Do not click Place the check for it. A page whose only captcha is that picture has no Place the check button. If the reply says it was not read, crop closer and send that new file the same way.
Google, Cloudflare, or hCaptcha:
Do not open https://captell.run/login. Do not use hcaptcha.com.
The page helper is the CAPTELL Page Helper extension, version 2026.10.4.16. Its popup shows the version and this bot's masked key. If that browser runs the captell.user.js fallback instead and Tampermonkey offers 2026.10.4.16, accept it.
A cookie wall must be accepted before the captcha and the Place the check button appear.
One corner button, named Place the check.
A click anywhere inside the button rectangle counts.
A click always changes the button to Placing…, No widget, Missing site key, or Unsupported type. A click that stays on Place the check did not run. Click again. That click does not count toward the four tries.
If the button says Missing site key, stop. Do not retry four times. Reloading will not invent a key.
If the button says Unsupported type, stop. Do not retry. FunCaptcha, GeeTest, and KeyCaptcha are unsupported.
A Security Check label with no checkbox is still a captcha. Click Place the check first. Do not submit only because no human box is visible.
If no captcha is visible, and there is no Security Check label, click the site's submit button, unless the form asks a math or knowledge question. Then click Place the check. If a captcha then appears, use Place the check.
Submit only when the button says exactly "Placed. Submit the form." and the site's own human box is checked, or there is no empty checkbox and no open image grid.
Placing… ends as Placed, No token, a short solver error, or it returns to Place the check after 3 minutes. Do not click while it says Placing….
If the button says No token, or a short solver error, do not submit. Click Place the check again, up to 4 tries. A failed try is not charged.
Placed clears when the token expires, in about two minutes. Submit soon after Placed. Do not submit an old token.
If the page says "You did not pass the security check. Please try again." or "Captcha Prüfung fehlgeschlagen!", click Place the check. If the button is missing, reload once. Do not submit again until the button says Placed again.
If the page says "Die Registrierung ist wegen Spamschutzmaßnahmen fehlgeschlagen." or "No soup for you!" or "Your registration has been rejected as it resembles spam-like or automated behavior. Please contact the administrator for further information or assistance." after a real Placed submit, try once more: click Place the check, and submit as soon as it says Placed. If the board says it again, that is the board's spam filter. Stop that board. Do not click Place the check again for it.
A badge-only check can say Placed when the token is in the form and there is no empty checkbox and no open image grid.
If an image grid is open, including "Please click on the icon that is different.", do not click the pictures and do not submit. Wait for Placing… to finish. If the grid stays open after the button settles, click Place the check again. It counts as one of the four tries.
If the register page is already signed in as another account, log out and reopen it as a guest. Do not cancel that other registration.
If the form is visible, the cookie wall is gone, a captcha label is on the page, and Place the check never appears, stop that board and report the URL and the label text.
Click Place the check. It fills a math answer or a question such as "Wie heißt die Hauptstadt von Deutschland?" and places the captcha if there is one. Submit only when the button says exactly "Placed. Submit the form." If the button says "Could not answer", stop and report the question text. An unknown page state can come back as one instruction that stays on this registration form.
Username already used, a banned email, "Entering a password is required.", and "Die Eingabe eines Passworts ist erforderlich." are form errors. Do not click Place the check again for them.
Do not send a screenshot. Do not type the token. Do not mail the page.Addresses on this page use your-bot@mail.captell.run so the shape is visible. The desk fills in the real address and key.
Also waiting