# solvethree API and agent integration

Verified: 2026-11-04. Canonical reference: https://solvethree.com/docs
Capabilities: https://solvethree.com/capabilities.json
OpenAPI 3.1: https://solvethree.com/openapi.json

solvethree provides reCAPTCHA Enterprise v3, Kasada and Ticketmaster TMPT through one task API.
No native hCaptcha, Turnstile or reCAPTCHA v2 support. Standalone Kasada is limited to HTTPS www.ticketmaster.com targets.

## Official Go SDK

Install: go get solvethree.com/sdk@v0.1.0
Requires Go 1.22+. Import solvethree from "solvethree.com/sdk". NewClient(apiKey, nil), CreateTask(ctx, task, waitMS), GetTask(ctx, id, waitMS), and Solve(ctx, task, SolveOptions{}) use contexts and typed task results. Errors expose recovery IDs. The module is served from solvethree.com. Setup: https://solvethree.com/integrations#go

## Authentication and preparation

Use Authorization: Bearer <workspace API key> from your server. Never put API keys in browser code or chat messages.
reCAPTCHA requires an active site profile in the workspace console before creating tasks. A task does not create a profile.
Supply exactly one of proxy or proxyCandidates. Candidates: at most six distinct HTTP(S) proxy URLs without path, query or fragment. Session tasks require one proxy.
With proxyCandidates, solution.egressAttempts is the successful candidate's one-based index in the original array. Validate it is an integer from 1 through the array length before using that proxy. If absent or invalid, stop rather than guess. Session tasks require a single proxy.

## Create a task

POST https://api.solvethree.com/v1/tasks?waitMs=0
Content-Type: application/json

### reCAPTCHA Enterprise

```json
{
  "site": "example.com",
  "action": "login",
  "proxy": "http://user:password@proxy.example:8080",
  "requestId": "example-recaptcha-001"
}
```

Do not send type or url. Optional recaptchaType: enterprise-v3 (default) or v3.

### Kasada

```json
{
  "type": "KasadaTask",
  "url": "https://www.ticketmaster.com/",
  "proxy": "http://user:password@proxy.example:8080",
  "requestId": "example-kasada-001"
}
```

Do not send site, action, recaptchaType, session or custom browser identity. Output is solution.headers.

### Ticketmaster TMPT

```json
{
  "type": "TicketmasterTmptTask",
  "url": "https://www.ticketmaster.com/event/EXAMPLE",
  "action": "Event",
  "proxy": "http://user:password@proxy.example:8080",
  "requestId": "example-tmpt-001"
}
```

The example event identifier is a placeholder: replace it with the exact supported event URL. Login uses action Login and its supported sign-in entry URL. Output solution.token is the raw tmpt cookie value.

## Retrieve, recover and stop

GET https://api.solvethree.com/v1/tasks/{id}?waitMs=0
pending and solving are nonterminal. ready includes solution. failed is terminal: inspect errorCode/error and stop polling.
New task creation returns HTTP 201; idempotent replays and retrieval return HTTP 200. Both may carry nonterminal states; HTTP success is not readiness.
Creation defaults: reCAPTCHA 15000 ms (maximum 15000), Kasada 75000 ms (maximum 75000), TMPT 0 ms (maximum 75000).
Retrieval waitMs: 0–15000. waitMs is a query parameter, not a body field. Budget network overhead in HTTP timeouts.
Use a stable requestId (1–64 ASCII letters, numbers, underscores or hyphens) for each logical task. Same ID and identical inputs return the existing task; changed inputs conflict.
A creation timeout may have succeeded. Reuse the same ID and inputs; do not generate another ID automatically. Polling never needs another POST.
HTTP 400: invalid input; 401: API key; 402: credit; 403: active profile required; 404: task not found in this workspace; 409: conflicting request or temporary legacy transition; 410: result expired; 429: throttled; 5xx: service issue.
Honor Retry-After and a finite deadline. The SDKs never retry POST automatically.
Preserve returned userAgent/secChUa, exact target and proxy identity. ready does not guarantee target acceptance or a particular reCAPTCHA score.

## Pricing in USD

- reCAPTCHA Enterprise v3: $2.00 per 1000 solves.
- Kasada: $1.25 per 1000 solves.
- Ticketmaster TMPT: $0.99 per 1000 solves.
Failed solves are refunded. Minimum deposit: $10. Welcome credit: $5.
Unlimited monthly pricing is progressive: first site slot $10000; slots 2–3 $7500 each; 4–6 $5000; 7–9 $3500; 10+ $2500. Later tiers do not reprice earlier slots.
https://solvethree.com/pricing

## SDKs, MCP and skills

Official version 0.1.0 downloads: https://solvethree.com/integrations
JavaScript: npm install https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz
Python: python -m pip install https://solvethree.com/downloads/solvethree_sdk-0.1.0-py3-none-any.whl
MCP: the JavaScript package includes solvethree-mcp (stdio). Environment: SOLVETHREE_API_KEY and SOLVETHREE_PROXY. Capability discovery works without credentials; task creation uses workspace credit. Each create tool makes at most one task per call and requires a stable requestId. No hosted MCP URL or npm/PyPI registry release is claimed.
Agent skill: https://solvethree.com/downloads/solvethree-skill-0.1.0.zip

## Further reading

- Product boundaries: https://solvethree.com/capabilities
- Comparisons: https://solvethree.com/compare
- Benchmark methodology: https://solvethree.com/benchmarks
- Guides: https://solvethree.com/guides
- Status: https://solvethree.com/status
- Support: support@solvethree.com