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

ToolWhat it doesAccess

• list_customers Customers, searchable by name, phone, address or account number. read

  Returns customers with ID, service address, active subscriptions and balance. Pass the customer_id to the other tools.

  MCP callfieldroutes_read → list_customers

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

  Parameters

  Parameters: list_customers

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

  Example response

  {
    "customers": [
      {
        "customer_id": "104822",
        "name": "Dale Whitaker",
        "address": "2214 Peachtree Ln, Marietta, GA",
        "subscriptions": [
          "Quarterly pest"
        ],
        "balance": "0.00"
      }
    ],
    "page": 1
  }

• get_customer One customer with subscriptions, appointments, tickets and notes. read

  Returns the customer record: subscriptions with next service date, past and upcoming appointments, open tickets and notes.

  MCP callfieldroutes_read → get_customer

  REST endpointGET https://cotlet.dev/api/v1/fieldroutes/customers/{customer_id}

  Parameters

  Parameters: get_customer

  Name	Type	Description
  customer_id string required	string	Customer ID from list_customers.

  Example input

  {
    "customer_id": "customer_8c41d2"
  }

  Example response

  {
    "customer_id": "104822",
    "name": "Dale Whitaker",
    "subscriptions": [
      {
        "type": "Quarterly pest",
        "next_service": "2026-12-03"
      }
    ],
    "open_tickets": 0,
    "notes": [
      "Dog in back yard"
    ]
  }

• create_customer Adds a new customer with a service address. write

  Creates the customer record. Search list_customers first so a returning customer does not become a duplicate. Reaches no one, so it runs at once.

  MCP callfieldroutes_write → create_customer

  REST endpointPOST https://cotlet.dev/api/v1/fieldroutes/customers

  Parameters

  Parameters: create_customer

  Name	Type	Description
  first_name string required	string	First name.
  last_name string required	string	Last name.
  address string required	string	Service address.
  phone string	string	Phone.
  email string	string	Email.

  Example input

  {
    "first_name": "first name",
    "last_name": "last name",
    "address": "address"
  }

  Example response

  {
    "customer_id": "105031",
    "name": "Tasha Moore",
    "address": "88 Roswell Rd, Atlanta, GA"
  }

• add_customer_note Adds a note to a customer record. write

  Appends a note, for example gate code or a pet in the yard, for office and technicians. Reaches no customer, so it runs at once.

  MCP callfieldroutes_write → add_customer_note

  REST endpointPOST https://cotlet.dev/api/v1/fieldroutes/customers/{customer_id}/note

  Parameters

  Parameters: add_customer_note

  Name	Type	Description
  customer_id string required	string	Customer ID from list_customers.
  note string required	string	Note text.

  Example input

  {
    "customer_id": "customer_8c41d2",
    "note": "note"
  }

  Example response

  {
    "customer_id": "104822",
    "note_added": "Gate code 4417"
  }

ToolWhat it doesAccess

• list_appointments Appointments for a day or range, by technician, route or status. read

  Returns appointments with customer, service type, technician, route, time window and status.

  MCP callfieldroutes_read → list_appointments

  REST endpointGET https://cotlet.dev/api/v1/fieldroutes/appointments

  Parameters

  Parameters: list_appointments

  Name	Type	Description
  date_from string required	string	ISO date.
  date_to string	string	ISO date. Default: date_from.
  tech string	string	Technician name.
  status string	string	Pending, Completed, Cancelled.
  page integer	integer	Page number. Default: 1.

  Example input

  {
    "date_from": "date from"
  }

  Example response

  {
    "appointments": [
      {
        "appointment_id": "881204",
        "customer": "Monica Reyes",
        "service": "Mosquito treatment",
        "tech": "Brandon P.",
        "date": "2026-11-10",
        "window": "AM",
        "status": "Pending"
      }
    ],
    "page": 1
  }

• schedule_appointment Schedules a service visit for a customer. writeasks first

  Creates the appointment for the service type on the day and window you choose. Your FieldRoutes reminder settings decide whether the customer hears about it. By default you confirm each call; you can switch that off for this tool.

  MCP callfieldroutes_write → schedule_appointment

  REST endpointPOST https://cotlet.dev/api/v1/fieldroutes/customers/{customer_id}/appointment/schedule

  Parameters

  Parameters: schedule_appointment

  Name	Type	Description
  customer_id string required	string	Customer ID from list_customers.
  service string required	string	Service type as in your office settings.
  date string required	string	ISO date.
  window string	string	AM, PM or a time.
  tech string	string	Technician name.

  Example input

  {
    "customer_id": "customer_8c41d2",
    "service": "service",
    "date": "date"
  }

  Example response

  {
    "appointment_id": "881377",
    "customer": "Dale Whitaker",
    "service": "Re-service",
    "date": "2026-11-11",
    "window": "PM",
    "status": "Pending"
  }

• reschedule_appointment Moves an appointment to another day, window or technician. writeasks first

  Moves the appointment, for example off a rained-out day. Your reminder settings decide whether the customer hears about it. By default you confirm each call; you can switch that off for this tool.

  MCP callfieldroutes_write → reschedule_appointment

  REST endpointPOST https://cotlet.dev/api/v1/fieldroutes/appointments/{appointment_id}/reschedule

  Parameters

  Parameters: reschedule_appointment

  Name	Type	Description
  appointment_id string required	string	Appointment ID from list_appointments.
  date string required	string	New ISO date.
  window string	string	AM, PM or a time.
  tech string	string	New technician. Default: unchanged.

  Example input

  {
    "appointment_id": "881204",
    "date": "2026-11-12",
    "window": "AM"
  }

  Example response

  {
    "appointment_id": "881204",
    "date": "2026-11-12",
    "window": "AM",
    "tech": "Brandon P.",
    "status": "Pending"
  }

• list_subscriptions_due Recurring services due but not yet scheduled. read

  Returns active subscriptions whose next service falls in the range and has no appointment yet, by area.

  MCP callfieldroutes_read → list_subscriptions_due

  REST endpointGET https://cotlet.dev/api/v1/fieldroutes/subscriptions-dues

  Parameters

  Parameters: list_subscriptions_due

  Name	Type	Description
  date_from string required	string	ISO date.
  date_to string required	string	ISO date.
  zip string	string	Only this ZIP code.

  Example input

  {
    "date_from": "date from",
    "date_to": "date to"
  }

  Example response

  {
    "due": [
      {
        "customer_id": "104990",
        "customer": "Ray Gentry",
        "subscription": "Bi-monthly lawn",
        "due": "2026-11-14",
        "zip": "30062"
      }
    ]
  }

ToolWhat it doesAccess

• list_unpaid_tickets Open invoices (tickets) with balance and age. read

  Returns tickets with a balance, oldest first, with customer, amount and days past due.

  MCP callfieldroutes_read → list_unpaid_tickets

  REST endpointGET https://cotlet.dev/api/v1/fieldroutes/unpaid-tickets

  Parameters

  Parameters: list_unpaid_tickets

  Name	Type	Description
  min_days_past_due integer	integer	Only tickets at least this many days past due.

  Example response

  {
    "tickets": [
      {
        "ticket_id": "T-552901",
        "customer": "Monica Reyes",
        "balance": "129.00",
        "days_past_due": 34
      }
    ]
  }