Check a UK used car by plate or from a photo: every MOT test, mileage checks, problems by part, signs of a cloned plate, a verdict and a checklist for the viewing. Five calls over HTTP (https://regtail.com/api/v1) or MCP (https://regtail.com/mcp), one key, 1 credit a check. Sources: the DVSA MOT history, the DVLA record and our analysis of the national MOT data. MOT statistics by model, make and age are free with no key: see MOT Index.
The API works from a number plate or a photo of the car. It doesn't accept advert links or return advert content. To compare an advert with the records, use regtail.com. Have an advert? Send its number plate, or a photo of the car, and we'll check the records.
This page is also markdown at https://regtail.com/docs/agents.md, for an agent to read.
See authentication and spending consent: get plate-specific confirmation before spending, never make autonomous top-ups, and do not blindly retry paid API-key calls, which charge per call.
Get started#
Get a key#
- Open https://regtail.com/?account=keys, sign in and choose Create a new key.
- Copy it now. It is shown once. Keep it in a secrets store, not in code.
- Afterwards the account shows only a masked label, like
rt_live_AbCd…. That label is not the key and gets401. Lost the key? Create a new one.
An agent can't create a key: a person signs in to do it. If you are an agent, ask your user to open https://regtail.com/?account=keys, create a key and give it to you.
Add credits#
Buy credits at https://regtail.com/?account=topup: 1 credit for £2.99, 5 credits for £9.99, 15 credits for £19.99. Any key spends them, no subscription needed. A check costs 1 credit, every time. Checking many cars a month? See the API plan.
Connect#
Put the key in an environment variable:
export REGTAIL_KEY=rt_live_...
Then add the MCP server to your agent: URL https://regtail.com/mcp, transport Streamable HTTP, header Authorization: Bearer $REGTAIL_KEY. Most agents have a command or a settings entry for this, see More MCP clients.
Or call the API directly:
curl -H "Authorization: Bearer $REGTAIL_KEY" https://regtail.com/api/v1/vehicles/AB12CDE
Check it worked#
Ask your agent which RegTail tools it has, or call credits_balance.
- 6 tools (
check_vehicle,check_photo,viewing_advice,credits_balance,decode_plate,mot_index): it works. - 11 tools (
free_check,full_reportand others): the key didn't reach us. Check the header is set and that your client sends it. - 401: the key is unknown or revoked, or it's the masked label. Create a new key.
Try it without a key#
The public key rt_test_sample needs no sign-up and spends nothing. Any rt_test_ key answers from the sandbox: realistic answers on the live URLs. Inputs are still checked, so a bad plate still gets a 422. Swap in your real key later; nothing else changes.
K="Authorization: Bearer rt_test_sample"
curl -H "$K" https://regtail.com/api/v1/vehicles/AB12CDE
curl -H "$K" -X POST -H "content-type: application/json" -d '{"image": "data:image/jpeg;base64,..."}' https://regtail.com/api/v1/vehicles/from-photo
curl -H "$K" https://regtail.com/api/v1/vehicles/AB12CDE/advice
curl -H "$K" https://regtail.com/api/v1/credits
curl -H "$K" https://regtail.com/api/v1/plates/AB12CDE
Pricing#
| Plan | Price | For |
|---|---|---|
| Sandbox | Free, no sign-up | Building and testing with rt_test_sample |
| Credits | 1 credit a check | Any key, no subscription: 1 credit for £2.99, 5 credits for £9.99, 15 credits for £19.99 |
| API plan | £40 a month for 50 cars, then £1 a car | Regular checks through the API or MCP |
How credits are spent#
- Credits work with any key. You don't need a subscription.
check_vehicleandcheck_photocost 1 credit.viewing_adviceis free for 30 days after a paid check of the same car, otherwise 1 credit.credits_balance,decode_plateandmot_indexare free.- Every call is charged on its own: checking the same car again is charged again. Keep the response rather than asking again.
- If a call fails on our side, or no plate can be read in the photo, the credit is refunded.
- With no credits, a paid call gets
402 payment_requiredand nothing is charged. Itstop_up_urlopens the credit packs. - Every check response says
chargedandcredits_remaining, also as theX-Credits-ChargedandX-Credits-Remainingheaders.
API plan#
£40 a month for 50 cars, then £1 a car. Subscribe from https://regtail.com/?account=keys.
- Every key on the account uses the plan instead of credits. A car counts once per billing month: checking it again that month, or its viewing advice, is free.
- Responses say
"charged": falseand carry aplanobject:cars_used,cars_included,extra_cars,price_per_extra_car_pence,period_endandnew_car.credits_balancereturns the same object, ornull. - Up to 1,000 cars a month (
402 plan_limit). If a payment fails or the plan ends, keys spend credits again.
More MCP clients#
The endpoint https://regtail.com/mcp is stateless Streamable HTTP, answering in plain JSON. Send the key as the Authorization header. (The HTTP API also takes X-API-Key: rt_....)
A settings file. Include "type": "http", or some clients expect a local command and reject the entry. Some name the URL field serverUrl.
{"mcpServers": {"regtail": {"type": "http", "url": "https://regtail.com/mcp", "headers": {"Authorization": "Bearer rt_live_..."}}}}
A chat app's connector. Connectors take a URL and sign in with OAuth, with no field for a key. Add https://regtail.com/mcp and see Use it in a linked assistant.
By hand. Run npx @modelcontextprotocol/inspector, choose Streamable HTTP, enter https://regtail.com/mcp, add the header Authorization: Bearer rt_test_sample, connect and list the tools.
Calls and tools#
| MCP tool | HTTP | Cost |
|---|---|---|
check_vehicle |
GET /api/v1/vehicles/{plate} |
1 credit |
check_photo |
POST /api/v1/vehicles/from-photo with {"image": "data:image/jpeg;base64,..."} |
1 credit |
viewing_advice |
GET /api/v1/vehicles/{plate}/advice |
Free for 30 days after a paid check of the same car, otherwise 1 credit |
credits_balance |
GET /api/v1/credits |
Free |
decode_plate |
GET /api/v1/plates/{plate} |
Free |
mot_index |
GET /api/v1/mot-stats (no key) |
Free |
Plates take any spacing and case. A photo is your own photo of the car showing its number plate, sent as a data URL; we read the plate, run the same check, and add photo_read: the plate read and whether the car in the photo looks like the plate's record. The photo is not kept. Every field is in the reference at https://regtail.com/docs and the schema at https://regtail.com/openapi.json, with examples from the sample car. Each MCP tool's description says when to use it, what it costs and what it returns.
Calls are limited to 60 a minute per key, and sandbox calls to 30 a minute per address.
MOT Index: fleet statistics (free)#
How often a model passes its MOT, what fails, and how it compares with all cars and with cars of the same age, from the RegTail MOT Index 2025: our analysis of 34,354,523 initial MOT tests in 2025 (and 2023 and 2024), from the DVSA anonymised MOT data. Free, with no key and no account: GET https://regtail.com/api/v1/mot-stats over HTTP, or the mot_index tool on https://regtail.com/mcp with or without a key. Read-only, limited to 120 calls a minute per address.
These are figures for the whole fleet, not a check of any particular car. For one car, check it by its plate.
| Question | HTTP | MCP |
|---|---|---|
| How often does a Ford Fiesta pass its MOT, and what fails? | curl "https://regtail.com/api/v1/mot-stats?node=model/ford/fiesta" |
mot_index(node="model/ford/fiesta") |
| How does a 10-year-old Fiesta compare with all 10-year-old cars? | curl "https://regtail.com/api/v1/mot-stats/model/ford/fiesta?age=10" |
mot_index(node="Ford Fiesta", age=10) |
| How common is an oil leak at the MOT, and on which models? | curl "https://regtail.com/api/v1/mot-stats?node=defect/oil-leak&year=2024" |
mot_index(node="defect/oil-leak", year=2024) |
Node ids are stable: overview (all cars), index (every node id), postcode, release, model/{make}/{model}, make/{make} and defect/{slug}. A page URL such as /mot/ford/fiesta, an Explorer URL, or a name such as Ford Fiesta also works; an unknown or ambiguous name gets 404 not_found with up to 5 suggestions, never a guess. year is 2023, 2024, 2025 or latest (the node's newest year with figures). view=full adds the long lists, and age (model and overview nodes) adds data.at_age: the model's pass rate and typical mileage at that age, beside all cars of that age.
Every answer is one node, with:
summary: one sentence with the headline figure, the number of tests and the year.data: the figures for that year. Rates are fractions from 0 to 1. Failure and advisory rates are floors: say "at least". Fuel, mileage-band and postcode figures are not age-adjusted.evidence:type(observed),sourceswith the licence,as_of(test year, data release, published),population(how many tests),uncertainty, andinsufficient_data. When a year has too few tests,dataisnullandinsufficient_datagives the reason, the threshold and the latest year with figures: say there are not enough tests, never give a number.links(the page, the Explorer view, the data file, the downloads),edges(the next nodes: what each answers,costand whether its data isthin) and acitation.
The data release is regtail-mot-index-2025-v1, also sent as the ETag and X-Data-Release headers. The same files are at https://regtail.com/mot/data, and the Explorer is at https://regtail.com/mot/explorer. Contains public sector information licensed under the Open Government Licence v3.0.
Sandbox#
With an rt_test_ key every call answers from the sandbox. Each answer has the live shape and is built by the same analyzers as a live report, from sample records edited for the scenario, so a car's MOT, mileage and verdict agree with each other. Responses say "sample": true and name the scenario that answered.
- Any plate gets one of the vehicle scenarios below, picked from the plate, so the same plate always gets the same answer.
- A magic plate picks a scenario, or an error, on purpose:
| Plate | Scenario | What it shows |
|---|---|---|
CX52HHM |
sample |
The real sample car: MOT expired, untaxed, verdict risk. |
CLEAN1 |
clean |
Passed its MOT last month with no defects, taxed. |
FAIL1 |
failed_mot |
Failed its latest MOT with a dangerous defect. |
CLOCK1 |
clocked |
The latest MOT mileage is lower than the one before: a rollback. |
NOREC1 |
vehicle_not_found |
404 vehicle_not_found: no record holds the plate (a typo), nothing charged. |
ERR402 |
payment_required |
402: no credits left. |
ERR429 |
rate_limited |
429 with a Retry-After header. |
ERR503 |
server_error |
503: our side failed, nothing charged. |
X |
invalid_plate |
422 invalid_plate: not a UK registration. |
- A photo gets one of the photo cases, picked from the image, so the same image always gets the same case. The fixtures below give one image for each case.
- Viewing advice follows the plate's scenario, and the error plates,
NOREC1among them, return their error. - Sandbox calls are limited to 30 a minute per address.
Mock the API#
For tests that should not call us at all, take the answers as fixtures. No key is needed:
curl https://regtail.com/api/v1/sandbox/scenarios # every scenario: name, plate, call, description
curl https://regtail.com/api/v1/sandbox/scenarios/failed_mot # {"status": 200, "headers": {...}, "body": {...}}
Each fixture is exactly what the sandbox answers for that scenario, made by the same code, so a mock built from it stays true to the API. Save them in your test suite and replay them:
import httpx, respx
fx = httpx.get("https://regtail.com/api/v1/sandbox/scenarios/rate_limited").json()
@respx.mock
def test_backs_off_on_429():
respx.get(url__regex=r".*/api/v1/vehicles/.*").respond(fx["status"], headers=fx["headers"], json=fx["body"])
...
Errors come in the same shape as live ones (see Errors), so one handler covers both.
Use it in a linked assistant#
For a chat assistant that takes a connector URL but no key:
- Add
https://regtail.com/mcpas a custom connector, with no Authorization header. - Ask about a car. The free tools work at once, with no account.
- For a detailed report the assistant offers to link your RegTail account. Sign in, and it uses the credits on that account. It asks you before spending one.
| Tool | Needs | What it does |
|---|---|---|
free_check |
Nothing | The website's free identity, tax/MOT status and latest-test projection, with up to three questions from free facts and a verdict image |
resolve_vehicle |
Nothing | A typed plate, photo data URL or supported advert link to a plate only; otherwise a typed-plate fallback |
compare_vehicles |
Nothing | Compare two website free projections, with image and report links |
decode_plate |
Nothing | When a plate of this format could have been issued |
sample_report |
Nothing | The detailed report of the sample car |
mot_index |
Nothing | MOT statistics for a model, a make or all cars; see MOT Index |
full_report |
Linked account | The detailed report of a plate the account has unlocked, shaped for discussion: verdict, MOT history, mileage, advisories, next-MOT component evidence and budget, the viewing checklist |
unlock_report |
Linked account | The only tool that spends: one credit unlocks one plate for 30 days, as on the website. The assistant must ask the user first and pass confirmed: true |
viewing_advice |
Linked account | Advice for viewing an unlocked car |
credits_balance |
Linked account | The account's credits, and a link to how credits work |
my_reports |
Linked account | Unlocked plates and recent checks, to pick up a car checked earlier |
The credits are the ones bought on the website, and an unlock in the assistant also shows on the website. Credits are not sold inside the assistant: with none left, the tools say so and link to https://regtail.com/pricing.
Next-MOT estimates, component probabilities, repair prices, mileage analysis and older MOT details require the detailed report. Paid odds are an estimate, not an inspection. Repair ranges are indicative garage prices. Free images and questions use only the existing free fields. Only available locked sections are offered as teasers. Report links preserve the plate and plugin attribution. Free tools have per-IP limits; a rate error includes retry seconds.
For client developers#
Linking is OAuth 2.1 with PKCE. The endpoint publishes its protected-resource metadata at https://regtail.com/.well-known/oauth-protected-resource/mcp, answers a bad or expired token with 401 and a WWW-Authenticate: Bearer resource_metadata="..." challenge, and declares securitySchemes on every tool (noauth and oauth2, scope profile). A linked-only tool called without a link returns a tool error carrying _meta["mcp/www_authenticate"]. With an rt_ key the endpoint serves the five keyed tools instead.
Errors#
Every error has the same shape, over HTTP and as MCP tool errors:
{"error": {"code": "payment_required", "message": "No credits left. Top up at ...", "docs_url": "https://regtail.com/docs/agents#errors", "top_up_url": "...", "credits_remaining": 0}}
| Status | Codes | Meaning |
|---|---|---|
| 401 | unauthorized |
No key, an unknown or revoked one, or the masked label from the keys list instead of the full key. |
| 401 | invalid_token |
A linked account's access token is invalid or has expired. Link the account again. |
| 402 | payment_required |
No credits left. Nothing was charged; top_up_url opens the credit packs. |
| 402 | plan_limit |
The API plan's monthly limit is reached. Nothing was counted; write to us to raise it. |
| 404 | vehicle_not_found |
No record holds the plate: usually a typo, or a plate changed in the last few days. Nothing is charged; check the plate with the user. |
| 404 | not_found |
No such path, no such sandbox scenario, or no such MOT Index node (suggestions lists up to 5 node ids). |
| 422 | invalid_plate, invalid_image, invalid_request |
Bad input. Nothing is charged. |
| 422 | no_plate |
No plate could be read in the photo. Refunded; ask for the plate and check it by plate. |
| 429 | rate_limited |
Too many calls. Wait for the Retry-After header's seconds. |
| 5xx | records_unavailable, advice_unavailable, photo_unavailable, server_error |
Our side failed. Nothing is charged; try again later. |
What we do not check#
RegTail does not check outstanding finance, the police stolen register or the insurance write-off register: those are private databases. A report says so rather than implying a clear result, and an agent should say so too. Ask the seller for a finance settlement letter, and use a provider that holds those registers if you need them confirmed.
Use of the API is covered by our terms. Questions: support@regtail.com.