Supermove API and MCP server Let your AI agent dispatch your Supermove moves.

ToolWhat it doesAccess

• list_dispatch_jobs Lists the jobs of one day as the Dispatch tab shows them. read

  Returns the jobs of that day with their assigned trucks and crew. Jobs that still need dispatch are the ones on the Unassigned tab. Each job carries its dispatch_done flag.

  MCP callsupermove_read → list_dispatch_jobs

  REST endpointGET https://cotlet.dev/api/v1/supermove/dispatch-jobs

  Parameters

  Parameters: list_dispatch_jobs

  Name	Type	Description
  date string required	string	Day as YYYY-MM-DD.
  unassigned_only boolean	boolean	Only jobs on the Unassigned tab.
  cursor string	string	Next page cursor from the previous call.

  Example input

  {
    "date": "date"
  }

  Example response

  {
    "date": "2026-10-29",
    "jobs": [
      {
        "job_id": "job_77b3",
        "project_id": "prj_9a52",
        "customer": "Lopez Dental",
        "trucks": [],
        "crew": [],
        "dispatch_done": false
      },
      {
        "job_id": "job_77b8",
        "project_id": "prj_9a58",
        "customer": "Garcia family",
        "trucks": [
          "Truck 2"
        ],
        "crew": [
          "Ben R. (Driver)",
          "Kim T. (Mover)"
        ],
        "dispatch_done": true
      }
    ],
    "next_cursor": null
  }

• list_available_crew Lists the crew members and trucks free on a given date. read

  Returns the crew members the job popup offers for that date and the truck slots without a job. Use the IDs with assign_crew and assign_trucks.

  MCP callsupermove_read → list_available_crew

  REST endpointGET https://cotlet.dev/api/v1/supermove/available-crews

  Parameters

  Parameters: list_available_crew

  Name	Type	Description
  date string required	string	Day as YYYY-MM-DD.

  Example input

  {
    "date": "date"
  }

  Example response

  {
    "date": "2026-10-29",
    "crew": [
      {
        "member_id": "mem_21",
        "name": "Ben R."
      },
      {
        "member_id": "mem_24",
        "name": "Kim T."
      },
      {
        "member_id": "mem_30",
        "name": "Luis P."
      }
    ],
    "trucks": [
      {
        "truck_id": "trk_2",
        "name": "Truck 2"
      },
      {
        "truck_id": "trk_4",
        "name": "Truck 4"
      }
    ]
  }

• assign_trucks Assigns one or more trucks to a job, as the Assign button on the Dispatch tab does. writeasks first

  Returns the job with its trucks after the change. A truck already on another job that day is refused, and the error names the other job. The assignment changes the crew's day, so it waits for your OK. By default you confirm each call; you can switch that off for this tool.

  MCP callsupermove_write → assign_trucks

  REST endpointPOST https://cotlet.dev/api/v1/supermove/jobs/{job_id}/trucks/assign

  Parameters

  Parameters: assign_trucks

  Name	Type	Description
  job_id string required	string	Job ID from get_project or list_dispatch_jobs.
  truck_ids array required	array	Truck IDs from list_available_crew. More than one is allowed.

  Example input

  {
    "job_id": "job_77b3",
    "truck_ids": [
      "trk_2"
    ]
  }

  Example response

  {
    "job_id": "job_77b3",
    "trucks": [
      "Truck 2"
    ],
    "dispatch_done": false
  }

• assign_crew Assigns crew members to a job, each with a position such as Driver or Mover. writeasks first

  Returns the job with its crew after the change. Only crew available that date can be chosen. The crew works to this list, so it waits for your OK. By default you confirm each call; you can switch that off for this tool.

  MCP callsupermove_write → assign_crew

  REST endpointPOST https://cotlet.dev/api/v1/supermove/jobs/{job_id}/crew/assign

  Parameters

  Parameters: assign_crew

  Name	Type	Description
  job_id string required	string	Job ID from get_project or list_dispatch_jobs.
  members array required	array	Objects with member_id from list_available_crew and position, for example Driver or Mover.

  Example input

  {
    "job_id": "job_8c41d2",
    "members": "members"
  }

  Example response

  {
    "job_id": "job_77b3",
    "crew": [
      "Ben R. (Driver)",
      "Kim T. (Mover)"
    ],
    "dispatch_done": true
  }

ToolWhat it doesAccess

• list_projects Lists projects, newest first, with their status. read

  Returns the project ID, customer, status as Supermove shows it and the job dates. Use the project ID with get_project. The Project status turns to Completed once every job on it is marked complete.

  MCP callsupermove_read → list_projects

  REST endpointGET https://cotlet.dev/api/v1/supermove/projects

  Parameters

  Parameters: list_projects

  Name	Type	Description
  query string	string	Customer name or project name to search for.
  cursor string	string	Next page cursor from the previous call.

  Example response

  {
    "projects": [
      {
        "project_id": "prj_9a41",
        "name": "Haddad household move",
        "customer": "Omar Haddad",
        "status": "Completed",
        "job_dates": [
          "2026-10-27"
        ]
      },
      {
        "project_id": "prj_9a52",
        "name": "Lopez office move",
        "customer": "Lopez Dental",
        "status": "Booked",
        "job_dates": [
          "2026-10-29"
        ]
      }
    ],
    "next_cursor": null
  }

• get_project Reads one project with its jobs, dispatch state and invoices. read

  Returns the customer, the jobs with their date and assigned trucks and crew, and the invoices. Supermove marks a job Dispatch Done when the confirmation is signed and the needed trucks and crew are assigned; the response says which of the three is missing.

  MCP callsupermove_read → get_project

  REST endpointGET https://cotlet.dev/api/v1/supermove/projects/{project_id}

  Parameters

  Parameters: get_project

  Name	Type	Description
  project_id string required	string	Project ID from list_projects.

  Example input

  {
    "project_id": "project_8c41d2"
  }

  Example response

  {
    "project_id": "prj_9a52",
    "name": "Lopez office move",
    "customer": "Lopez Dental",
    "jobs": [
      {
        "job_id": "job_77b3",
        "date": "2026-10-29",
        "trucks": [],
        "crew": [],
        "confirmation_signed": true,
        "dispatch_done": false
      }
    ],
    "invoices": []
  }

• mark_job_complete Marks one job complete, as Mark As Complete in the Office App does. writeasks first

  Returns the job and the project status. When every job on the project is complete, the project becomes Completed and Supermove makes Send Invoice available. The tool does not send the invoice or take a payment. A completed job is worked on by billing next, so it waits for your OK. By default you confirm each call; you can switch that off for this tool.

  MCP callsupermove_write → mark_job_complete

  REST endpointPOST https://cotlet.dev/api/v1/supermove/projects/{project_id}/jobs/{job_id}/complete/mark

  Parameters

  Parameters: mark_job_complete

  Name	Type	Description
  project_id string required	string	Project ID from list_projects.
  job_id string required	string	Job ID from get_project or list_dispatch_jobs.

  Example input

  {
    "project_id": "project_8c41d2",
    "job_id": "job_8c41d2"
  }

  Example response

  {
    "project_id": "prj_9a41",
    "job_id": "job_6f20",
    "job_status": "Completed",
    "project_status": "Completed"
  }

ToolWhat it doesAccess

• list_leads Leads in your Supermove with customer, source and linked project, newest first. read

  Returns each lead with its customer name, source and the project it became, if any. Leads come from every provider you set up, such as a website form. The tool only reads: it sends nothing to the customer.

  MCP callsupermove_read → list_leads

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

  Parameters

  Parameters: list_leads

  Name	Type	Description
  query string	string	Customer name, phone or email to search for.
  cursor string	string	Next page cursor from the previous call.

  Example response

  {
    "leads": [
      {
        "lead_id": "lead_5cd1",
        "customer": "Dana Whitfield",
        "source": "Website form",
        "project_id": null,
        "created_at": "2026-10-27T18:42:00Z"
      },
      {
        "lead_id": "lead_5cd0",
        "customer": "Omar Haddad",
        "source": "Lead provider",
        "project_id": "prj_9a41",
        "created_at": "2026-10-27T15:10:00Z"
      }
    ],
    "next_cursor": null
  }

• list_invoices Lists the invoices of one project. read

  Returns each invoice with its number and total as the Project page shows them. Every project begins with one primary invoice. The tool only reads: it sends and records nothing.

  MCP callsupermove_read → list_invoices

  REST endpointGET https://cotlet.dev/api/v1/supermove/projects/{project_id}/invoices

  Parameters

  Parameters: list_invoices

  Name	Type	Description
  project_id string required	string	Project ID from list_projects.

  Example input

  {
    "project_id": "project_8c41d2"
  }

  Example response

  {
    "project_id": "prj_9a41",
    "invoices": [
      {
        "invoice_id": "inv_3301",
        "number": "INV-3301",
        "total": "1840.00",
        "currency": "USD",
        "primary": true
      }
    ]
  }