MioCommerce API and MCP server Let your AI agent book, quote and invoice the job.

ToolWhat it doesAccess

• manage_customers List, read, create or edit a customer profile under Customers. writeAsks first

  Follows Customers > Create Customer. Add the customer first, then create_booking, generate_invoice or charge_customer can use the profile. Run `list` first so the same household is not added twice. By default you confirm each call; you can switch that off for this tool.

  MCP callmiocommerce_write → manage_customers

  REST endpointPOST https://cotlet.dev/api/v1/miocommerce/customers/manage

  Parameters

  Parameters: manage_customers

  Name	Type	Description
  action string required	string	One of `list`, `get`, `create`, `update`. `list`, `get` and `export` only read.
  customer string	string	Customer name or email, for `get` and `update`.
  fields object	object	For `create` and `update`: email, first_name, last_name and address (required to create), plus billing_email, language, notify_by (`email`, `sms` or both) and payment_option (cash, check, credit card, debit card, e-check and the other options MioCommerce lists).

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "customer": "Example Homeowner",
    "email": "homeowner@example.com",
    "notify_by": [
      "email",
      "sms"
    ],
    "payment_option": "credit card",
    "saved": true
  }

• import_export_customers Export the customer list, or import customers from a CSV file. writeAsks first

  Leave Customer No empty for new customers and MioCommerce generates one. State and country must be written out (New York, United States), as the Help Center asks. `export` only reads. By default you confirm each call; you can switch that off for this tool.

  MCP callmiocommerce_write → import_export_customers

  REST endpointPOST https://cotlet.dev/api/v1/miocommerce/export-customers

  Parameters

  Parameters: import_export_customers

  Name	Type	Description
  action string required	string	One of `export`, `import`. `list`, `get` and `export` only read.
  format string	string	For `export`: one of the formats MioCommerce offers, for example `csv`.
  file_url string	string	For `import`: a link to a CSV file in the MioCommerce customer layout. Email address, first name and last name are required columns.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "action": "import",
    "rows": 3,
    "imported": 3
  }

• manage_service_requests Create or edit a service request for a customer or a new prospect. writeAsks first

  Once saved, a request can be edited except for its email and service type. Turn it into a quote with create_quick_quote or create_advanced_quote. By default you confirm each call; you can switch that off for this tool.

  MCP callmiocommerce_write → manage_service_requests

  REST endpointPOST https://cotlet.dev/api/v1/miocommerce/service-requests/manage

  Parameters

  Parameters: manage_service_requests

  Name	Type	Description
  action string required	string	One of `list`, `get`, `create`, `update`. `list`, `get` and `export` only read.
  request string	string	Service request number, for `get` and `update`.
  contact object	object	For a new prospect: email, first_name, last_name, phone. For an existing customer, email is enough.
  service_page string	string	A Service Request Page to start from, or leave empty for a custom request.
  details object	object	Service location, service options, extras, notes.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "request": "SR-311",
    "contact": "prospect@example.com",
    "service": "Home cleaning",
    "status": "new",
    "saved": true
  }

ToolWhat it doesAccess

• list_bookings List bookings from the Bookings page, or open one Booking Profile. read

  Returns the bookings your user can see with customer, service, date, status and amount. Most other tools take a booking, so this is usually the first call. Nothing is changed, so it runs without asking.

  MCP callmiocommerce_read → list_bookings

  REST endpointGET https://cotlet.dev/api/v1/miocommerce/bookings

  Parameters

  Parameters: list_bookings

  Name	Type	Description
  status string	string	Filter by the status MioCommerce shows, for example `call-in`, `unscheduled`, `scheduled`, `dispatched` or `complete`. Leave empty for all.
  from string	string	ISO date, first day to include.
  to string	string	ISO date, last day to include.
  booking string	string	Booking number, to open one Booking Profile instead of the list.

  Example response

  {
    "bookings": [
      {
        "booking": "B-1042",
        "customer": "Example Homeowner",
        "service": "Deep clean",
        "date": "2026-11-18",
        "status": "complete",
        "amount": 285
      },
      {
        "booking": "B-1043",
        "customer": "Sample Rentals",
        "service": "Move out clean",
        "date": "2026-11-19",
        "status": "scheduled",
        "amount": 410
      }
    ]
  }

• create_booking Create an internal (call-in) booking on the Calendar. writeAsks first

  The booking follows your operating hours, service availability and provider capacity. If it overlaps another booking, MioCommerce flags the double booking in red, and the agent reports it to you. By default you confirm each call; you can switch that off for this tool.

  MCP callmiocommerce_write → create_booking

  REST endpointPOST https://cotlet.dev/api/v1/miocommerce/bookings

  Parameters

  Parameters: create_booking

  Name	Type	Description
  customer string required	string	Customer from manage_customers.
  service string required	string	The service as named in your account.
  start string required	string	ISO date and time.
  end string	string	ISO date and time. Defaults to the service length.
  price number	number	Price, if it differs from the service price.

  Example input

  {
    "customer": "customer",
    "service": "service",
    "start": "start"
  }

  Example response

  {
    "booking": "B-1044",
    "customer": "Example Homeowner",
    "service": "Standard clean",
    "start": "2026-11-21T09:00",
    "end": "2026-11-21T11:00",
    "status": "call-in",
    "double_booked": false
  }

• reschedule_booking Move a booking to a new date or time, with an optional notification. writeAsks first

  Rescheduling does not change the assigned service provider. For a recurring booking the agent asks whether to move only this visit or all future ones. By default you confirm each call; you can switch that off for this tool.

  MCP callmiocommerce_write → reschedule_booking

  REST endpointPOST https://cotlet.dev/api/v1/miocommerce/booking/reschedule

  Parameters

  Parameters: reschedule_booking

  Name	Type	Description
  booking string required	string	Booking number or customer name, as list_bookings returns it.
  start string required	string	New ISO date and time.
  recurring_scope string	string	For a recurring booking: `this` or `all_future`.
  notify boolean	boolean	Send the customer and service provider a notification (accounts with Dispatching).

  Example input

  {
    "booking": "booking",
    "start": "start"
  }

  Example response

  {
    "booking": "B-1043",
    "start": "2026-11-20T13:00",
    "recurring_scope": "this",
    "notified": true
  }

• assign_service_provider Assign a service provider to a booking on the Dispatcher. writeAsks first

  Moving a booking from another provider keeps that provider on it too, as the Dispatcher does; the agent says so before saving. By default you confirm each call; you can switch that off for this tool.

  MCP callmiocommerce_write → assign_service_provider

  REST endpointPOST https://cotlet.dev/api/v1/miocommerce/service-provider/assign

  Parameters

  Parameters: assign_service_provider

  Name	Type	Description
  booking string required	string	Booking number or customer name, as list_bookings returns it.
  provider string required	string	Service provider as named in your account.
  notify boolean	boolean	Tell the provider about the new assignment.
  future_recurrences boolean	boolean	Also assign the provider to all future recurrences of this booking.

  Example input

  {
    "booking": "booking",
    "provider": "provider"
  }

  Example response

  {
    "booking": "B-1044",
    "providers": [
      "Cleaner A"
    ],
    "notified": true,
    "future_recurrences": false
  }

• cancel_booking Cancel a booking from its Booking Profile. writeAsks first

  A cancelled booking cannot be restored. MioCommerce can clone it to recreate the details, so the agent offers reschedule_booking first when you only need a new time. By default you confirm each call; you can switch that off for this tool.

  MCP callmiocommerce_write → cancel_booking

  REST endpointPOST https://cotlet.dev/api/v1/miocommerce/booking/cancel

  Parameters

  Parameters: cancel_booking

  Name	Type	Description
  booking string required	string	Booking number or customer name, as list_bookings returns it.

  Example input

  {
    "booking": "booking"
  }

  Example response

  {
    "booking": "B-1043",
    "status": "cancelled"
  }

ToolWhat it doesAccess

• create_quick_quote Create a Quick Quote with typed services and prices, and send it or keep it as a draft. writeAsks first

  For a known price. When pricing needs the questions, options and frequencies of a booking page, use create_advanced_quote. The agent shows you lines and total before it sends. By default you confirm each call; you can switch that off for this tool.

  MCP callmiocommerce_write → create_quick_quote

  REST endpointPOST https://cotlet.dev/api/v1/miocommerce/quick-quotes

  Parameters

  Parameters: create_quick_quote

  Name	Type	Description
  contact string required	string	Customer or prospect email.
  service string required	string	The service the quote is for.
  lines array required	array	Description and amount per line.
  issued_date string	string	ISO date. Defaults to today.
  expiration_date string	string	ISO date the quote is valid until (optional).
  send boolean	boolean	Send it now. False keeps a draft.

  Example input

  {
    "contact": "prospect@example.com",
    "service": "Deep clean",
    "lines": [
      {
        "description": "Deep clean, three bedrooms",
        "amount": 240
      },
      {
        "description": "Inside oven",
        "amount": 45
      }
    ],
    "expiration_date": "2026-11-28",
    "send": false
  }

  Example response

  {
    "quote": "Q-208",
    "contact": "prospect@example.com",
    "service": "Deep clean",
    "lines": [
      {
        "description": "Deep clean, three bedrooms",
        "amount": 240
      },
      {
        "description": "Inside oven",
        "amount": 45
      }
    ],
    "total": 285,
    "status": "draft"
  }

• create_advanced_quote Create an Advanced Quote from a Live Pricing or Interactive Quoting Page. writeAsks first

  Reuses the pricing, options and add-ons you already set up, so the total comes from your own page. Existing customers get their details filled in automatically. By default you confirm each call; you can switch that off for this tool.

  MCP callmiocommerce_write → create_advanced_quote

  REST endpointPOST https://cotlet.dev/api/v1/miocommerce/advanced-quotes

  Parameters

  Parameters: create_advanced_quote

  Name	Type	Description
  contact string required	string	Customer or prospect email; only the email is required for a prospect.
  page string	string	Live Pricing & Real-Time Booking Page or Interactive Quoting Page to reuse.
  answers object	object	Options, extras and frequency, as the page asks for them.
  notes string	string	Notes for the customer.

  Example input

  {
    "contact": "contact"
  }

  Example response

  {
    "quote": "Q-209",
    "contact": "homeowner@example.com",
    "page": "Home cleaning",
    "frequency": "every two weeks",
    "total": 160,
    "status": "draft"
  }

• edit_quote Edit a draft or sent quote: lines, extras, discounts, frequency or terms. writeAsks first

  An existing customer's contact details change on the customer profile, not on the quote. A quote that was already sent has to be sent again to reach the customer. By default you confirm each call; you can switch that off for this tool.

  MCP callmiocommerce_write → edit_quote

  REST endpointPATCH https://cotlet.dev/api/v1/miocommerce/quote

  Parameters

  Parameters: edit_quote

  Name	Type	Description
  quote string required	string	Quote number.
  changes object required	object	Prospect contact details, service location, custom lines, extras, discounts, frequency options or terms.

  Example input

  {
    "quote": "quote",
    "changes": "changes"
  }

  Example response

  {
    "quote": "Q-208",
    "total": 265,
    "discount": 20,
    "status": "draft",
    "saved": true
  }

ToolWhat it doesAccess

• generate_invoice Generate an invoice from a booking, then send it or save a draft. writeAsks first

  The invoice takes booking number, service, billing address, date, amount and taxes from the booking, and your company Terms & Conditions from Settings > Invoicing. Fix the booking first if a price is wrong. By default you confirm each call; you can switch that off for this tool.

  MCP callmiocommerce_write → generate_invoice

  REST endpointPOST https://cotlet.dev/api/v1/miocommerce/invoice/generate

  Parameters

  Parameters: generate_invoice

  Name	Type	Description
  booking string required	string	Booking number or customer name, as list_bookings returns it.
  extra_recipients array	array	More email addresses to send the invoice to.
  note string	string	Personal note, for example "Thank you for your business."
  send boolean	boolean	Send it now. False saves a draft under Payments > Invoices.

  Example input

  {
    "booking": "booking"
  }

  Example response

  {
    "invoice": "INV-5521",
    "booking": "B-1042",
    "customer": "Example Homeowner",
    "total": 285,
    "status": "draft"
  }

• edit_invoice Change an invoice's email recipients or personal note. writeAsks first

  Service, price and taxes change on the booking; billing address on the customer profile. Editing does not collect or refund money, and an invoice that was already sent must be sent again. By default you confirm each call; you can switch that off for this tool.

  MCP callmiocommerce_write → edit_invoice

  REST endpointPATCH https://cotlet.dev/api/v1/miocommerce/invoice

  Parameters

  Parameters: edit_invoice

  Name	Type	Description
  invoice string required	string	Invoice number.
  recipients array	array	Email addresses to send to.
  note string	string	Personal note on the invoice.

  Example input

  {
    "invoice": "invoice"
  }

  Example response

  {
    "invoice": "INV-5521",
    "recipients": [
      "homeowner@example.com",
      "accounts@example.com"
    ],
    "saved": true
  }

• add_invoice_payment_link Add a Stripe payment link to a saved invoice. writeAsks first

  Needs Stripe connected to your MioCommerce account; without it MioCommerce does not offer the option, and the agent tells you. When the customer pays through the link, the payment updates in MioCommerce. By default you confirm each call; you can switch that off for this tool.

  MCP callmiocommerce_write → add_invoice_payment_link

  REST endpointPOST https://cotlet.dev/api/v1/miocommerce/invoice-payment-links

  Parameters

  Parameters: add_invoice_payment_link

  Name	Type	Description
  invoice string required	string	Invoice number.

  Example input

  {
    "invoice": "invoice"
  }

  Example response

  {
    "invoice": "INV-5521",
    "payment_link": true
  }

• charge_customer Charge a booking with MioPay: the full amount, part of it, or a pre-authorized amount. writeAsks first

  For accounts connected to Stripe through MioPay. This moves the customer's money, so the agent shows booking, card and amount before charging. By default you confirm each call; you can switch that off for this tool.

  MCP callmiocommerce_write → charge_customer

  REST endpointPOST https://cotlet.dev/api/v1/miocommerce/customer/charge

  Parameters

  Parameters: charge_customer

  Name	Type	Description
  booking string required	string	Booking number or customer name, as list_bookings returns it.
  amount number required	number	Amount to charge.
  capture boolean	boolean	Capture the pre-authorized amount instead of a new charge.

  Example input

  {
    "booking": "booking",
    "amount": 1
  }

  Example response

  {
    "booking": "B-1042",
    "amount": 285,
    "method": "MioPay",
    "status": "paid"
  }

• record_collection Mark a booking as paid when the customer paid outside MioCommerce. writeAsks first

  Records the payment so the balance shows zero. No card is charged and Stripe handles no money. By default you confirm each call; you can switch that off for this tool.

  MCP callmiocommerce_write → record_collection

  REST endpointPOST https://cotlet.dev/api/v1/miocommerce/collections

  Parameters

  Parameters: record_collection

  Name	Type	Description
  booking string required	string	Booking number or customer name, as list_bookings returns it.
  method string required	string	One of the collection methods MioCommerce lists: Cash, Cheque, Interac e-Transfer, eCheck, PAD, PayPal (External), Square (External), Venmo, Zelle (External), Coupon, IMS, ITEX or None.
  amount number required	number	Amount received.

  Example input

  {
    "booking": "booking",
    "method": "method",
    "amount": 1
  }

  Example response

  {
    "booking": "B-1045",
    "method": "Cash",
    "amount": 160,
    "balance": 0
  }

• refund_card_payment Refund all or part of a MioPay card payment from Payments. writeAsks first

  Only for card payments through MioPay (Stripe). The status turns Refunded at once; customers usually see the money in 5 to 10 business days. By default you confirm each call; you can switch that off for this tool.

  MCP callmiocommerce_write → refund_card_payment

  REST endpointPOST https://cotlet.dev/api/v1/miocommerce/card-payment/refund

  Parameters

  Parameters: refund_card_payment

  Name	Type	Description
  payment string required	string	Payment as listed under Payments.
  amount number required	number	Refund amount, full or partial.

  Example input

  {
    "payment": "payment",
    "amount": 1
  }

  Example response

  {
    "payment": "P-9031",
    "amount": 45,
    "status": "Refunded"
  }

ToolWhat it doesAccess

• request_service_feedback Send a customer the service feedback request for one booking. writeAsks first

  Goes by email, SMS or both, following the customer's notification settings. It works at any booking status. Answers stay private in MioCommerce; read them with view_customer_feedback. By default you confirm each call; you can switch that off for this tool.

  MCP callmiocommerce_write → request_service_feedback

  REST endpointPOST https://cotlet.dev/api/v1/miocommerce/service-feedback/request

  Parameters

  Parameters: request_service_feedback

  Name	Type	Description
  booking string required	string	Booking number or customer name, as list_bookings returns it.

  Example input

  {
    "booking": "booking"
  }

  Example response

  {
    "booking": "B-1042",
    "sent_by": [
      "email"
    ],
    "sent": true
  }

• view_customer_feedback Read service feedback from CRM > Feedback, one customer or one booking. read

  Returns the feedback with its date and booking. MioCommerce keeps it inside your account and does not publish it. Read only, it runs without asking.

  MCP callmiocommerce_read → view_customer_feedback

  REST endpointGET https://cotlet.dev/api/v1/miocommerce/customer-feedbacks/view

  Parameters

  Parameters: view_customer_feedback

  Name	Type	Description
  customer string	string	Customer name or email. Leave empty for all customers.
  booking string	string	Booking number, for the feedback on one service.

  Example response

  {
    "feedback": [
      {
        "customer": "Example Homeowner",
        "booking": "B-1042",
        "date": "2026-11-19",
        "comment": "Kitchen looked brand new, thank you."
      }
    ]
  }

ToolWhat it doesAccess

• manage_booking_pages List, create or edit a Live Pricing & Real-Time Booking Page. writeAsks first

  Every page needs a name, a service and a personal information section. Customers book and pay on these pages, so changes wait for your OK. By default you confirm each call; you can switch that off for this tool.

  MCP callmiocommerce_write → manage_booking_pages

  REST endpointPOST https://cotlet.dev/api/v1/miocommerce/booking-pages/manage

  Parameters

  Parameters: manage_booking_pages

  Name	Type	Description
  action string required	string	One of `list`, `get`, `create`, `update`. `list`, `get` and `export` only read.
  page string	string	Booking page name, for `get` and `update`.
  template string	string	For `create`: a MioCommerce template by service category, or empty to build from scratch.
  sections object	object	Service, personal information, location, date, options, extras, frequency and payment sections.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "page": "Home cleaning",
    "template": "Cleaning",
    "sections": [
      "Service",
      "Personal information",
      "Location",
      "Date",
      "Options",
      "Extras",
      "Frequency"
    ],
    "saved": true
  }

• send_provider_schedule Email a service provider today's, this week's or next week's schedule. writeAsks first

  Providers already get their daily schedule at 5 AM in your company time zone; this sends an extra one on demand. By default you confirm each call; you can switch that off for this tool.

  MCP callmiocommerce_write → send_provider_schedule

  REST endpointPOST https://cotlet.dev/api/v1/miocommerce/provider-schedules

  Parameters

  Parameters: send_provider_schedule

  Name	Type	Description
  provider string required	string	Service provider as named in your account.
  period string required	string	`today`, `this_week` or `next_week`.

  Example input

  {
    "provider": "provider",
    "period": "period"
  }

  Example response

  {
    "provider": "Cleaner A",
    "period": "next_week",
    "sent": true
  }

• add_non_working_hours Block time on a service provider's Work Calendar. writeAsks first

  Non-working hours override availability, so customers cannot book that time. Bookings already in the slot stay; list_bookings shows them so you can move them. By default you confirm each call; you can switch that off for this tool.

  MCP callmiocommerce_write → add_non_working_hours

  REST endpointPOST https://cotlet.dev/api/v1/miocommerce/non-working-hours

  Parameters

  Parameters: add_non_working_hours

  Name	Type	Description
  provider string required	string	Service provider as named in your account.
  start string required	string	ISO date and time.
  end string required	string	ISO date and time.

  Example input

  {
    "provider": "provider",
    "start": "start",
    "end": "end"
  }

  Example response

  {
    "provider": "Cleaner A",
    "start": "2026-11-24T00:00",
    "end": "2026-11-28T23:59",
    "saved": true
  }