Joblogic MCP server Let your AI agent run the Joblogic office.

ToolWhat it doesAccess

• list_customers Customers and their sites, searchable by name or postcode. read

  Returns customers with ID, sites, open jobs and contract status.

  MCP calljoblogic_read → list_customers

  REST endpointGET https://cotlet.dev/api/v1/joblogic/customers

  Parameters

  Parameters: list_customers

  Name	Type	Description
  query string	string	Name or postcode.
  page integer	integer	Page number. Default: 1.

  Example response

  {
    "customers": [
      {
        "customer_id": "C-10421",
        "name": "Harrow Lettings Ltd",
        "sites": 14,
        "open_jobs": 3,
        "contract": "Planned maintenance"
      }
    ],
    "page": 1
  }

• list_jobs Jobs by status, date or engineer. read

  Returns jobs with customer, site, job type, engineer, visit date and status.

  MCP calljoblogic_read → list_jobs

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

  Parameters

  Parameters: list_jobs

  Name	Type	Description
  status string	string	Logged, Allocated, Completed, Invoiced.
  date_from string	string	ISO date.
  date_to string	string	ISO date.
  engineer string	string	Engineer name.
  page integer	integer	Page number. Default: 1.

  Example response

  {
    "jobs": [
      {
        "job_id": "J-88120",
        "customer": "Harrow Lettings Ltd",
        "site": "12 Park Row, Leeds",
        "type": "Boiler breakdown",
        "engineer": "Dan",
        "visit": "2026-11-10T09:00",
        "status": "Allocated"
      }
    ],
    "page": 1
  }

• log_job Logs a new job for a customer site. write

  Creates the job with type, priority and description, unallocated. Reaches no one, so it runs at once.

  MCP calljoblogic_write → log_job

  REST endpointPOST https://cotlet.dev/api/v1/joblogic/customers/{customer_id}/jobs

  Parameters

  Parameters: log_job

  Name	Type	Description
  customer_id string required	string	Customer ID from list_customers.
  site string required	string	Site address or name.
  type string required	string	Job type.
  description string required	string	What is wrong.
  priority string	string	Low, Normal, High.

  Example input

  {
    "customer_id": "C-10421",
    "site": "4 Mill Lane, Leeds",
    "type": "Leak",
    "description": "Leak under kitchen sink",
    "priority": "High"
  }

  Example response

  {
    "job_id": "J-88177",
    "customer": "Harrow Lettings Ltd",
    "site": "4 Mill Lane, Leeds",
    "type": "Leak",
    "priority": "High",
    "status": "Logged"
  }

ToolWhat it doesAccess

• schedule_engineer Allocates a job to an engineer for a visit. writeasks first

  Puts the visit on the planner; the engineer gets it on the Joblogic app and your settings decide whether the customer is notified. By default you confirm each call; you can switch that off for this tool.

  MCP calljoblogic_write → schedule_engineer

  REST endpointPOST https://cotlet.dev/api/v1/joblogic/jobs/{job_id}/engineer/schedule

  Parameters

  Parameters: schedule_engineer

  Name	Type	Description
  job_id string required	string	Job ID from list_jobs.
  engineer string required	string	Engineer name.
  visit string required	string	ISO date and time.

  Example input

  {
    "job_id": "job_8c41d2",
    "engineer": "engineer",
    "visit": "visit"
  }

  Example response

  {
    "job_id": "J-88177",
    "engineer": "Dan",
    "visit": "2026-11-11T08:00",
    "status": "Allocated"
  }

ToolWhat it doesAccess

• create_quote Drafts a quote for a customer site. write

  Creates the quote with lines and VAT, ready to send from Joblogic. Reaches no one, so it runs at once.

  MCP calljoblogic_write → create_quote

  REST endpointPOST https://cotlet.dev/api/v1/joblogic/customers/{customer_id}/quotes

  Parameters

  Parameters: create_quote

  Name	Type	Description
  customer_id string required	string	Customer ID from list_customers.
  site string required	string	Site.
  items array required	array	Description, quantity, price, VAT rate.

  Example input

  {
    "customer_id": "customer_8c41d2",
    "site": "site",
    "items": "items"
  }

  Example response

  {
    "quote_id": "Q-5521",
    "customer": "Harrow Lettings Ltd",
    "net": "1,240.00",
    "vat": "248.00",
    "total": "1,488.00",
    "status": "Draft"
  }

• list_unpaid_invoices Invoices with a balance, oldest first. read

  Returns unpaid invoices with customer, total and days overdue.

  MCP calljoblogic_read → list_unpaid_invoices

  REST endpointGET https://cotlet.dev/api/v1/joblogic/unpaid-invoices

  Parameters

  Parameters: list_unpaid_invoices

  Name	Type	Description
  min_days_overdue integer	integer	Only invoices overdue at least this many days.

  Example response

  {
    "invoices": [
      {
        "invoice_id": "INV-40210",
        "customer": "Northside Housing",
        "total": "2,310.00",
        "days_overdue": 24
      }
    ]
  }