CarKeeper ChatGPT MCP integration

This project connects ChatGPT to the live CarKeeper report engine.

What it exposes

• check_vehicle — runs the real CarKeeper engine for a registration.
• analyse_purchase — runs the full CarKeeper buying report with price, advert text and optional images.
• compare_vehicles — runs CarKeeper on 2–5 cars and ranks them by the Buyer Score returned by the live report.
• start_full_report_checkout — optional/private tool that creates the existing £9.99 CarKeeper WooCommerce checkout.
• get_report — optional/private tool that reads status/text for an existing paid report.

The commerce tools are disabled by default because the current public Plugin Directory form says digital-goods commerce is not supported. They can still be enabled in Developer Mode for private testing.

Architecture

ChatGPT -> MCP server -> protected CarKeeper Render endpoint -> DVLA/DVSA/Check Car Details/web/OpenAI

Optional private purchase path: ChatGPT -> MCP server -> WordPress REST bridge -> existing WooCommerce checkout/report flow

1. Patch the Render report engine

Use the supplied carkeeper-report-engine-plugin version of the backend. It keeps /generate-report unchanged for the website and adds:

POST /plugin/generate-report

This route requires:

Authorization: Bearer <CARKEEPER_PLUGIN_TOKEN>

Add CARKEEPER_PLUGIN_TOKEN to the Render service environment.

2. Configure this MCP server

Copy .env.example to .env and set the SAME CARKEEPER_PLUGIN_TOKEN value.

For public/plugin testing, leave:

CARKEEPER_ENABLE_COMMERCE_TOOLS=false

3. Install and run

npm install
npm start

The MCP endpoint is:

http://localhost:8787/mcp

4. Test locally

npx @modelcontextprotocol/inspector@latest

Connect Inspector to http://localhost:8787/mcp using Streamable HTTP.

5. Connect to ChatGPT Developer Mode

Expose port 8787 using an HTTPS tunnel such as ngrok and use:

https://YOUR-TUNNEL/mcp

as the app's MCP URL.

Optional: existing £9.99 checkout flow

Install carkeeper-chatgpt-api.php as a small WordPress plugin. Add this constant somewhere secure in WordPress configuration:

define('CK_CHATGPT_API_TOKEN', 'a-long-random-secret');

Set the same value as CARKEEPER_WP_API_TOKEN on the MCP server and set:

CARKEEPER_ENABLE_COMMERCE_TOOLS=true

for private Developer Mode testing only.

The bridge uses the existing CarKeeper report creation, checkout token restoration, £9.99 WooCommerce product and paid-report storage rather than creating a second payment system.

Security

Never commit .env, OpenAI keys, Check Car Details keys, DVLA keys or shared plugin tokens. Generate long random secrets for both shared tokens.