C Contractor+ MCP server Let your AI agent do the Contractor+ paperwork.

ToolWhat it doesAccess

• list_clients Clients, searchable by name, phone, email or address. read

  Returns clients with ID, contact details and job address. Pass the client_id to create_estimate and create_job.

  MCP callcontractor_plus_read → list_clients

  REST endpointGET https://cotlet.dev/api/v1/contractor-plus/clients

  Parameters

  Parameters: list_clients

  Name	Type	Description
  query string	string	Name, phone, email or street address.
  page integer	integer	Page number. Default: 1.

  Example response

  {
    "clients": [
      {
        "client_id": "CL-2291",
        "name": "Grace Lin",
        "phone": "555-0166",
        "email": "grace@example.com",
        "address": "9 Birch Ln, Austin, TX 78704"
      }
    ],
    "page": 1
  }

• create_client Adds a client with a job address. write

  Creates the client. Search list_clients first so a repeat customer does not become a duplicate. Reaches no one, so it runs at once.

  MCP callcontractor_plus_write → create_client

  REST endpointPOST https://cotlet.dev/api/v1/contractor-plus/clients

  Parameters

  Parameters: create_client

  Name	Type	Description
  name string required	string	Client or company name.
  phone string	string	Phone number.
  email string	string	Email.
  address string	string	Job address.

  Example input

  {
    "name": "Jane Doe"
  }

  Example response

  {
    "client_id": "CL-2340",
    "name": "Sam Okafor",
    "address": "41 Maple St, Austin, TX 78701"
  }

ToolWhat it doesAccess

• list_estimates Estimates by status or client. read

  Returns estimates with client, total and status (Draft, Sent, Approved, Declined).

  MCP callcontractor_plus_read → list_estimates

  REST endpointGET https://cotlet.dev/api/v1/contractor-plus/estimates

  Parameters

  Parameters: list_estimates

  Name	Type	Description
  status string	string	draft, sent, approved, declined or all. Default: all.
  page integer	integer	Page number. Default: 1.

  Example response

  {
    "estimates": [
      {
        "estimate_id": "E-1188",
        "client": "Grace Lin",
        "total": "6,450.00",
        "status": "Sent",
        "date": "2026-10-30"
      }
    ],
    "page": 1
  }

• create_estimate Creates a draft estimate for a client. write

  Creates the estimate from your lines with your default terms. It stays a draft until send_estimate, so it runs at once.

  MCP callcontractor_plus_write → create_estimate

  REST endpointPOST https://cotlet.dev/api/v1/contractor-plus/clients/{client_id}/estimates

  Parameters

  Parameters: create_estimate

  Name	Type	Description
  client_id string required	string	Client ID from list_clients.
  items object[] required	object[]	Lines: description, quantity, unit price.
  notes string	string	Notes or scope shown on the estimate.

  Example input

  {
    "client_id": "client_8c41d2",
    "items": [
      "items"
    ]
  }

  Example response

  {
    "estimate_id": "E-1195",
    "client": "Sam Okafor",
    "total": "3,820.00",
    "status": "Draft"
  }

• send_estimate Emails an estimate to the client for approval. writeasks first

  Sends the estimate to the client's email or the addresses you pass, with the link to approve it. By default you confirm each call; you can switch that off for this tool.

  MCP callcontractor_plus_write → send_estimate

  REST endpointPOST https://cotlet.dev/api/v1/contractor-plus/estimates/{estimate_id}

  Parameters

  Parameters: send_estimate

  Name	Type	Description
  estimate_id string required	string	Estimate number from list_estimates.
  to string[]	string[]	Recipient emails. Default: the client's email.

  Example input

  {
    "estimate_id": "E-1195"
  }

  Example response

  {
    "estimate_id": "E-1195",
    "status": "Sent",
    "sent_to": [
      "sam@example.com"
    ]
  }

• list_jobs Jobs by status, date or crew member. read

  Returns jobs with client, scheduled date, assigned crew and status.

  MCP callcontractor_plus_read → list_jobs

  REST endpointGET https://cotlet.dev/api/v1/contractor-plus/jobs

  Parameters

  Parameters: list_jobs

  Name	Type	Description
  status string	string	unscheduled, scheduled, in_progress or completed.
  date_from string	string	ISO date.
  date_to string	string	ISO date.
  page integer	integer	Page number. Default: 1.

  Example response

  {
    "jobs": [
      {
        "job_id": "J-0742",
        "client": "Grace Lin",
        "title": "Kitchen remodel",
        "scheduled": "2026-11-16",
        "crew": [
          "Luis"
        ],
        "status": "Scheduled"
      }
    ],
    "page": 1
  }

• create_job Creates a job, from an approved estimate or from scratch. write

  Creates the job with its lines, schedule date and crew. Your Contractor+ settings decide whether crew members get notified.

  MCP callcontractor_plus_write → create_job

  REST endpointPOST https://cotlet.dev/api/v1/contractor-plus/jobs

  Parameters

  Parameters: create_job

  Name	Type	Description
  estimate_id string	string	Approved estimate to copy lines from.
  client_id string	string	Client, when there is no estimate.
  title string required	string	Job title.
  scheduled string	string	ISO date.
  crew string[]	string[]	Crew member names.

  Example input

  {
    "title": "title"
  }

  Example response

  {
    "job_id": "J-0751",
    "client": "Grace Lin",
    "title": "Kitchen remodel",
    "from_estimate": "E-1188",
    "scheduled": "2026-11-16",
    "status": "Scheduled"
  }

ToolWhat it doesAccess

• list_invoices Invoices by status, with balances. read

  Returns invoices with client, total, balance and status. Use status unpaid for a collections list.

  MCP callcontractor_plus_read → list_invoices

  REST endpointGET https://cotlet.dev/api/v1/contractor-plus/invoices

  Parameters

  Parameters: list_invoices

  Name	Type	Description
  status string	string	unpaid, overdue, paid or all. Default: all.
  page integer	integer	Page number. Default: 1.

  Example response

  {
    "invoices": [
      {
        "invoice_id": "INV-0915",
        "client": "Rivera Dental",
        "total": "2,150.00",
        "balance": "2,150.00",
        "due": "2026-11-02",
        "status": "Overdue"
      }
    ],
    "page": 1
  }

• create_invoice Builds an invoice from a completed job. write

  Creates the invoice from the job lines. It stays unsent until send_invoice, so it runs at once.

  MCP callcontractor_plus_write → create_invoice

  REST endpointPOST https://cotlet.dev/api/v1/contractor-plus/jobs/{job_id}/invoices

  Parameters

  Parameters: create_invoice

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

  Example input

  {
    "job_id": "job_8c41d2"
  }

  Example response

  {
    "invoice_id": "INV-0921",
    "job_id": "J-0742",
    "total": "6,450.00",
    "status": "Draft"
  }

• send_invoice Emails an invoice to the client. writeasks first

  Sends the invoice with your payment link, if you set one up, to the client's email or the addresses you pass. By default you confirm each call; you can switch that off for this tool.

  MCP callcontractor_plus_write → send_invoice

  REST endpointPOST https://cotlet.dev/api/v1/contractor-plus/invoices/{invoice_id}

  Parameters

  Parameters: send_invoice

  Name	Type	Description
  invoice_id string required	string	Invoice number from list_invoices.
  to string[]	string[]	Recipient emails. Default: the client's email.

  Example input

  {
    "invoice_id": "invoice_8c41d2"
  }

  Example response

  {
    "invoice_id": "INV-0921",
    "status": "Sent",
    "sent_to": [
      "grace@example.com"
    ],
    "total": "6,450.00"
  }