Batappli API and MCP server Let your AI agent quote the job and chase the payment.

ToolWhat it doesAccess

• list_clients List the clients (and other contacts) of your Batappli account, with an optional name search. read

  Returns the clients with the id of each client file, their name and the contact details shown on the file. Batappli gives every client a file that holds the history of their documents and payments. Suppliers and subcontractors are contacts of the same kind and are listed the same way. Pages follow next_cursor until it is null.

  MCP callbatappli_read → list_clients

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

  Parameters

  Parameters: list_clients

  Name	Type	Description
  search string	string	Part of a client name.
  cursor string	string	next_cursor of the previous page.

  Example response

  {
    "clients": [
      {
        "client_id": "cl_4821",
        "name": "Camille Roux",
        "email": "camille@example.com",
        "phone": "06 00 00 00 01"
      },
      {
        "client_id": "cl_4790",
        "name": "Syndic Les Tilleuls",
        "email": "compta@example.com",
        "phone": ""
      }
    ],
    "next_cursor": null
  }

• get_client Open one client file: contact details, documents, payments and what is unpaid. read

  Returns the same things as the client file in Batappli: the contact, the list of quotes and invoices with their type, date and amount, the payments, and the unpaid total shown at the top of the file. Read this before a reminder or a quote so the agent knows what the client already has.

  MCP callbatappli_read → get_client

  REST endpointGET https://cotlet.dev/api/v1/batappli/clients/{client_id}

  Parameters

  Parameters: get_client

  Name	Type	Description
  client_id string required	string	Id from list_clients.

  Example input

  {
    "client_id": "client_8c41d2"
  }

  Example response

  {
    "client_id": "cl_4821",
    "name": "Camille Roux",
    "documents": [
      {
        "document_id": "doc_9032",
        "type": "Devis",
        "date": "2026-11-03",
        "total_ttc": 861.59,
        "status": "Accepted"
      },
      {
        "document_id": "doc_9047",
        "type": "Facture d'acompte",
        "date": "2026-11-10",
        "total_ttc": 258.48,
        "status": "Paid"
      }
    ],
    "payments": [
      {
        "date": "2026-11-10",
        "amount": 258.48,
        "method": "Virement"
      }
    ],
    "unpaid_total": 0
  }

• create_client Create a client file in Batappli. write

  Creates the client with an empty file that fills with their documents and payments. Search with list_clients first so the agent does not create a duplicate. It reaches no one: the client is not notified, so it does not wait for your OK, and you can edit or delete the client in Batappli.

  MCP callbatappli_write → create_client

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

  Parameters

  Parameters: create_client

  Name	Type	Description
  name string required	string	Client name.
  email string	string	Email address.
  phone string	string	Phone number.
  address string	string	Postal address, one line.

  Example input

  {
    "name": "Jane Doe"
  }

  Example response

  {
    "client_id": "cl_4833",
    "name": "Camille Roux",
    "email": "camille@example.com",
    "phone": "06 00 00 00 01"
  }

ToolWhat it doesAccess

• list_quotes List quotes with the columns of the Batappli list: date, client, amount, deposit and status. read

  Returns the quote id, number, client, date, total including VAT, deposit received and status of each quote. It returns the list only; get_quote gives the lines and the margin. Amounts are the ones Batappli shows, no conversion.

  MCP callbatappli_read → list_quotes

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

  Parameters

  Parameters: list_quotes

  Name	Type	Description
  status string	string	The status label as shown in Batappli. Batappli lets you customise quote statuses, so use a label from your own list.
  client_id string	string	Only this client's quotes.
  since string	string	Only quotes dated on or after this date, YYYY-MM-DD.
  cursor string	string	next_cursor of the previous page.

  Example response

  {
    "quotes": [
      {
        "quote_id": "doc_9032",
        "number": "D-0412",
        "client": "Camille Roux",
        "date": "2026-11-03",
        "total_ttc": 861.59,
        "deposit": 258.48,
        "status": "Accepted"
      },
      {
        "quote_id": "doc_9020",
        "number": "D-0409",
        "client": "Syndic Les Tilleuls",
        "date": "2026-10-28",
        "total_ttc": 3400,
        "deposit": 0,
        "status": "Sent"
      }
    ],
    "next_cursor": null
  }

• get_quote Read one quote: lines, totals, deposits and the margin Batappli shows on it. read

  Returns each line with its description, quantity, unit and unit price, the totals before and after VAT, and the deposits recorded. It also returns the gross margin, the cost price and the margin coefficient that Batappli shows on every quote, for labour and for supplies. Nothing is changed.

  MCP callbatappli_read → get_quote

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

  Parameters

  Parameters: get_quote

  Name	Type	Description
  quote_id string required	string	Id from list_quotes.

  Example input

  {
    "quote_id": "quote_8c41d2"
  }

  Example response

  {
    "quote_id": "doc_9032",
    "number": "D-0412",
    "client": "Camille Roux",
    "lines": [
      {
        "description": "Chauffe-eau électrique 200 L",
        "quantity": 1,
        "unit": "U",
        "unit_price_ht": 620.75,
        "total_ht": 620.75
      },
      {
        "description": "Main d'oeuvre, dépose et installation",
        "quantity": 3,
        "unit": "H",
        "unit_price_ht": 54.17,
        "total_ht": 162.51
      }
    ],
    "total_ht": 783.26,
    "vat": 78.33,
    "total_ttc": 861.59,
    "deposits": [
      {
        "date": "2026-11-10",
        "amount": 258.48
      }
    ],
    "status": "Accepted"
  }

• create_quote Create a quote for a client from lines you give, without sending it. write

  Creates the quote in Batappli with the next quote number and returns its id and totals. It does not use the price library or Batappli.ia: the lines are the ones your agent writes. The quote stays a draft until share_quote sends it. It reaches no one and you can delete it in Batappli, so it does not wait for your OK.

  MCP callbatappli_write → create_quote

  REST endpointPOST https://cotlet.dev/api/v1/batappli/clients/{client_id}/quotes

  Parameters

  Parameters: create_quote

  Name	Type	Description
  client_id string required	string	Id from list_clients or create_client.
  lines array required	array	Each line: description, quantity, unit (for example U or H) and unit_price_ht.
  vat_rate number required	number	VAT rate in percent for every line, for example 10 or 20.

  Example input

  {
    "client_id": "cl_4833",
    "lines": [
      {
        "description": "Chauffe-eau électrique 200 L",
        "quantity": 1,
        "unit": "U",
        "unit_price_ht": 620.75
      },
      {
        "description": "Main d'oeuvre, dépose et installation",
        "quantity": 3,
        "unit": "H",
        "unit_price_ht": 54.17
      }
    ],
    "vat_rate": 10
  }

  Example response

  {
    "quote_id": "doc_9032",
    "number": "D-0412",
    "client": "Camille Roux",
    "total_ht": 783.26,
    "vat": 78.33,
    "total_ttc": 861.59,
    "status": "Draft"
  }

• share_quote Share a quote with the client by email, by online link or as a PDF. writeAsks first

  Uses the Share button of the quote. With `email` Batappli sends the quote to the client; with `link` it returns the online page where the client can read the quote; with `pdf` it returns the file and sends nothing. The email cannot be recalled. By default you confirm each call; you can switch that off for this tool.

  MCP callbatappli_write → share_quote

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

  Parameters

  Parameters: share_quote

  Name	Type	Description
  quote_id string required	string	Id from list_quotes or create_quote.
  method string required	string	One of `email`, `link`, `pdf`: the three ways of the Share button.
  message string	string	Text of the email, for `email`.

  Example input

  {
    "quote_id": "quote_8c41d2",
    "method": "method"
  }

  Example response

  {
    "quote_id": "doc_9032",
    "method": "email",
    "sent_to": "camille@example.com"
  }

ToolWhat it doesAccess

• list_invoices List invoices with their type, date, amount and payment state. read

  Returns the invoice id, number, type, client, date, total including VAT, amount still due and due date. The list is the one on the Batappli invoices screen. Use list_unpaid_invoices when you only want what is late.

  MCP callbatappli_read → list_invoices

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

  Parameters

  Parameters: list_invoices

  Name	Type	Description
  type string	string	The type column of the list, for example the deposit invoice (acompte), situation or credit note (avoir) types Batappli has.
  client_id string	string	Only this client's invoices.
  since string	string	Only invoices dated on or after this date, YYYY-MM-DD.
  cursor string	string	next_cursor of the previous page.

  Example response

  {
    "invoices": [
      {
        "invoice_id": "doc_9047",
        "number": "F-0388",
        "type": "Facture d'acompte",
        "client": "Camille Roux",
        "date": "2026-11-10",
        "total_ttc": 258.48,
        "due": 0
      },
      {
        "invoice_id": "doc_9051",
        "number": "F-0389",
        "type": "Facture",
        "client": "Camille Roux",
        "date": "2026-11-13",
        "total_ttc": 861.59,
        "due": 603.11
      }
    ],
    "next_cursor": null
  }

• record_deposit Record a deposit received on a quote; Batappli creates the deposit invoice. writeAsks first

  Does what Add a payment (Ajouter un règlement) does in the Deposits tab of a quote: it records the payment and Batappli creates the deposit invoice (facture d'acompte) by itself. The invoice takes the next number in your invoice sequence and feeds your accounting export. Check the amount with the client first. By default you confirm each call; you can switch that off for this tool.

  MCP callbatappli_write → record_deposit

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

  Parameters

  Parameters: record_deposit

  Name	Type	Description
  quote_id string required	string	Id from list_quotes.
  amount number required	number	Amount received, as Batappli shows amounts.
  method string required	string	Payment method as named in Batappli, for example transfer or cheque.

  Example input

  {
    "quote_id": "quote_8c41d2",
    "amount": 1,
    "method": "method"
  }

  Example response

  {
    "quote_id": "doc_9032",
    "invoice_id": "doc_9047",
    "number": "F-0388",
    "type": "Facture d'acompte",
    "amount": 258.48
  }

• convert_quote_to_invoice Convert a quote into an invoice with all its amounts. writeAsks first

  Does what Convert does in the quote list: Batappli creates the invoice with every line and amount of the quote and its due date. The invoice takes the next number in your sequence and cannot be renumbered, so the agent checks the quote with get_quote first. It sends nothing to the client. By default you confirm each call; you can switch that off for this tool.

  MCP callbatappli_write → convert_quote_to_invoice

  REST endpointPOST https://cotlet.dev/api/v1/batappli/quotes/{quote_id}/to-invoice/convert

  Parameters

  Parameters: convert_quote_to_invoice

  Name	Type	Description
  quote_id string required	string	Id from list_quotes.

  Example input

  {
    "quote_id": "quote_8c41d2"
  }

  Example response

  {
    "invoice_id": "doc_9051",
    "number": "F-0389",
    "client": "Camille Roux",
    "total_ttc": 861.59,
    "due": 603.11
  }

• record_payment Record a payment received on an invoice, as Cash the due date does in Batappli. writeAsks first

  Uses the Payment tab of the invoice (Encaisser l'échéance): it records the payment against the due date, so the invoice leaves the unpaid list when it is paid in full. Batappli puts the payment in your next accounting export, so a wrong amount reaches your accountant. By default you confirm each call; you can switch that off for this tool.

  MCP callbatappli_write → record_payment

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

  Parameters

  Parameters: record_payment

  Name	Type	Description
  invoice_id string required	string	Id from list_invoices or list_unpaid_invoices.
  amount number required	number	Amount received.
  method string required	string	Payment method as named in Batappli.

  Example input

  {
    "invoice_id": "invoice_8c41d2",
    "amount": 1,
    "method": "method"
  }

  Example response

  {
    "invoice_id": "doc_9051",
    "amount": 603.11,
    "method": "Virement",
    "due": 0
  }

ToolWhat it doesAccess

• list_unpaid_invoices List the unpaid invoices from the Batappli unpaid tracking: client, amount and days late. read

  Returns what Batappli shows in its unpaid alert at start-up: the client, the amount due and the days late for each invoice, with the invoice id you pass to send_payment_reminder. Batappli computes the days late, nothing is estimated. Nothing is sent.

  MCP callbatappli_read → list_unpaid_invoices

  REST endpointGET https://cotlet.dev/api/v1/batappli/unpaid-invoices

  Parameters

  Parameters: list_unpaid_invoices

  Name	Type	Description
  client_id string	string	Only this client's unpaid invoices.

  Example response

  {
    "unpaid": [
      {
        "invoice_id": "doc_8920",
        "number": "F-0371",
        "client": "Syndic Les Tilleuls",
        "amount_due": 1200,
        "days_late": 34
      },
      {
        "invoice_id": "doc_9051",
        "number": "F-0389",
        "client": "Camille Roux",
        "amount_due": 603.11,
        "days_late": 2
      }
    ]
  }

• send_payment_reminder Email a reminder for an unpaid invoice, from one of the three Batappli templates. writeAsks first

  Does what the reminder button in the unpaid tracking window does: it emails the client the chosen template for this invoice. The three templates go from friendly to formal, and Batappli suggests that order. The email reaches your client and cannot be recalled. By default you confirm each call; you can switch that off for this tool.

  MCP callbatappli_write → send_payment_reminder

  REST endpointPOST https://cotlet.dev/api/v1/batappli/invoices/{invoice_id}/payment-reminders

  Parameters

  Parameters: send_payment_reminder

  Name	Type	Description
  invoice_id string required	string	Id from list_unpaid_invoices.
  template string required	string	One of `courtoisie`, `avertissement`, `mise_en_demeure`: the three email templates of the unpaid tracking window.
  message string	string	Extra text added to the template.

  Example input

  {
    "invoice_id": "invoice_8c41d2",
    "template": "template"
  }

  Example response

  {
    "invoice_id": "doc_8920",
    "template": "avertissement",
    "sent_to": "compta@example.com"
  }

• get_dashboard Read the Analysis dashboard: revenue, margin and profitability for a period. read

  Returns the indicators of the Analyse > Tableau de bord screen for the period: invoiced revenue, collections, gross margin and the margin rate. Without dates it returns the period the dashboard opens on. Figures are the ones Batappli shows, with no recalculation. It changes nothing.

  MCP callbatappli_read → get_dashboard

  REST endpointGET https://cotlet.dev/api/v1/batappli/dashboard

  Parameters

  Parameters: get_dashboard

  Name	Type	Description
  from string	string	First day, YYYY-MM-DD.
  to string	string	Last day, YYYY-MM-DD.

  Example response

  {
    "period": {
      "from": "2026-11-02",
      "to": "2026-11-08"
    },
    "invoiced_ht": 6840,
    "collected": 4120,
    "gross_margin": 2394,
    "margin_rate": 35
  }