# Sekreto

Browser access for AI agents: open difficult pages, extract useful content, click, fill forms and complete multi-step web tasks.

## Connect

- Endpoint: https://api.sekreto.ai/mcp
- Transport: streamable HTTP, JSON-RPC 2.0, protocol 2026-07-28
- Authentication: `x-api-key: YOUR_API_KEY` with the raw key, or `Authorization: Bearer YOUR_API_KEY`
- Required Accept header: `Accept: application/json, text/event-stream`
- Send `Mcp-Method` with the JSON-RPC method. For `tools/call`, also send `Mcp-Name` with the tool name.
- Setup guide for Claude, Goose and Hermes: https://sekreto-dev.pages.dev/gateway.html

## Discover the current tools

Call `tools/list` for the live tool list and schemas. Do not rely on a hard-coded tool count.

Current tool groups:

- Open and inspect: `browser_navigate`, `browser_snapshot`, `browser_screenshot`, `browser_back`, `browser_close`, `get_links`
- Act: `browser_click`, `browser_type`, `browser_mouse`, `browser_press`, `browser_scroll`, `browser_evaluate`, `browser_script`, `handle_dialog`
- Read: `extract`, `crawl`
- Session continuity: `list_instances`, `create_instance`, `delete_instance`, `get_cookies`, `import_cookies`
- Supported challenges: `solve_captcha` (best-effort; not every challenge type is supported)
- Account usage: `usage` (free)

There is no general-purpose `search` tool in the current tool list.

## Accounts and billing

- Create an account at https://sekreto-dev.pages.dev/account.html
- No email, name or password is required.
- The 16-digit account number checks balance and usage. The separate secret key connects your agent.
- €0.01 per call; 100 calls per €1. Minimum top-up €5.
- Calls never expire. No subscription is required.
- HTTP errors are not billed. The `usage` tool and account balance check are free.
- Checkout is handled by Polar.

## Usage lookup without the secret key

`GET https://api.sekreto.ai/check?acct=YOUR_16_DIGIT_ACCOUNT_NUMBER`

## Sessions and limitations

- Browser state is session-scoped and expires. Do not assume cookies or signed-in state survive after a session ends.
- Use instances and cookie tools when a task needs continuity during its lifetime.
- Crawls are bounded; check each tool's current schema for limits.
- A published browser-check result is a dated snapshot, not a guarantee for every site or future run.
- Latest results: https://sekreto-dev.pages.dev/benchmarks.html

## Support and terms

- Support: support@sekreto.ai — never include your secret key in a support message.
- Terms and acceptable use: https://sekreto-dev.pages.dev/terms.html