# RegTail auth.md

Review UK used-car MOT records before a viewing. Start with `free_check` for
one car or `compare_vehicles` for two. Odds are an estimate, not an inspection.
Finance, stolen and write-off registers are not checked.

## No account

The public MCP tools `resolve_vehicle`, `free_check`, `compare_vehicles`,
`decode_plate` and `sample_report` are free without authentication.
REST sandbox fixtures at /api/v1/sandbox/scenarios need no authentication.
The `rt_test_sample` API key returns sandbox fixtures and spends nothing.

## Linked account

Sign in or register at [regtail.com](https://regtail.com), then link your account
via OAuth in your MCP client using https://regtail.com/mcp.
The issuer is Clerk at https://clerk.regtail.com; protected-resource metadata is
at https://regtail.com/.well-known/oauth-protected-resource/mcp.
`unlock_report` spends one credit to unlock one plate for 30 days.
Get explicit plate-specific confirmation before spending a credit.
`full_report` and `viewing_advice` read an active unlock without spending again;
`my_reports` and `credits_balance` are free account tools.
Never make autonomous top-ups: the buyer decides whether to buy credits.

## API key

Sign in at [regtail.com](https://regtail.com/?account=keys) and create an API key
in the account panel under API keys. Keep it secret.
For the REST API, send `Authorization: Bearer <key>` or `X-API-Key: <key>`.
The same key works with MCP. `check_vehicle` and `check_photo` cost one credit
per call; `viewing_advice` is free for 30 days after a paid check of the same car,
otherwise one credit. `decode_plate` and `credits_balance` are free.
An optional API plan counts cars under its plan terms.
Paid API-key calls charge per call: do not blindly retry or prefetch checks.
Get plate-specific consent before spending, and never make autonomous top-ups.

See [agent docs](/docs/agents), [pricing](/pricing) and [API schema](/openapi.json).
