Deliverect API and MCP server Let your AI agent run the Deliverect portal.

ToolWhat it doesAccess

• list_orders List orders with their channel and status. read

  Returns the rows of the Orders page: pickup time, location, order ID from the channel, channel, delivery system, receipt ID and status. A canceled order can show twice with the same order ID and receipt ID, the second one marked Canceled, so the POS does not count the revenue twice. Needs the View orders permission.

  MCP calldeliverect_read → list_orders

  REST endpointGET https://cotlet.dev/api/v1/deliverect/orders

  Parameters

  Parameters: list_orders

  Name	Type	Description
  from string	string	First pickup day, YYYY-MM-DD.
  to string	string	Last pickup day, YYYY-MM-DD.
  status string	string	Only orders with this status as shown on the Orders page, for example Failed, Canceled or Finalized.
  channel string	string	Only orders from this channel.
  location string	string	Location name as shown on the Locations page. Needed when the account has several locations.

  Example response

  {
    "orders": [
      {
        "order_id": "UE-7K2Q9",
        "pickup_time": "2026-10-30T12:15",
        "location": "Ghent Centrum",
        "channel": "Uber Eats",
        "delivery_system": "Channel courier",
        "receipt_id": "R-20418",
        "status": "Finalized"
      },
      {
        "order_id": "DR-4M8LP",
        "pickup_time": "2026-10-30T12:40",
        "location": "Ghent Centrum",
        "channel": "Deliveroo",
        "delivery_system": "Channel courier",
        "receipt_id": "",
        "status": "Failed"
      }
    ]
  }

• get_order Read one order with its items, totals and status history. read

  Opens the order and returns what the Display tab shows: each item with its PLU, the total, fees, payment method, whether it is paid, the earlier statuses and, for a failed order, the reason. Needs the View orders permission.

  MCP calldeliverect_read → get_order

  REST endpointGET https://cotlet.dev/api/v1/deliverect/orders/{order_id}

  Parameters

  Parameters: get_order

  Name	Type	Description
  order_id string required	string	Order ID from list_orders.

  Example input

  {
    "order_id": "order_8c41d2"
  }

  Example response

  {
    "order_id": "DR-4M8LP",
    "status": "Failed",
    "reason": "Invalid PLU: ITEM-2291 not found in the POS",
    "items": [
      {
        "name": "Margherita",
        "plu": "PIZ-001",
        "quantity": 2
      },
      {
        "name": "Tiramisu",
        "plu": "ITEM-2291",
        "quantity": 1
      }
    ],
    "total": 31.5,
    "paid": true,
    "payment_method": "Online",
    "status_history": [
      "Parsed",
      "Failed"
    ]
  }

• get_order_issues Count failed and canceled orders per channel for a date range. read

  Returns the totals of Analytics > Order issues: failed orders, which hit a problem while being sent, and canceled orders, with the channels that have the most of each. Pair it with list_orders to see the orders behind a count. Needs access to Analytics.

  MCP calldeliverect_read → get_order_issues

  REST endpointGET https://cotlet.dev/api/v1/deliverect/order-issues

  Parameters

  Parameters: get_order_issues

  Name	Type	Description
  from string required	string	First day, YYYY-MM-DD.
  to string required	string	Last day, YYYY-MM-DD.
  location string	string	Location name as shown on the Locations page. Needed when the account has several locations.

  Example input

  {
    "from": "from",
    "to": "to"
  }

  Example response

  {
    "from": "2026-10-24",
    "to": "2026-10-30",
    "failed": 6,
    "canceled": 16,
    "by_channel": [
      {
        "channel": "Uber Eats",
        "failed": 2,
        "canceled": 5
      },
      {
        "channel": "Deliveroo",
        "failed": 3,
        "canceled": 9
      },
      {
        "channel": "Just Eat",
        "failed": 1,
        "canceled": 2
      }
    ]
  }

• retry_order Send a failed order to the POS again. writeasks first

  Presses Retry Order on the failed order. Use it after the cause in the Display tab is fixed, for example a PLU that now exists in the POS. If the button is missing, Deliverect support has to resolve it and the call fails. A retried order reaches the kitchen and can be prepared, so it waits for your OK. Needs the Retry orders permission. By default you confirm each call; you can switch that off for this tool.

  MCP calldeliverect_write → retry_order

  REST endpointPOST https://cotlet.dev/api/v1/deliverect/orders/{order_id}/retry

  Parameters

  Parameters: retry_order

  Name	Type	Description
  order_id string required	string	Order ID of a Failed order from list_orders.

  Example input

  {
    "order_id": "order_8c41d2"
  }

  Example response

  {
    "order_id": "DR-4M8LP",
    "retried": true,
    "status": "Parsed"
  }

ToolWhat it doesAccess

• list_products List the products of a location menu with their snooze status. read

  Returns the products of the menu on Operations > Snoozing with their PLU and whether each is snoozed and until when. A product that is also a modifier of another product is listed in both places, because snoozing one does not snooze the other. Needs the View products permission.

  MCP calldeliverect_read → list_products

  REST endpointGET https://cotlet.dev/api/v1/deliverect/products

  Parameters

  Parameters: list_products

  Name	Type	Description
  menu string required	string	Menu name as shown on the Snoozing page.
  search string	string	Only products whose name or PLU contains this text.
  location string	string	Location name as shown on the Locations page. Needed when the account has several locations.

  Example input

  {
    "menu": "menu"
  }

  Example response

  {
    "menu": "Lunch",
    "products": [
      {
        "name": "Margherita",
        "plu": "PIZ-001",
        "snoozed": false
      },
      {
        "name": "Tiramisu",
        "plu": "ITEM-2291",
        "snoozed": true,
        "snoozed_until": "2026-10-31T06:00"
      }
    ]
  }

• list_snoozed_products List every product that is snoozed right now. read

  Returns what the Snoozed products button shows: each snoozed product with its menu and the date it comes back, or indefinitely. Use it every morning to check nothing stays hidden by mistake. Needs the View products permission.

  MCP calldeliverect_read → list_snoozed_products

  REST endpointGET https://cotlet.dev/api/v1/deliverect/snoozed-products

  Parameters

  Parameters: list_snoozed_products

  Name	Type	Description
  location string	string	Location name as shown on the Locations page. Needed when the account has several locations.

  Example response

  {
    "snoozed": [
      {
        "name": "Tiramisu",
        "plu": "ITEM-2291",
        "menu": "Lunch",
        "until": "2026-10-31T06:00"
      },
      {
        "name": "Truffle fries",
        "plu": "SID-014",
        "menu": "Lunch",
        "until": "indefinitely"
      }
    ]
  }

• snooze_product Take a product or modifier off the menus for a while. write

  Uses the bell icon on Operations > Snoozing. The product disappears from the channels that support snoozing, and not all do. A product that is also a modifier needs a second call with modifier_of. Check list_operations if the item still shows on a channel. It reaches no customer directly and unsnooze_product reverses it in one call, so it does not wait for your OK. Needs the Snooze products permission.

  MCP calldeliverect_write → snooze_product

  REST endpointPOST https://cotlet.dev/api/v1/deliverect/product/snooze

  Parameters

  Parameters: snooze_product

  Name	Type	Description
  product string required	string	Product name or PLU from list_products.
  menu string required	string	Menu name as shown on the Snoozing page.
  duration string required	string	One hour, a number of hours, a date to come back on, or indefinitely.
  modifier_of string	string	Product name. Set it to snooze this item as a modifier of that product instead of as a product.
  location string	string	Location name as shown on the Locations page. Needed when the account has several locations.

  Example input

  {
    "product": "Tiramisu",
    "menu": "Lunch",
    "duration": "until 2026-10-31 06:00",
    "location": "Ghent Centrum"
  }

  Example response

  {
    "product": "Tiramisu",
    "plu": "ITEM-2291",
    "menu": "Lunch",
    "location": "Ghent Centrum",
    "snoozed": true,
    "until": "2026-10-31T06:00"
  }

• unsnooze_product Bring a snoozed product back on the menus. write

  Selects the product under Snoozed products and makes it available at once or at the time you give. Snoozing it again reverses the call, so it does not wait for your OK. Needs the Unsnooze products permission.

  MCP calldeliverect_write → unsnooze_product

  REST endpointPOST https://cotlet.dev/api/v1/deliverect/product/unsnooze

  Parameters

  Parameters: unsnooze_product

  Name	Type	Description
  product string required	string	Product name or PLU from list_snoozed_products.
  menu string required	string	Menu name as shown on the Snoozing page.
  at string	string	When it comes back, YYYY-MM-DDTHH:MM. Without it the product is available right away.
  location string	string	Location name as shown on the Locations page. Needed when the account has several locations.

  Example input

  {
    "product": "product",
    "menu": "menu"
  }

  Example response

  {
    "product": "Truffle fries",
    "plu": "SID-014",
    "menu": "Lunch",
    "location": "Ghent Centrum",
    "snoozed": false
  }

ToolWhat it doesAccess

• list_locations List the locations of the account with their channel links. read

  Returns each location from the Locations page with the delivery channels linked to it. Channels that support busy mode are marked, because not every channel does. Any user who can open the Locations page can call it.

  MCP calldeliverect_read → list_locations

  REST endpointGET https://cotlet.dev/api/v1/deliverect/locations

  Parameters

  No parameters.

  Example response

  {
    "locations": [
      {
        "name": "Ghent Centrum",
        "channels": [
          {
            "name": "Uber Eats",
            "busy_mode": true
          },
          {
            "name": "Deliveroo",
            "busy_mode": true
          },
          {
            "name": "Just Eat",
            "busy_mode": false
          }
        ]
      },
      {
        "name": "Antwerp Zuid",
        "channels": [
          {
            "name": "Uber Eats",
            "busy_mode": true
          },
          {
            "name": "Deliveroo",
            "busy_mode": true
          }
        ]
      }
    ]
  }

• set_busy_mode Add preparation time to new orders, close the stores or reopen them. writeasks first

  Uses the Busy mode button of the location on the Locations page. Guests on the channels see longer waits or no way to order, so it waits for your OK. Deliverect does not reopen the store by itself, not even at the next opening hours, so an open call is needed to end it. Channels missing from the window do not support it and must be closed on the channel's own site. Needs the Toggle busy mode permission. By default you confirm each call; you can switch that off for this tool.

  MCP calldeliverect_write → set_busy_mode

  REST endpointPUT https://cotlet.dev/api/v1/deliverect/busy-mode

  Parameters

  Parameters: set_busy_mode

  Name	Type	Description
  mode string required	string	busy adds preparation time, close stops new orders, open reopens the stores or removes the added time.
  extra_prep_time integer	integer	Extra preparation time to add, as entered in the Busy mode window. Only with busy.
  channel string	string	Only this channel. Without it the call covers every channel of the location that supports the mode.
  location string required	string	Location name as shown on the Locations page.

  Example input

  {
    "mode": "mode",
    "location": "location"
  }

  Example response

  {
    "location": "Ghent Centrum",
    "mode": "busy",
    "extra_prep_time": 15,
    "channels_changed": [
      "Uber Eats",
      "Deliveroo"
    ],
    "channels_unsupported": [
      "Just Eat"
    ]
  }

• get_opening_hours Read the opening hours and special hours of a location. read

  Returns the days and hours from Locations > Opening hours, including a second range for a break in service, and the special hours on the Special hours tab or the holidays on the Holidays tab, depending on what the account has. Special hours override the normal schedule only inside their period.

  MCP calldeliverect_read → get_opening_hours

  REST endpointGET https://cotlet.dev/api/v1/deliverect/opening-hours

  Parameters

  Parameters: get_opening_hours

  Name	Type	Description
  location string	string	Location name as shown on the Locations page. Needed when the account has several locations.

  Example response

  {
    "location": "Ghent Centrum",
    "hours": [
      {
        "day": "Monday",
        "ranges": [
          {
            "open": "11:30",
            "close": "14:30"
          },
          {
            "open": "17:30",
            "close": "22:00"
          }
        ]
      },
      {
        "day": "Tuesday",
        "ranges": [
          {
            "open": "11:30",
            "close": "22:00"
          }
        ]
      }
    ],
    "special_hours": [
      {
        "name": "Christmas closure",
        "from": "2026-12-25",
        "to": "2026-12-26",
        "hours": "Closed"
      }
    ]
  }

• add_special_hours Close a location or set custom hours for a holiday or other date range. writeasks first

  Creates the entry on Locations > Opening hours > Special hours with the Add special hours button. The hours apply on their own during the period and the regular schedule returns after it. Not all channels support special hours, and Just Eat cannot extend hours this way. An account that only has the Holidays tab gets a holiday entry instead. Guests see the closure, so it waits for your OK. Needs the Manage opening hours permission. By default you confirm each call; you can switch that off for this tool.

  MCP calldeliverect_write → add_special_hours

  REST endpointPOST https://cotlet.dev/api/v1/deliverect/special-hours

  Parameters

  Parameters: add_special_hours

  Name	Type	Description
  name string required	string	Name that identifies the special hours.
  from string required	string	First day, YYYY-MM-DD.
  to string required	string	Last day, YYYY-MM-DD.
  hours string required	string	closed, or custom with the rows in custom_hours.
  custom_hours array	array	Rows with day, open and close (HH:MM). Only with custom.
  location string required	string	Location name as shown on the Locations page.

  Example input

  {
    "name": "Jane Doe",
    "from": "from",
    "to": "to",
    "hours": "hours",
    "location": "location"
  }

  Example response

  {
    "name": "Christmas closure",
    "location": "Ghent Centrum",
    "from": "2026-12-25",
    "to": "2026-12-26",
    "hours": "Closed",
    "created": true
  }

ToolWhat it doesAccess

• list_operations List the entries of the Operations page: busy mode, closures, snoozes, exports and syncs. read

  Returns each operation with its type, status, time and the user who started it. Use it to check that a snooze or a busy mode change went through on every channel, and to see why a snooze failed. Needs the View operation reports permission.

  MCP calldeliverect_read → list_operations

  REST endpointGET https://cotlet.dev/api/v1/deliverect/operations

  Parameters

  Parameters: list_operations

  Name	Type	Description
  from string	string	First day, YYYY-MM-DD.
  to string	string	Last day, YYYY-MM-DD.
  operation_type string	string	Only this type as named on the Operations page, for example Busy mode, Close store or Export.
  status string	string	Only operations with this status, for example success or failure.
  location string	string	Location name as shown on the Locations page. Needed when the account has several locations.

  Example response

  {
    "operations": [
      {
        "type": "Busy mode",
        "status": "success",
        "time": "2026-10-30T18:42",
        "user": "maya@yourname.com",
        "channel": "Uber Eats"
      },
      {
        "type": "Close store",
        "status": "failure",
        "time": "2026-10-30T18:43",
        "user": "maya@yourname.com",
        "channel": "Just Eat"
      }
    ]
  }

• export_orders Request an orders CSV and return its download link. write

  Uses Orders > more > Export orders, then opens the new EXPORT entry on the Operations page and returns its download link. The export is the only report that lists orders by payment method, which the Orders page cannot filter by. It reaches no one and leaves no change in the account, so it does not wait for your OK. Needs the Export orders permission.

  MCP calldeliverect_write → export_orders

  REST endpointPOST https://cotlet.dev/api/v1/deliverect/orders/export

  Parameters

  Parameters: export_orders

  Name	Type	Description
  from string required	string	First pickup day, YYYY-MM-DD.
  to string required	string	Last pickup day, YYYY-MM-DD.
  status string	string	Only orders with this status.
  channel string	string	Only orders from this channel.
  split_items boolean	boolean	true puts each item on its own row.
  location string	string	Location name as shown on the Locations page. Needed when the account has several locations.

  Example input

  {
    "from": "from",
    "to": "to"
  }

  Example response

  {
    "operation": "EXPORT",
    "status": "success",
    "rows": 412,
    "download_url": "https://example.com/exports/orders-2026-10-24_2026-10-30.csv"
  }