Captcha solving for agents · For Cursor

For Cursor

An agent in the editor still stalls on a checkbox.

Cursor can call tools. If CAPTELL is not one of them, the agent reaches a captcha and waits for you to take the browser. The edit you asked for sits unfinished behind that wait.

VIThe editor does not lose the turnThe agent calls the desk and places the answer, then goes back to the job.

The problem

The agent’s turn ends where the check begins.

You asked Cursor to register, post, or walk a site. It gets there. The form is filled. Then a captcha stops the turn. The agent describes the widget and waits, because it was not given a way to finish that step.

You are now the clerk for your own editor. You open the browser, solve the check, and tell the agent to continue. If you are in the code and not watching the browser, the agent waits the whole time. A second captcha later in the same flow does it again.

The fix is the same shape as any other tool the agent is allowed to call. Add the desk under MCP, and put one line in a rule or the chat: when a captcha appears, call captell and use the answer. The agent places it. You stay in the editor.

What you do

A tool, not a handoff.

  1. 01Copy the note from the desk, with Cursor selected.
  2. 02Open Cursor Settings, then MCP, and add the JSON.
  3. 03Paste the first sentence into a rule or the chat so the agent uses the server instead of stopping.

Sample

Cursor MCP config

The sentence above the JSON is the instruction. The JSON is the door.

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