Checkatrade API and MCP server Let your AI agent answer your Checkatrade enquiries.

ToolWhat it doesAccess

• list_leads List customer enquiries from the Messages page of your Checkatrade account. read

  Returns each enquiry with its ID, the customer first name, the job title, the postcode area, when it arrived and whether you replied, newest first. Customers who used Request a quote and direct messages both appear. Reading does not change the enquiry.

  MCP callcheckatrade_read → list_leads

  REST endpointGET https://cotlet.dev/api/v1/checkatrade/leads

  Parameters

  Parameters: list_leads

  Name	Type	Description
  unanswered boolean	boolean	Only enquiries you have not replied to.
  limit integer	integer	Maximum enquiries to return.

  Example response

  {
    "leads": [
      {
        "lead_id": "L-48213",
        "customer": "Dana",
        "title": "Boiler service",
        "postcode_area": "BS6",
        "received_at": "2026-10-30T16:20:00Z",
        "replied": false
      },
      {
        "lead_id": "L-48190",
        "customer": "Tom",
        "title": "Fence repair",
        "postcode_area": "BS7",
        "received_at": "2026-10-28T09:05:00Z",
        "replied": false
      }
    ]
  }

• get_lead Read one enquiry with the message, customer details and your notes. read

  Returns the customer message, their contact details, the job description and the notes you saved on the enquiry. It reads the same page you open from Messages.

  MCP callcheckatrade_read → get_lead

  REST endpointGET https://cotlet.dev/api/v1/checkatrade/leads/{lead_id}

  Parameters

  Parameters: get_lead

  Name	Type	Description
  lead_id string required	string	Lead ID from list_leads.

  Example input

  {
    "lead_id": "lead_8c41d2"
  }

  Example response

  {
    "lead_id": "L-48213",
    "customer": "Dana",
    "title": "Boiler service",
    "message": "Annual service on a combi boiler, any day next week.",
    "postcode": "BS6 6XX",
    "phone": "07700 900123",
    "notes": []
  }

• reply_to_lead Send a message to the customer of an enquiry. writeasks first

  Sends the message in the enquiry thread, and the customer receives it. It cannot be recalled. By default you confirm each call; you can switch that off for this tool.

  MCP callcheckatrade_write → reply_to_lead

  REST endpointPOST https://cotlet.dev/api/v1/checkatrade/leads/{lead_id}/replies

  Parameters

  Parameters: reply_to_lead

  Name	Type	Description
  lead_id string required	string	Lead ID from list_leads.
  text string required	string	Message text.

  Example input

  {
    "lead_id": "L-48213",
    "text": "Hi Dana, I can service the boiler on Tuesday afternoon. Does 2 pm suit you?"
  }

  Example response

  {
    "lead_id": "L-48213",
    "status": "sent",
    "sent_at": "2026-10-31T08:15:00Z"
  }

• accept_lead Accept the job of an enquiry. writeasks first

  Accepts the job in the Messages page, as the Accept action there does. Checkatrade does not publish what the customer sees next, so the tool asks first. By default you confirm each call; you can switch that off for this tool.

  MCP callcheckatrade_write → accept_lead

  REST endpointPOST https://cotlet.dev/api/v1/checkatrade/leads/{lead_id}/accept

  Parameters

  Parameters: accept_lead

  Name	Type	Description
  lead_id string required	string	Lead ID from list_leads.

  Example input

  {
    "lead_id": "lead_8c41d2"
  }

  Example response

  {
    "lead_id": "L-48213",
    "status": "accepted"
  }

• decline_lead Decline the job of an enquiry. writeasks first

  Declines the job in the Messages page, as the Decline action there does. Checkatrade does not publish what the customer sees next, so the tool asks first. By default you confirm each call; you can switch that off for this tool.

  MCP callcheckatrade_write → decline_lead

  REST endpointPOST https://cotlet.dev/api/v1/checkatrade/leads/{lead_id}/decline

  Parameters

  Parameters: decline_lead

  Name	Type	Description
  lead_id string required	string	Lead ID from list_leads.

  Example input

  {
    "lead_id": "lead_8c41d2"
  }

  Example response

  {
    "lead_id": "L-48190",
    "status": "declined"
  }

• add_lead_note Add a private note to an enquiry. write

  Saves a note on the enquiry that only you see. It reaches no one and you can delete it in the Messages page, so it skips the confirmation.

  MCP callcheckatrade_write → add_lead_note

  REST endpointPOST https://cotlet.dev/api/v1/checkatrade/leads/{lead_id}/note

  Parameters

  Parameters: add_lead_note

  Name	Type	Description
  lead_id string required	string	Lead ID from list_leads.
  text string required	string	Note text.

  Example input

  {
    "lead_id": "lead_8c41d2",
    "text": "text"
  }

  Example response

  {
    "lead_id": "L-48190",
    "status": "saved"
  }

ToolWhat it doesAccess

• list_quotes List the quotes you sent, with the state of each. read

  Returns each quote with its ID, the lead it belongs to, the total, the date sent and whether the customer has responded. Checkatrade lets you follow a quote after it is sent.

  MCP callcheckatrade_read → list_quotes

  REST endpointGET https://cotlet.dev/api/v1/checkatrade/quotes

  Parameters

  Parameters: list_quotes

  Name	Type	Description
  limit integer	integer	Maximum quotes to return.

  Example response

  {
    "quotes": [
      {
        "quote_id": "Q-330",
        "lead_id": "L-48190",
        "total": 420,
        "currency": "GBP",
        "sent_at": "2026-10-29",
        "customer_responded": false
      }
    ]
  }

• send_quote Send a quote for an enquiry from the quoting tool. writeasks first

  Creates the quote with the scope, price and notes you give and sends it to the customer. Costs, time, scope and tax are fields of the quoting tool; this tool fills the scope, total and notes. A sent quote cannot be recalled. By default you confirm each call; you can switch that off for this tool.

  MCP callcheckatrade_write → send_quote

  REST endpointPOST https://cotlet.dev/api/v1/checkatrade/leads/{lead_id}/quotes

  Parameters

  Parameters: send_quote

  Name	Type	Description
  lead_id string required	string	Lead ID from list_leads.
  description string required	string	Scope of work.
  total number required	number	Total price in GBP.
  notes string	string	Notes for the customer.

  Example input

  {
    "lead_id": "lead_8c41d2",
    "description": "description",
    "total": 1
  }

  Example response

  {
    "quote_id": "Q-331",
    "lead_id": "L-48213",
    "total": 95,
    "currency": "GBP",
    "status": "sent"
  }

ToolWhat it doesAccess

• list_jobs List your recent jobs with the review status of each. read

  Returns each job with its ID, customer first name, title, date and whether a review request was sent or a review came in. It is the recent jobs list you use in the Reviews section.

  MCP callcheckatrade_read → list_jobs

  REST endpointGET https://cotlet.dev/api/v1/checkatrade/jobs

  Parameters

  Parameters: list_jobs

  Name	Type	Description
  since string	string	Earliest date, YYYY-MM-DD.

  Example response

  {
    "jobs": [
      {
        "job_id": "J-2210",
        "customer": "Priya",
        "title": "Bathroom refit",
        "date": "2026-10-22",
        "review_requested": false,
        "review_received": false
      },
      {
        "job_id": "J-2204",
        "customer": "Sam",
        "title": "Radiator swap",
        "date": "2026-10-19",
        "review_requested": true,
        "review_received": false
      }
    ]
  }

• list_reviews List the reviews customers left on your Checkatrade profile. read

  Returns each review with its date, rating, the job it belongs to and the customer text, newest first. Reading changes nothing on your profile.

  MCP callcheckatrade_read → list_reviews

  REST endpointGET https://cotlet.dev/api/v1/checkatrade/reviews

  Parameters

  Parameters: list_reviews

  Name	Type	Description
  limit integer	integer	Maximum reviews to return.

  Example response

  {
    "reviews": [
      {
        "review_id": "R-901",
        "job_id": "J-2198",
        "date": "2026-10-25",
        "rating": 10,
        "text": "Neat work and on time."
      }
    ]
  }

• request_review Ask the customer of a job for a review. writeasks first

  Sends the review request, which goes out by email and text, as Request Review does in the Reviews section. The customer receives it, so it cannot be recalled. By default you confirm each call; you can switch that off for this tool.

  MCP callcheckatrade_write → request_review

  REST endpointPOST https://cotlet.dev/api/v1/checkatrade/jobs/{job_id}/review/request

  Parameters

  Parameters: request_review

  Name	Type	Description
  job_id string required	string	Job ID from list_jobs.

  Example input

  {
    "job_id": "job_8c41d2"
  }

  Example response

  {
    "job_id": "J-2210",
    "status": "requested"
  }

ToolWhat it doesAccess

• list_opportunities List open leads on the Opportunities Board for your area and trade. read

  Returns each lead with its ID, job title, area and age. Browsing the board is free; contact details stay hidden until you unlock a lead with unlock_opportunity.

  MCP callcheckatrade_read → list_opportunities

  REST endpointGET https://cotlet.dev/api/v1/checkatrade/opportunities

  Parameters

  Parameters: list_opportunities

  Name	Type	Description
  limit integer	integer	Maximum leads to return.

  Example response

  {
    "opportunities": [
      {
        "opportunity_id": "O-7731",
        "title": "Kitchen tap replaced",
        "area": "Bristol",
        "posted_at": "2026-10-31T07:40:00Z"
      },
      {
        "opportunity_id": "O-7729",
        "title": "Gas safety certificate",
        "area": "Bath",
        "posted_at": "2026-10-30T18:10:00Z"
      }
    ]
  }

• unlock_opportunity Unlock an Opportunities Board lead so you can respond to it. writeasks first

  Checkatrade charges only when you respond to a board lead, and the price is not published, so the tool asks first. It shows the customer details after unlocking. A lead comes off the board once 3 trades have unlocked it. By default you confirm each call; you can switch that off for this tool.

  MCP callcheckatrade_write → unlock_opportunity

  REST endpointPOST https://cotlet.dev/api/v1/checkatrade/opportunities/{opportunity_id}/unlock

  Parameters

  Parameters: unlock_opportunity

  Name	Type	Description
  opportunity_id string required	string	Opportunity ID from list_opportunities.

  Example input

  {
    "opportunity_id": "opportunity_8c41d2"
  }

  Example response

  {
    "opportunity_id": "O-7731",
    "status": "unlocked",
    "lead_id": "L-48240"
  }