Use DealerPricing from your AI assistant
The DealerPricing MCP server connects Claude, ChatGPT, Cursor and other AI assistants to your account. Ask for a trade valuation, comparables, MOT history, the manufacturer's service record or a vehicle history check by registration, in plain English, and the assistant uses the same tools and the same allowances as the dashboard.
Included with Pro 100 and Pro 200. Searches come off your monthly allowance exactly as they do on the dashboard; the only paid tool asks before charging.
Connect in two minutes
Everything starts with a token from Profile → AI assistants (Pro plans). It is shown once as a private connector URL of the form https://www.dealerpricing.co.uk/api/mcp/dp_mcp_YOUR_TOKEN, which Claude and ChatGPT accept without any sign-in step. Treat it like a password.
Claude (Desktop, claude.ai and mobile): sign in
The quickest way. Nothing to copy: you sign in to DealerPricing and approve the connection.
- In Claude, open Settings → Connectors (Desktop: click your initials at the bottom left; claude.ai: profile menu → Settings).
- Click Add custom connector. Name it DealerPricing and enter https://www.dealerpricing.co.uk/api/mcp as the URL. Leave the fields under Advanced empty, then click Add.
- Click Connect. A DealerPricing window opens: sign in with your usual email and password, check what the assistant will be able to do, and click Allow.
- In a new chat, open the + / Connectors menu, switch DealerPricing on, and ask: "What should I bid for AB12 CDE at 48,000 miles?"
- To disconnect later, open Profile → AI assistants → Connected apps and click Disconnect.
ChatGPT: sign in
Needs a ChatGPT Plus, Pro, Business or Enterprise plan with Developer mode switched on.
- In ChatGPT, open Settings → Apps & Connectors → Advanced settings and turn on Developer mode.
- Back in Connectors, click Create. Name: DealerPricing. Description: UK vehicle valuations, comparables, MOT and service history by registration.
- Enter https://www.dealerpricing.co.uk/api/mcp as the MCP server URL, leave Authentication on OAuth, tick the trust box and click Create.
- A DealerPricing window opens: sign in with your usual email and password and click Allow.
- In a new chat, click + → More → Developer mode, enable DealerPricing, and ask: "Value AB12 CDE at 48,000 miles and show the five nearest comparables."
Claude or ChatGPT with a private connector URL
The alternative to signing in, and the way to let an assistant run paid vehicle history checks from your balance (sign-in connections are look-up only).
- Create a token in Profile → AI assistants and copy the connector URL it shows. Treat it like a password.
- Add a custom connector as above, but paste the connector URL instead of the address. In Claude leave the OAuth fields empty; in ChatGPT set Authentication to No authentication.
- It shows as connected immediately. Revoke the token in Profile → AI assistants to switch it off.
Claude Code
One command in your terminal, using the bearer-header form of the endpoint.
- Run the command below, then ask for a registration in a Claude Code session.
claude mcp add --transport http dealerpricing https://www.dealerpricing.co.uk/api/mcp --header "Authorization: Bearer dp_mcp_YOUR_TOKEN"
Cursor, Windsurf and other clients
Any client with the Streamable HTTP transport. Use the connector URL with no authentication, or the plain endpoint with a bearer header.
- Open the client's MCP settings, add a server and paste the configuration below.
{
"mcpServers": {
"dealerpricing": {
"url": "https://www.dealerpricing.co.uk/api/mcp/dp_mcp_YOUR_TOKEN"
}
}
}Tools and what they cost
Every tool tells the assistant its cost, and every result carries your remaining searches. "One search" means one search from your monthly allowance; a registration you have already searched this billing period is never charged again.
| Tool | What it returns | Cost |
|---|---|---|
search_vehicle | Decode a registration or VIN: valuation bands, tax and MOT status, market insights and the first comparable listings. | One search (free if the registration was searched this billing period) |
get_comparables | Up to 100 live comparable listings with price, mileage, dealer, days listed and distance, plus the total on the market. | Free for a registration already searched; otherwise one search |
get_mot_history | Every MOT test with result, mileage, expiry, advisories and failures. | Free |
get_vehicle_spec | Factory-fitted options and specification. | Free for a registration already searched; otherwise one search |
get_dp_retail_valuation | DP Retail valuation at a given mileage with confidence. | Free for a registration already searched; otherwise one search |
get_service_history | Manufacturer digital service records; instant when a result from the last 14 days exists, otherwise a request id to poll. | Included with Pro; one search per vehicle; 20 new requests a day |
get_service_history_status | Poll a service history request. | Free |
check_vehicle_history | Stolen, finance, write-off, scrapped, import/export, mileage, keeper, plate and colour markers with MOT history. Quotes first; runs only after you confirm. | £2.50 from your balance; a report from the last six months is free |
list_my_stock | Your own live listings, as the My Stock page shows them. | Free |
get_recent_searches | Your recent registration searches. | Free |
get_account_usage | Plan, searches used and remaining, balance and limits. | Free |
Things to ask
"What should I bid for KX68 TRV at 61,000 miles? Show the trade bands and days to sell."
"Appraise this part-exchange: LL71 ZHP, 24,000 miles. Include MOT advisories and the service record."
"Which of my stock has been listed longest and is priced above the comparables?"
"Run a vehicle history check on AK67 GVC." The assistant quotes £2.50 and waits for your yes.
Limits and safety
Tokens are stored hashed, shown once, revocable instantly, and limited to five active per account. Read-only tokens can never spend your balance; full-access tokens carry their own daily and per-minute limits on paid checks.
Per token: 30 calls a minute and 500 a day; paid checks 60 a day. Service history: 20 new requests a day.
Every call is logged against the token so you can see what an assistant did and when.
Data returned never includes our data providers' names or bookkeeping fields, and listing text is passed to the assistant as plain data.
Building software rather than using an assistant? The Developer API offers the same data with per-call billing; MCP access with API keys follows in a later release.
How to connect an AI assistant to DealerPricing
Create a token, add the DealerPricing MCP server to your assistant, and ask for valuations, comparables and checks by registration.
- 1
Create a token
Go to Profile → AI assistants, name the token after the assistant you will use, choose full or read-only access, and copy the token - it is shown once.
- 2
Add the server to your assistant
Claude: Settings → Connectors → Add custom connector, paste the connector URL. ChatGPT: turn on Developer mode, then Connectors → Create with the connector URL and no authentication. Other clients take the URL or the bearer-header form.
- 3
Ask a question
For example: "What should I bid for AB12 CDE at 48,000 miles?" The assistant calls search_vehicle and answers with the trade bands, comparables and your remaining searches.
- 4
Confirm before paid checks
A vehicle history check costs £2.50 from your balance. The assistant shows the price and balance first and only runs the check when you say yes.
DealerPricing MCP - questions answered
What is the DealerPricing MCP?
MCP (Model Context Protocol) is the open standard AI assistants use to call external tools. The DealerPricing MCP server lets Claude, ChatGPT, Cursor and other MCP clients use your DealerPricing account: you ask in plain English and the assistant calls the same valuation, comparables, MOT, service history and vehicle history tools the dashboard uses.
Who can use it?
Pro 100 and Pro 200 subscribers, including team members on their own Pro plan. Basic plans see an upgrade option in Profile → AI assistants. Developer API customers on a paid plan will be able to use the same server with their API key in a later release.
Does a search through an assistant count against my monthly allowance?
Yes, exactly as on the dashboard: a registration you have not searched this billing period uses one search; the same registration again is free. Follow-up tools for a registration you have already searched (comparables, specification, DP Retail) are free; MOT history is always free. Every tool returns your remaining searches.
Is service history included?
Yes. Service history checks are included with Pro. A request counts as one search per vehicle (free if you already searched that registration), and there is a fair-use limit of 20 new requests a day. Results from the last 14 days are returned immediately.
Can an assistant spend money without asking?
No. The only paid tool is the vehicle history check (£2.50 from your balance). The assistant must call it once without confirmation, which returns the price and your balance, and again with confirmation after you agree. Read-only tokens cannot run it at all, each full-access token has its own limit on paid checks (you choose it when you create the token: 5 a minute and 20 a day unless you set lower or higher, up to 6 and 60), and a report bought in the last six months is returned free.
How do I connect Claude?
In Claude Desktop, claude.ai or the mobile app open Settings → Connectors → Add custom connector, name it DealerPricing and enter https://www.dealerpricing.co.uk/api/mcp as the URL. Click Connect, sign in to DealerPricing with your usual email and password, and click Allow. Switch it on in a chat and ask for a registration. There is no config file and nothing to copy. A private connector URL (created in Profile → AI assistants) is the alternative if you prefer not to sign in.
How do I connect ChatGPT?
ChatGPT needs Developer mode (Settings → Apps & Connectors → Advanced settings) on a Plus, Pro, Business or Enterprise plan. Then Connectors → Create: name it DealerPricing, enter https://www.dealerpricing.co.uk/api/mcp as the MCP server URL, leave Authentication on OAuth, tick the trust box and create it. Sign in to DealerPricing in the window that opens and click Allow, then enable it in a chat under + → More → Developer mode.
Is the connector URL safe?
The URL contains your token, so treat it like a password: anyone with it can use your account's allowances until you revoke the token. Tokens are stored hashed, shown once at creation, revocable instantly from your profile, and the profile shows when and from which client each was last used. Use a read-only token wherever you do not need paid checks, and keep the paid-check limits on a full token as low as you need. Every request and every change to a token is recorded with the IP address it came from and kept for six months, so a leaked or shared token can be traced. Up to five tokens can be active.
Should I sign in or use a connector URL?
Sign in if you can: it is quicker, there is no secret to look after, and you can disconnect the assistant from Profile → AI assistants → Connected apps at any time. Connections made by signing in are look-up only: they can search and read, but can never spend your balance. Use a private connector URL (or a bearer token) for clients that cannot sign in, such as a command-line tool, or when you want an assistant to be able to run a paid vehicle history check after you confirm it.
What does an assistant get access to when I click Allow?
Vehicle look-ups by registration (valuations, specification, tax and MOT status, comparable listings, MOT and service history), your live stock, your recent searches and your remaining search allowance. It never receives your password, card details or the ability to spend your balance or change your account, and we never see your conversation with the assistant, only the specific request it sends. Access tokens last one hour and renew automatically; disconnecting stops access immediately.