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.

  1. In Claude, open Settings → Connectors (Desktop: click your initials at the bottom left; claude.ai: profile menu → Settings).
  2. 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.
  3. 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.
  4. In a new chat, open the + / Connectors menu, switch DealerPricing on, and ask: "What should I bid for AB12 CDE at 48,000 miles?"
  5. 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.

  1. In ChatGPT, open Settings → Apps & Connectors → Advanced settings and turn on Developer mode.
  2. Back in Connectors, click Create. Name: DealerPricing. Description: UK vehicle valuations, comparables, MOT and service history by registration.
  3. Enter https://www.dealerpricing.co.uk/api/mcp as the MCP server URL, leave Authentication on OAuth, tick the trust box and click Create.
  4. A DealerPricing window opens: sign in with your usual email and password and click Allow.
  5. 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).

  1. Create a token in Profile → AI assistants and copy the connector URL it shows. Treat it like a password.
  2. 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.
  3. 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.

  1. 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.

  1. 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.

ToolWhat it returnsCost
search_vehicleDecode 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_comparablesUp 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_historyEvery MOT test with result, mileage, expiry, advisories and failures.Free
get_vehicle_specFactory-fitted options and specification.Free for a registration already searched; otherwise one search
get_dp_retail_valuationDP Retail valuation at a given mileage with confidence.Free for a registration already searched; otherwise one search
get_service_historyManufacturer 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_statusPoll a service history request.Free
check_vehicle_historyStolen, 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_stockYour own live listings, as the My Stock page shows them.Free
get_recent_searchesYour recent registration searches.Free
get_account_usagePlan, 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. 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. 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. 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. 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.