Obat API and MCP server Let your AI agent write the quote and chase the payment.

ToolWhat it doesAccess

• list_quotes List quotes with client, job site, status and amount. read

  list_quotes returns the newest quotes first, with the quote id, number (empty for a draft), client, job site, status and total excluding VAT. It reads the Quotes list of the account. Only a signed quote can be invoiced in Obat.

  MCP callobat_read → list_quotes

  REST endpointGET https://cotlet.dev/api/v1/obat/quotes

  Parameters

  Parameters: list_quotes

  Name	Type	Description
  status string	string	Filter by status as the Quotes list shows it: draft, sent or signed. Omit for all.
  client_id string	string	Only quotes of this client.
  cursor string	string	Cursor from the previous page.

  Example response

  {
    "quotes": [
      {
        "quote_id": "qt_8f21c4",
        "number": "DE-0412",
        "client": "Martin",
        "site": "Bathroom renovation",
        "status": "signed",
        "total_excl_vat": 1694
      },
      {
        "quote_id": "qt_8f21c9",
        "number": null,
        "client": "Durand",
        "site": "Roof repair",
        "status": "draft",
        "total_excl_vat": 2400
      }
    ],
    "next_cursor": null
  }

• get_quote Read one quote with its lines, client and signature state. read

  get_quote returns the lines in the order of the document with their kind (supply, labour or work item), quantity, unit price and VAT rate, then the totals. It also says whether e-signature was requested. Use it before send_quote to check the draft.

  MCP callobat_read → get_quote

  REST endpointGET https://cotlet.dev/api/v1/obat/quotes/{quote_id}

  Parameters

  Parameters: get_quote

  Name	Type	Description
  quote_id string required	string	Quote id from list_quotes.

  Example input

  {
    "quote_id": "quote_8c41d2"
  }

  Example response

  {
    "quote_id": "qt_8f21c9",
    "status": "draft",
    "client": "Durand",
    "site": "Roof repair",
    "lines": [
      {
        "kind": "labour",
        "label": "Roof repair labour",
        "quantity": 16,
        "unit": "h",
        "unit_price_excl_vat": 50
      },
      {
        "kind": "supply",
        "label": "Tiles and fixings",
        "quantity": 1,
        "unit": "lot",
        "unit_price_excl_vat": 1600
      }
    ],
    "total_excl_vat": 2400,
    "e_signature_requested": false
  }

• create_quote_draft Create a quote as a draft with its lines. write

  create_quote_draft saves the quote as a draft: it has no number and nobody is told. Obat gives the definitive number only when the quote is finalized, which send_quote does. Lines are supply, labour or work items, the three kinds Obat offers. The draft is returned with totals so you can check them before sending. A draft reaches nobody and you can delete it in Obat, so it does not wait for your OK.

  MCP callobat_write → create_quote_draft

  REST endpointPOST https://cotlet.dev/api/v1/obat/clients/{client_id}/quote-drafts

  Parameters

  Parameters: create_quote_draft

  Name	Type	Description
  client_id string required	string	Client id from list_clients or create_client.
  site_id string	string	Job site id from list_sites.
  title string	string	Description shown on the quote.
  lines array required	array	Lines, each with kind (supply, labour or work), label, quantity, unit, unit_price_excl_vat and vat_rate in percent.

  Example input

  {
    "client_id": "cl_5a90d1",
    "site_id": "st_77c2e0",
    "title": "Bathroom floor tiling",
    "lines": [
      {
        "kind": "supply",
        "label": "Stoneware tiles",
        "quantity": 22,
        "unit": "m2",
        "unit_price_excl_vat": 32,
        "vat_rate": 10
      },
      {
        "kind": "labour",
        "label": "Tile laying",
        "quantity": 22,
        "unit": "m2",
        "unit_price_excl_vat": 45,
        "vat_rate": 10
      }
    ]
  }

  Example response

  {
    "quote_id": "qt_8f21c4",
    "status": "draft",
    "number": null,
    "client": "Martin",
    "total_excl_vat": 1694,
    "total_vat": 169.4,
    "total_incl_vat": 1863.4
  }

• send_quote Finalize a quote and email it, with or without e-signature. writeAsks first

  send_quote finalizes the quote, so it gets its definitive number and can no longer be edited as a draft, then emails it to the client. With allow_e_signature the client gets a link and signs with a code sent to the mobile number; Obat uses Universign for this. It fails if the quote has no client or the client has no email. By default you confirm each call; you can switch that off for this tool.

  MCP callobat_write → send_quote

  REST endpointPOST https://cotlet.dev/api/v1/obat/quotes/{quote_id}

  Parameters

  Parameters: send_quote

  Name	Type	Description
  quote_id string required	string	Quote id from list_quotes or create_quote_draft.
  allow_e_signature boolean	boolean	Let the client sign online. Needs the client mobile number. Defaults to false.
  message string	string	Text of the email. Omit to keep the default.

  Example input

  {
    "quote_id": "quote_8c41d2"
  }

  Example response

  {
    "quote_id": "qt_8f21c4",
    "number": "DE-0413",
    "status": "sent",
    "e_signature_requested": true,
    "sent_to": "martin@example.com"
  }

ToolWhat it doesAccess

• list_invoices List invoices with client, status, amount and due date. read

  list_invoices returns invoices with id, number, client, status, total excluding VAT, due date and how many reminders were sent (Obat allows up to three). Drafts are listed but have no number. Obat does not count drafts in its totals, and neither does get_receivables_summary.

  MCP callobat_read → list_invoices

  REST endpointGET https://cotlet.dev/api/v1/obat/invoices

  Parameters

  Parameters: list_invoices

  Name	Type	Description
  status string	string	Filter by status: draft, sent, partially_paid, paid or overdue. These map to Brouillon, Envoyé, Payé partiellement, Payé and the En retard tab. Omit for all.
  client_id string	string	Only invoices of this client.
  cursor string	string	Cursor from the previous page.

  Example response

  {
    "invoices": [
      {
        "invoice_id": "inv_31a07e",
        "number": "FA-0188",
        "client": "Lefèvre",
        "status": "overdue",
        "total_excl_vat": 1800,
        "due_date": "2026-10-28",
        "reminders_sent": 0
      },
      {
        "invoice_id": "inv_31a0b2",
        "number": "FA-0191",
        "client": "Bernard",
        "status": "overdue",
        "total_excl_vat": 950,
        "due_date": "2026-11-02",
        "reminders_sent": 2
      }
    ],
    "next_cursor": null
  }

• get_invoice Read one invoice with its lines and payments. read

  get_invoice returns the invoice type (deposit, progress or final), its lines, totals, the quote it comes from and the payments recorded so far. It reads what the invoice screen shows.

  MCP callobat_read → get_invoice

  REST endpointGET https://cotlet.dev/api/v1/obat/invoices/{invoice_id}

  Parameters

  Parameters: get_invoice

  Name	Type	Description
  invoice_id string required	string	Invoice id from list_invoices.

  Example input

  {
    "invoice_id": "invoice_8c41d2"
  }

  Example response

  {
    "invoice_id": "inv_31a07e",
    "number": "FA-0188",
    "type": "deposit",
    "from_quote": "DE-0412",
    "client": "Lefèvre",
    "status": "overdue",
    "total_excl_vat": 1800,
    "payments": []
  }

• create_invoice_from_quote Create a deposit, progress or final invoice draft from a signed quote. write

  create_invoice_from_quote makes the invoice as a draft, with no number and nobody told, the same as the Facturer button on a quote. Obat only invoices a signed quote. In progress and final invoices Obat counts deposits already invoiced. Send the draft with send_invoice. The draft reaches nobody and you can delete it in Obat, so it does not wait for your OK.

  MCP callobat_write → create_invoice_from_quote

  REST endpointPOST https://cotlet.dev/api/v1/obat/quotes/{quote_id}/invoice-from-quotes

  Parameters

  Parameters: create_invoice_from_quote

  Name	Type	Description
  quote_id string required	string	Id of a signed quote.
  invoice_type string required	string	deposit, progress or final. progress is the global progress invoice, not the line by line one.
  percent number	number	Share of the quote to invoice, for deposit and progress.
  amount_excl_vat number	number	Amount to invoice instead of a percent.

  Example input

  {
    "quote_id": "quote_8c41d2",
    "invoice_type": "invoice type"
  }

  Example response

  {
    "invoice_id": "inv_31a0c4",
    "status": "draft",
    "number": null,
    "type": "deposit",
    "from_quote": "DE-0412",
    "total_excl_vat": 508.2
  }

• send_invoice Finalize an invoice and email it to the client. writeAsks first

  send_invoice finalizes the draft, which gives it its definitive number and locks it, then emails it to the client. Obat allows deleting or cancelling a finalized invoice only under conditions, and a cancelled one needs a credit note, so check the draft with get_invoice first. By default you confirm each call; you can switch that off for this tool.

  MCP callobat_write → send_invoice

  REST endpointPOST https://cotlet.dev/api/v1/obat/invoices/{invoice_id}

  Parameters

  Parameters: send_invoice

  Name	Type	Description
  invoice_id string required	string	Invoice id of a draft from list_invoices.
  message string	string	Text of the email. Omit to keep the default.

  Example input

  {
    "invoice_id": "invoice_8c41d2"
  }

  Example response

  {
    "invoice_id": "inv_31a0c4",
    "number": "FA-0192",
    "status": "sent",
    "sent_to": "martin@example.com"
  }

ToolWhat it doesAccess

• get_receivables_summary Read the "Total reste à encaisser" figures from the account home. read

  get_receivables_summary returns the total left to collect excluding VAT and the late part of it, as Obat shows on the home screen. Obat counts invoices with status Envoyé or Payé partiellement, late or not. Drafts and negative invoices are left out, and credit notes linked to invoices are not deducted.

  MCP callobat_read → get_receivables_summary

  REST endpointGET https://cotlet.dev/api/v1/obat/receivables-summary

  Parameters

  No parameters.

  Example response

  {
    "to_collect_excl_vat": 9650,
    "of_which_late_excl_vat": 2750,
    "invoices_counted": 6
  }

• send_invoice_reminder Email a payment reminder for an overdue invoice. writeAsks first

  send_invoice_reminder does what the numbered reminder buttons in the En retard tab do: Obat builds an email, and this tool sends it. Obat allows up to three reminders per invoice, and the text comes from Settings under Envoi d'emails. It fails for an invoice that is not overdue. By default you confirm each call; you can switch that off for this tool.

  MCP callobat_write → send_invoice_reminder

  REST endpointPOST https://cotlet.dev/api/v1/obat/invoices/{invoice_id}/reminder

  Parameters

  Parameters: send_invoice_reminder

  Name	Type	Description
  invoice_id string required	string	Id of an invoice with status overdue.
  reminder_number number	number	Which reminder to send, 1 to 3 as Obat numbers them. Defaults to the next one.
  message string	string	Replacement text. Omit to use the account reminder text.

  Example input

  {
    "invoice_id": "invoice_8c41d2"
  }

  Example response

  {
    "invoice_id": "inv_31a07e",
    "reminder_number": 1,
    "status": "sent",
    "sent_to": "lefevre@example.com"
  }

ToolWhat it doesAccess

• list_clients List clients with their addresses, emails and phone numbers. read

  list_clients returns each client with id, type (individual or professional), name, emails, phone numbers and addresses. Obat lets a client have several addresses, emails and phone numbers, and so does the result. Use it to find a client_id before drafting a quote.

  MCP callobat_read → list_clients

  REST endpointGET https://cotlet.dev/api/v1/obat/clients

  Parameters

  Parameters: list_clients

  Name	Type	Description
  search string	string	Part of a name to match.
  cursor string	string	Cursor from the previous page.

  Example response

  {
    "clients": [
      {
        "client_id": "cl_5a90d1",
        "type": "individual",
        "name": "Martin",
        "emails": [
          "martin@example.com"
        ],
        "phones": [
          "+33 6 00 00 00 00"
        ]
      }
    ],
    "next_cursor": null
  }

• list_sites List job sites (chantiers) with their client and address. read

  list_sites returns the job sites of the Chantiers tab with id, name, client and address. A job site can have an address that differs from the client billing address.

  MCP callobat_read → list_sites

  REST endpointGET https://cotlet.dev/api/v1/obat/sites

  Parameters

  Parameters: list_sites

  Name	Type	Description
  client_id string	string	Only job sites of this client.
  cursor string	string	Cursor from the previous page.

  Example response

  {
    "sites": [
      {
        "site_id": "st_77c2e0",
        "name": "Bathroom renovation",
        "client": "Martin",
        "address": "12 rue des Lilas, Nantes"
      }
    ],
    "next_cursor": null
  }

• create_client Add a client, individual or professional. write

  create_client adds the client to the Contacts list, as the New client button in a quote does. It reaches nobody, so it does not wait for your OK; Cotlet has no delete tool, so remove a client by hand in Obat. Run list_clients first to avoid a duplicate.

  MCP callobat_write → create_client

  REST endpointPOST https://cotlet.dev/api/v1/obat/clients

  Parameters

  Parameters: create_client

  Name	Type	Description
  name string required	string	Client name.
  type string	string	individual or professional. Defaults to individual.
  email string	string	Email address.
  phone string	string	Mobile or landline number. Needed later for e-signature.
  address string	string	Billing address on one line.

  Example input

  {
    "name": "Jane Doe"
  }

  Example response

  {
    "client_id": "cl_5a90d1",
    "name": "Martin",
    "type": "individual"
  }

• create_site Add a job site for a client. write

  create_site adds a job site, as New job site does in a quote. It reaches nobody, so it does not wait for your OK; remove it by hand in Obat if you do not need it. A quote draft can then name this job site.

  MCP callobat_write → create_site

  REST endpointPOST https://cotlet.dev/api/v1/obat/clients/{client_id}/sites

  Parameters

  Parameters: create_site

  Name	Type	Description
  client_id string required	string	Client id from list_clients.
  name string required	string	Job site name.
  address string	string	Address if it differs from the client billing address.

  Example input

  {
    "client_id": "client_8c41d2",
    "name": "Jane Doe"
  }

  Example response

  {
    "site_id": "st_77c2e0",
    "name": "Bathroom renovation",
    "client_id": "cl_5a90d1"
  }