Checkatrade MCP Server

Leads, quotes, reviews and Opportunities Board for Checkatrade members.

Máy chủ MCP được lưu trữ

npx add-mcp 'https://cotlet.dev/mcp/v1/checkatrade'

Cài vào Claude Code, Codex, Cursor và nhiều công cụ khác

Tài liệu

Cotlet · Integrations · How it works · Security · For developers · For automation agencies · Blog · API docs · Help center · Changelog · Contact · Pricing · Sign up

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 REST API guide

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 needOfficial API and webhooksHosted scrapersCotlet
Read your new leadsPush webhook, strategic accounts onlyPublic profiles onlyYes
Reply, accept or decline, send a quoteNoNoYes, after your OK
Ask a customer for a reviewNoNoYes, after your OK
How you get accessAccount manager, or affiliate keyThird-party accountYour own Checkatrade login
Works in Claude or ChatGPTYou build itSome run through a hosted MCPYes
Allowed by Checkatrade's termsYes, officialReads public pagesUses the web app; see Terms

Checked 31 Oct 2026. Sources: Checkatrade API for Affiliates, Checkatrade Webhooks for Trades, Checkatrade Lead Delivery Webhooks, Checkatrade developer docs index, Checkatrade pricing, Checkatrade 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, <your key>
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: <your key>
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

ToolConnect throughExample workflow
n8nHTTP RequestPost unanswered enquiries to Slack each morning. Use list_leads with unanswered set to true on your own schedule.
MakeHTTP > Make a requestLog sent quotes with no customer response in a sheet. Use list_quotes and filter on customer_responded.
Python or Node.jsREST APIBuild a weekly list of jobs without a review. Use list_jobs with since and print it or send it by email.

Send Authorization: Bearer <your Cotlet API key> 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 lists operations and inputs. The REST API guide 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); 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)

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 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.
ActionUndo
Reply to an enquiryNo; the customer has it
Send a quoteNot through Cotlet; the customer has it
Request a reviewNo; the request goes out by email and text
Accept or decline a jobNot through Cotlet; use the Messages page
Unlock a board leadNo; Checkatrade charges when you respond
Add a noteYes, delete it in the Messages page
Every readNothing 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.

JobCallsCredits
Unanswered enquiries and their details, daily2 × 30600
Replies and notes to enquiries, weekly4 × 4160
Quotes without an answer, daily1 × 30300
Sending quotes, weekly2 × 480
Review requests for finished jobs, weekly3 × 4120
Opportunities Board, daily1 × 30300
Cloud Browser, 30 days1,500
Total3,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

OptionWhat it doesWhere it stops
Checkatrade web app and Trades appMessages, quotes, review requests and the Opportunities Board, with alerts for new enquiries.You open it yourself; no agent, no schedule.
Checkatrade webhooksPush new leads, bookings and payments into your CRM.Strategic accounts only, through an account manager; one way.
Hosted scrapersCollect 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.

Also listed on: Odel, mcpbeat

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 when you sign up 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 · How it works · Pricing · Security

Resources: Blog · API docs · Help center · Changelog · GitHub

Solutions: For developers · For automation agencies

Company: About · AI info: company facts · Contact

Legal: Terms of service · Privacy policy · Refund policy · Acceptable use · Cookie policy · DPA · Subprocessors

Elsewhere: Status page · Cotlet on GitHub · Cotlet on X · Cotlet on LinkedIn · Cotlet on Product Hunt · Cotlet on Crunchbase · Cotlet on SaaSHub

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

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.