[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup) # Checkatrade API and MCP server: Let your AI agent answer your Checkatrade enquiries. > Checkatrade has an official API, but not for members (checked 31 Oct 2026). The Affiliate API lets a partner create a job for a homeowner, and lead, booking and payment webhooks go to strategic accounts through an account manager. There is no official MCP server. Cotlet runs 13 Checkatrade tools hosted in your own login, over MCP for agents and REST for scripts. Enquiries, quotes, jobs, reviews and Opportunities Board leads for your Checkatrade member account. Use MCP with your AI agent or REST with HTTP workflows and scripts, without an account manager or a strategic account. [MCP setup](https://cotlet.dev/integrations/checkatrade-api-mcp-server.md#connect) [REST API guide](https://cotlet.dev/integrations/checkatrade-api-mcp-server.md#rest-api) - Free 7-day trial, no card - Unofficial, not affiliated with Checkatrade - Page: https://cotlet.dev/integrations/checkatrade-api-mcp-server ## What can you automate in Checkatrade? - Answer new enquiries fast - Accept or decline jobs - Follow up quotes - Send a quote - Ask finished jobs for reviews - Spot Opportunities Board leads ## Does Checkatrade have an MCP server or an API? - The Affiliate API has one job endpoint, POST /jobs, with a key and secret that Checkatrade assigns. It sends work to Checkatrade; it does not read or answer your enquiries. - The docs say webhooks are only for strategic accounts: you send a webhook URL to your account manager. They push leads, bookings and payments one way, and cannot reply, quote or ask for a review. - We found no Checkatrade MCP server on GitHub. The hosted scrapers we found read public profiles and reviews, not your own leads. | What you need | Official API and webhooks | Hosted scrapers | Cotlet | |---|---|---|---| | Read your new leads | Push webhook, strategic accounts only | Public profiles only | Yes | | Reply, accept or decline, send a quote | No | No | Yes, after your OK | | Ask a customer for a review | No | No | Yes, after your OK | | How you get access | Account manager, or affiliate key | Third-party account | Your own Checkatrade login | | Works in Claude or ChatGPT | You build it | Some run through a hosted MCP | Yes | | Allowed by Checkatrade's terms | Yes, official | Reads public pages | Uses the web app; see Terms | Checked 31 Oct 2026. Sources: [Checkatrade API for Affiliates](https://developers.checkatrade.com/docs/getting-started.md), [Checkatrade Webhooks for Trades](https://developers.checkatrade.com/docs/webhooks-for-trades.md), [Checkatrade Lead Delivery Webhooks](https://developers.checkatrade.com/reference/leads.md), [Checkatrade developer docs index](https://developers.checkatrade.com/llms.txt), [Checkatrade pricing](https://join.checkatrade.com/pricing/), [Checkatrade Acceptable Use Policy](https://www.checkatrade.com/acceptable-use-policy) ## How does Cotlet connect to Checkatrade? 1. **Sign in to Checkatrade.** Use your own account in its Cotlet Cloud Browser. 2. **Choose MCP or REST.** Connect your agent or create a Cotlet API key. 3. **Run your workflow.** Ask your agent or send an HTTP request. We never keep your Checkatrade password, and no message, quote or review request reaches a customer until you approve it. ## Connect Checkatrade to your agent or workflow Use MCP with your AI agent, or HTTP requests in n8n, Make, Zapier and scripts. Follow the MCP setup below or jump to the REST guide. 1. **Sign in to Checkatrade in a Cloud Browser.** Make a Cotlet account, open Checkatrade in its Cloud Browser, log in with your usual trade account and press Enable for agents. 2. **Add the Cotlet address.** Enter https://cotlet.dev/mcp/v1 where your agent takes an MCP server or a connector. 3. **Finish the sign-in.** Claude and ChatGPT open a Cotlet sign-in page. Cursor, Codex, n8n and scripts use an API key from the console. One address, `https://cotlet.dev/mcp/v1`, serves Checkatrade and the other apps you enable. Enabled Checkatrade after you connected? Refresh the connector so the new tools load. Claude: ``` Settings > Connectors > Add custom connector URL: https://cotlet.dev/mcp/v1/connect Claude Code: claude mcp add --transport http cotlet-checkatrade \ https://cotlet.dev/mcp/v1 \ --header "Authorization: Bearer $COTLET_API_KEY" ``` ChatGPT: ``` Settings > Apps & Connectors > Create MCP server URL: https://cotlet.dev/mcp/v1/connect Authentication: OAuth ``` Cursor: ``` // ~/.cursor/mcp.json { "mcpServers": { "cotlet-checkatrade": { "url": "https://cotlet.dev/mcp/v1", "headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" } } } } ``` Codex: ``` # ~/.codex/config.toml [mcp_servers.cotlet-checkatrade] url = "https://cotlet.dev/mcp/v1" bearer_token_env_var = "COTLET_API_KEY" ``` n8n: ``` MCP Client Tool (inside an AI Agent) Transport: HTTP Streamable URL: https://cotlet.dev/mcp/v1 Auth: Bearer, Tool: checkatrade_read ``` Make, Zapier: ``` Make: MCP Client > Call a tool Zapier: MCP Client by Zapier > Run Tool Server URL: https://cotlet.dev/mcp/v1 Token: Tool: checkatrade_write ``` ## How to use the Checkatrade REST API ### Create your Cotlet API key Create a Cotlet API key with access to Checkatrade and its read operations. Store it as `COTLET_API_KEY` in your environment or automation platform's credential store. Connect Checkatrade in Cotlet and enable it for agents. Account access: Your own Checkatrade member account (the trade login you use for the members web app). ### Make your first Checkatrade API request REST: ``` curl "https://cotlet.dev/api/v1/checkatrade/leads?unanswered=true&limit=10" \ -H "Authorization: Bearer $COTLET_API_KEY" ``` ### Read unanswered enquiries and apply the operation limits A successful REST call puts the tool output in `result`. This illustrative response excerpt omits call IDs, messages and credit details. Illustrative response excerpt: ``` { "status": "success", "app": "checkatrade", "tool": "list_leads", "result": { "leads": [ { "lead_id": "L-48213", "customer": "Dana", "title": "Boiler service", "postcode_area": "BS6", "received_at": "2026-10-30T16:20:00Z", "replied": false } ] } } ``` Returns each enquiry with its ID, customer first name, job title, postcode area, arrival time and whether you replied, newest first. Customer details come only from `get_lead`. Quote requests and direct messages both appear. Leave `unanswered` out to list every enquiry. Replace `limit` with your own. Checkatrade's webhooks push leads one way and only to strategic accounts; Cotlet reads from your signed-in session instead. When you refresh a destination, compare changed values such as `replied` as well as `lead_id`: an enquiry changes state after you answer it. ### Checkatrade workflows for agents and automations | Tool | Connect through | Example workflow | |---|---|---| | n8n | HTTP Request | Post unanswered enquiries to Slack each morning. Use `list_leads` with `unanswered` set to true on your own schedule. | | Make | HTTP > Make a request | Log sent quotes with no customer response in a sheet. Use `list_quotes` and filter on `customer_responded`. | | Python or Node.js | REST API | Build a weekly list of jobs without a review. Use `list_jobs` with `since` and print it or send it by email. | Send `Authorization: Bearer ` in request headers. You configure the schedule, destination and record comparisons. Cotlet reads Checkatrade; your workflow steps write to your chosen destination. These HTTP workflows do not require a native Cotlet connector or a prebuilt template. Python and Node.js can use the same HTTP requests without an AI agent. Keep access keys in credentials, outside shared workflow exports. The [API and MCP reference](https://cotlet.dev/integrations/checkatrade-api-mcp-server.md#tools) lists operations and inputs. The [REST API guide](https://cotlet.dev/docs/api.md) explains authentication, errors and approvals. ## Checkatrade API endpoints and MCP tools ### Enquiries and notes Enquiries come from the Messages page, newest first. Accept and decline work as the same actions do there. Notes are private and skip the confirmation. - **List leads** (`list_leads`, read): List customer enquiries from the Messages page of your Checkatrade account. - **Get lead** (`get_lead`, read): Read one enquiry with the message, customer details and your notes. - **Reply to lead** (`reply_to_lead`, write, asks first): Send a message to the customer of an enquiry. - **Accept job** (`accept_lead`, write, asks first): Accept the job of an enquiry. - **Decline job** (`decline_lead`, write, asks first): Decline the job of an enquiry. - **Add lead note** (`add_lead_note`, write): Add a private note to an enquiry. ### Quotes A sent quote cannot be recalled, so sending asks first. Listing shows whether the customer has responded. - **List quotes** (`list_quotes`, read): List the quotes you sent, with the state of each. - **Send quote** (`send_quote`, write, asks first): Send a quote for an enquiry from the quoting tool. ### Jobs and reviews The jobs list is the one you use to request a review. The request goes out by email and text. - **List jobs** (`list_jobs`, read): List your recent jobs with the review status of each. - **List reviews** (`list_reviews`, read): List the reviews customers left on your Checkatrade profile. - **Request review** (`request_review`, write, asks first): Ask the customer of a job for a review. ### Opportunities Board Browsing the board is free. Unlocking a lead is the paid step, so it always asks first. - **List Opportunities Board** (`list_opportunities`, read): List open leads on the Opportunities Board for your area and trade. - **Unlock Opportunities Board lead** (`unlock_opportunity`, write, asks first): Unlock an Opportunities Board lead so you can respond to it. Inputs, REST path and example response of every tool: https://cotlet.dev/integrations/checkatrade-api-mcp-server#tools ## Who can see my Checkatrade session, and how do I revoke it? - **What we store.** Your signed-in Checkatrade profile, AES-256-GCM, in Finland. Not your password. - **What your agent gets.** The 13 Checkatrade tools. No cookie, no API key. - **What the session sees.** The enquiries, quotes, jobs and reviews your member account opens. - **What no tool touches.** Plan and billing, Checkatrade Pay, bank details and account settings. - **If Checkatrade logs you out.** Your agent gets a link and you log in again. We never log in for you. - **How to cut access.** Disable Checkatrade for agents, reset the browser or delete the API key. Our site scores A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory ([live results](https://cotlet.dev/security.md)); no SOC 2 report or third-party pentest yet. ## Is it against Checkatrade's terms? Account safety > You may not use our app: ... to reverse engineer, decompile, dissemble, decipher or otherwise derive the code used within the app; to reproduce, duplicate, copy, sub-licence, broadcast, distribute, sell, re-brand or re-sell any part of the app (without our express consent). > > [Checkatrade Acceptable Use Policy, last updated June 2024 (Wayback Machine copy of 10 Aug 2025)](https://web.archive.org/web/20250810134858/https://www.checkatrade.com/acceptable-use-policy) The live terms pages answered 403 when we checked on 31 Oct 2026, so we read the archived policy. It names no bots, scraping or AI agents. It lets Checkatrade deactivate an account that breaches it, and trade members are also bound by a Membership Contract we have not read. We found no public case of a member account closed for automation. How we keep your account looking like you: - Your own member account, logged in by you - One Cloud Browser with its own IP and cookies - Messages, quotes and review requests wait for your OK - No tool touches billing, Checkatrade Pay or account settings - If Checkatrade objects, we pause the Checkatrade tools for everyone within 24 h > Read the Membership Contract yourself before you connect. Keep each message tied to one customer and one enquiry; the policy bars spam. ## What happens when Checkatrade changes? - **12 h** between tests of the Checkatrade reads - **$0** for a call to a Checkatrade tool paused for repair Checkatrade added the Opportunities Board in summer 2026, so its screens are still moving. If it moves a screen or renames a field in Messages, Quotes or Reviews, we change the tool and the same prompt keeps working. [status.cotlet.dev](https://status.cotlet.dev) watches the site, console and API every 3 minutes. ## Approvals, undo and mistakes 1. **Lists open enquiries.** With the customer first name, job and how long each has waited. 2. **Checks your rules.** Distance, trade, days and prices you put in the prompt. 3. **Waits for your OK.** Each reply, quote or review request shows up in your Cotlet console first. 4. **Reports back.** What was sent, accepted, declined or left for you. | Action | Undo | |---|---| | Reply to an enquiry | No; the customer has it | | Send a quote | Not through Cotlet; the customer has it | | Request a review | No; the request goes out by email and text | | Accept or decline a job | Not through Cotlet; use the Messages page | | Unlock a board lead | No; Checkatrade charges when you respond | | Add a note | Yes, delete it in the Messages page | | Every read | Nothing to undo; reads change nothing | 6 of 13 tools ask first: every write except the private note, because each one reaches a customer or costs money. Turn the wait off per tool for a scheduled run you trust. > Checkatrade does not publish the price of unlocking a board lead, so read the price in the Opportunities Board before you approve. MCP call: ``` { "name": "reply_to_lead", "arguments": { "lead_id": "L-48213", "text": "Hi Dana, I can service the boiler on Tuesday afternoon. Does 2 pm suit you?" } } ``` REST: ``` curl -X POST https://cotlet.dev/api/v1/checkatrade/leads/L-48213/replies \ -H "Authorization: Bearer $COTLET_API_KEY" \ -H "Content-Type: application/json" \ -d '{"text":"Hi Dana, I can service the boiler on Tuesday afternoon. Does 2 pm suit you?"}' ``` Response: ``` { "lead_id": "L-48213", "status": "sent", "sent_at": "2026-10-31T08:15:00Z" } ``` Scripts and cron jobs reach the same tools over REST at `/api/v1/checkatrade`, with one key and one price. A write waits for your approval and answers `202` with status `pending` until you decide. The tools table lists the REST path of each tool. ## How much does the Checkatrade MCP server cost? **About $18 a month** for a sole trader, 3,060 credits. Your Checkatrade plan stays as it is. | Job | Calls | Credits | |---|---|---| | Unanswered enquiries and their details, daily | 2 × 30 | 600 | | Replies and notes to enquiries, weekly | 4 × 4 | 160 | | Quotes without an answer, daily | 1 × 30 | 300 | | Sending quotes, weekly | 2 × 4 | 80 | | Review requests for finished jobs, weekly | 3 × 4 | 120 | | Opportunities Board, daily | 1 × 30 | 300 | | Cloud Browser, 30 days | | 1,500 | | Total | | 3,060 | - Free 7-day trial, no card - 10 credits per successful call, MCP or REST - 50 credits a day for the Cloud Browser - No Checkatrade API access needed The month is our example: a sole trader on Checkatrade's Approved plan, listed at £30 a month on its pricing page (31 Oct 2026), with daily checks. Checkatrade states no enquiry counts per plan, and the price of unlocking a board lead is not published. Dollars at the $29 pack rate. ## Checkatrade MCP server or the web app: which to use | Option | What it does | Where it stops | |---|---|---| | Checkatrade web app and Trades app | Messages, quotes, review requests and the Opportunities Board, with alerts for new enquiries. | You open it yourself; no agent, no schedule. | | Checkatrade webhooks | Push new leads, bookings and payments into your CRM. | Strategic accounts only, through an account manager; one way. | | Hosted scrapers | Collect public profiles, ratings and reviews of UK trades. | They do not see your own enquiries and cannot reply. | If you have a strategic account, the webhooks push leads into your own system. Cotlet fits a sole trader or small firm without one: it works in your own Checkatrade login and puts everything a customer sees behind your OK. ## Who runs Cotlet Cotlet belongs to Take Group sp. z o.o., a software company registered in Poland, EU (VAT PL6342984273) and trading since 2019. Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing) founded it. Write to contact@cotlet.dev with questions about the Checkatrade tools. ## Checkatrade API and MCP: questions ### How do I get access? Sign up free at https://cotlet.dev, open Checkatrade under Integrations in the console and log in to Checkatrade in its Cloud Browser. The trial starts with your first app and needs no card. ### How do I connect Checkatrade to ChatGPT or Claude? Sign up at cotlet.dev, log in to Checkatrade once in its Cloud Browser and add Cotlet to ChatGPT or Claude, following the steps in your console. No API key is needed. ChatGPT and Claude then work in your Checkatrade account through Cotlet, in their phone apps too. ### What can ChatGPT do in Checkatrade? With Cotlet, ChatGPT, Claude and other AI agents handle jobs like these in Checkatrade: answer new enquiries fast; accept or decline jobs; send quotes and follow up. You ask in plain words, and anything that reaches other people waits for your OK first. ### Do I need a paid Checkatrade plan? You need a Checkatrade member account that opens the Messages page. Checkatrade lists a free plan at 0, Approved at 30 pounds a month and Growth from 59 pounds a month (join.checkatrade.com/pricing, checked 31 Oct 2026); which plan shows leads is for Checkatrade to say. ### Does Checkatrade have webhooks? Yes, for strategic accounts only: lead, booking and payment webhooks that you set up with your account manager (checked 31 Oct 2026). Without one, run your agent on a schedule, for example a daily list_leads. ### Does it show the Opportunities Board? Yes. list_opportunities browses the board, which Checkatrade makes free to browse. unlock_opportunity is the step Checkatrade charges for, so it always asks first. ### Is the MCP server different from the REST API? Only the way in. Both carry the same 13 tools, inputs and answers, with one API key and one price. Agents use MCP; scripts and HTTP steps use REST. ### Is Cotlet affiliated with Checkatrade? No. Cotlet is independent and not affiliated with Checkatrade Ltd or Vetted Limited. ### Can I use the Checkatrade API without an AI agent? Yes. Call Cotlet's REST API from a script or an HTTP step in n8n, Make or Zapier with your Cotlet key. MCP is the alternative for AI agents; you do not need to connect an agent to use REST. --- Give your AI agents your signed-in browser. **Product:** [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md) **Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet) **Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) **Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md) **Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors) **Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet) Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. [About us](https://cotlet.dev/about.md) Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.