Skip to main content
Are you experiencing issues obtaining the token?
Contact support

Proton Captcha

CapMonster Cloud MCP
CapMonster Cloud MCP can also be used to detect and solve CAPTCHA

Proton Captcha is a security system used on Proton services to verify legitimate user activity and protect against automated actions. Proxy is required to solve this captcha type.

Request parameters​

type<string>required

CustomTask


class<string>required

proton


websiteURL<string>required

The address of the main page where the captcha is located.


HumanVerificationToken (inside metadata)<string>required

Token from the response.


pageAction (inside metadata)<string>required

Action on the site: login or signup


userAgent<string>optional

Browser User-Agent. Use the current value supported by CapMonster Cloud: userAgentPlaceholder

You can get the latest value at: https://capmonster.cloud/api/useragent/actual.


proxyType<string>required

http - regular http/https proxy;
https - try this option only if "http" doesn't work (required for some custom proxies);
socks4 - socks4 proxy;
socks5 - socks5 proxy.


proxyAddress<string>required

IPv4/IPv6 proxy IP address. Not allowed:

  • using transparent proxies (where you can see the client's IP);
  • using proxies on local machines.


proxyPort<integer>required

Proxy port.


proxyLogin<string>required

Proxy server login.


proxyPassword<string>required

Proxy server password.

Create task method​

POST
https://api.capmonster.cloud/createTask

Request example

{
"clientKey": "API_KEY",
"task": {
"type": "CustomTask",
"class": "proton",
"websiteURL": "https://yourwebsite.com/",
"userAgent": "userAgentPlaceholder",
"metadata": {
"HumanVerificationToken": "your-verification-token",
"pageAction": "login"
},
"proxyType": "http",
"proxyAddress": "8.8.8.8",
"proxyPort": 8080,
"proxyLogin": "proxyLoginHere",
"proxyPassword": "proxyPasswordHere"
}
}

Response example

{
"errorId": 0,
"taskId": 407533072
}

Get task result method​

Use the method getTaskResult to obtain the Proton Captcha solution.

POST
https://api.capmonster.cloud/getTaskResult

Request example

{
"clientKey":"API_KEY",
"taskId": 407533072
}

Response example

{
"errorId": 0,
"cost": 0.001,
"status": "ready",
"solution": {
"data": {
"tokens": "TOKEN_VALUE_HERE....."
}
}
}

How to find the HumanVerificationToken​

  1. Open the page with Proton Captcha.
  2. Open Developer Tools (F12 or right-click → Inspect).
  3. Go to the Network tab and perform the action that triggers the captcha.
  4. Look for a request that returns the HumanVerificationToken in the response body.
  5. Copy the token value and pass it in the metadata.HumanVerificationToken field.

How to find the pageAction​

The pageAction parameter depends on the action being performed on the website:

  • Use login when the user is logging in
  • Use signup when the user is creating a new account