Tolteck API and MCP server Let your AI agent write the quote and chase the invoice.

ToolWhat it doesAccess

• list_documents List the documents of the Quotes & Invoices tab, filtered like the tab. read

  Returns one row per document: id, type, number, site name, client, status, date and total. It reads the same list the tab shows with the same filters, so an unnumbered draft appears without a number. It changes nothing.

  MCP calltolteck_read → list_documents

  REST endpointGET https://cotlet.dev/api/v1/tolteck/documents

  Parameters

  Parameters: list_documents

  Name	Type	Description
  type string	string	Document type as Tolteck names it: quote (devis), invoice, deposit invoice, interim invoice, progress invoice or credit note (avoir). Omit for all.
  status string	string	Status as shown in the app, for example Finalisée or Payée. Omit for all.
  from string	string	Start of the period, YYYY-MM-DD.
  to string	string	End of the period, YYYY-MM-DD.
  client string	string	Part of the client name.

  Example response

  {
    "documents": [
      {
        "id": "doc_8f21c4",
        "type": "invoice",
        "number": "F-2026-0017",
        "site": "Rénovation salle de bain",
        "client": "Martin Dupont",
        "status": "Finalisée",
        "date": "2026-10-28",
        "total_ttc": 2400
      },
      {
        "id": "doc_7a90b2",
        "type": "quote",
        "number": "D-2026-0042",
        "site": "Rénovation salle de bain",
        "client": "Martin Dupont",
        "status": "Finalisée",
        "date": "2026-10-10",
        "total_ttc": 4620
      }
    ]
  }

• get_document Read one quote or invoice with its lines, totals and payment schedule. read

  Returns the header (client, site name, number, status, dates), every line with its quantity and unit price, the totals before and after tax and the deposits listed on the document. It does not download the PDF. It changes nothing.

  MCP calltolteck_read → get_document

  REST endpointGET https://cotlet.dev/api/v1/tolteck/documents/{document_id}

  Parameters

  Parameters: get_document

  Name	Type	Description
  document_id string required	string	Document id from list_documents.

  Example input

  {
    "document_id": "document_8c41d2"
  }

  Example response

  {
    "id": "doc_7a90b2",
    "type": "quote",
    "number": "D-2026-0042",
    "site": "Rénovation salle de bain",
    "client": "Martin Dupont",
    "status": "Finalisée",
    "lines": [
      {
        "kind": "labor",
        "label": "Main d'œuvre",
        "quantity": 2,
        "unit": "day",
        "unit_price_ht": 320
      },
      {
        "kind": "material",
        "label": "Carrelage et colle",
        "quantity": 1,
        "unit": "lot",
        "unit_price_ht": 3560
      }
    ],
    "total_ht": 4200,
    "vat": 420,
    "total_ttc": 4620
  }

• create_quote Create a quote for a client with lines and an optional deposit. write

  Returns the quote id, its number and its totals. The quote is saved, not sent: sending is a separate call. Each line is also saved in your materials library, as when you type it by hand. It reaches no one and you can delete it in Tolteck, so it does not wait for your OK.

  MCP calltolteck_write → create_quote

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

  Parameters

  Parameters: create_quote

  Name	Type	Description
  site_name string required	string	Name of the site (chantier) the quote belongs to.
  client_id string required	string	Client id from list_clients or create_client.
  lines array required	array	Lines as objects: kind (material, labor or work), label, quantity, unit_price_ht.
  deposit_percent number	number	Deposit as a percentage of the quote. Omit for no deposit.

  Example input

  {
    "site_name": "site name",
    "client_id": "client_8c41d2",
    "lines": "lines"
  }

  Example response

  {
    "document_id": "doc_7a90b2",
    "number": "D-2026-0042",
    "total_ht": 4200,
    "vat": 420,
    "total_ttc": 4620,
    "deposit_ttc": 1386
  }

• create_deposit_invoice Create a deposit invoice from an existing quote. write

  Does what Actions > Faire une facture d'acompte does on a quote. Returns the invoice id, its number and the amounts. The deposit invoice does not repeat the quote lines. It is created but not sent, and it reaches no one until send_document runs, so it does not wait for your OK.

  MCP calltolteck_write → create_deposit_invoice

  REST endpointPOST https://cotlet.dev/api/v1/tolteck/quotes/{quote_id}/deposit-invoices

  Parameters

  Parameters: create_deposit_invoice

  Name	Type	Description
  quote_id string required	string	Quote id from list_documents.
  percent number required	number	Deposit as a percentage of the quote total.

  Example input

  {
    "quote_id": "doc_7a90b2",
    "percent": 30
  }

  Example response

  {
    "document_id": "doc_9d3e51",
    "number": "F-2026-0018",
    "type": "deposit invoice",
    "quote_id": "doc_7a90b2",
    "percent": 30,
    "amount_ht": 1260,
    "vat": 126,
    "amount_ttc": 1386
  }

• create_credit_note Cancel an invoice in full or in part with a credit note (facture d'avoir). writeAsks first

  Does what Actions > Annuler la facture (full) or Faire une facture d'avoir (partial) does. Returns the credit note number and amount. A credit note is a legal accounting document and stays in your numbering. By default you confirm each call; you can switch that off for this tool.

  MCP calltolteck_write → create_credit_note

  REST endpointPOST https://cotlet.dev/api/v1/tolteck/invoices/{invoice_id}/credit-notes

  Parameters

  Parameters: create_credit_note

  Name	Type	Description
  invoice_id string required	string	Invoice id from list_documents. It must have been created in Tolteck.
  amount_ttc number	number	Amount to credit. Omit to cancel the invoice at 100%.

  Example input

  {
    "invoice_id": "invoice_8c41d2"
  }

  Example response

  {
    "document_id": "doc_a41f07",
    "number": "A-2026-0003",
    "type": "credit note",
    "invoice_id": "doc_9d3e51",
    "amount_ttc": 1386
  }

ToolWhat it doesAccess

• send_document Email a quote or invoice to the client from Tolteck. writeAsks first

  Does what Send > Send by email does and returns the recipient and the time. The client replies land in your own mailbox. The email cannot be recalled. By default you confirm each call; you can switch that off for this tool.

  MCP calltolteck_write → send_document

  REST endpointPOST https://cotlet.dev/api/v1/tolteck/documents/{document_id}

  Parameters

  Parameters: send_document

  Name	Type	Description
  document_id string required	string	Document id from list_documents, create_quote or create_deposit_invoice.
  message string	string	Text of the email. Omit to use Tolteck's standard text.

  Example input

  {
    "document_id": "document_8c41d2"
  }

  Example response

  {
    "document_id": "doc_8f21c4",
    "number": "F-2026-0017",
    "sent_to": "martin.dupont@example.com",
    "sent_at": "2026-11-14T09:02:00Z"
  }

• list_unpaid_invoices List finalized invoices that are not paid yet. read

  Returns the same list as Invoices awaiting payment on the dashboard: invoice number, client, amount, issue date and due date. Newest first. A paid invoice leaves the list once it has the status Payée. It changes nothing.

  MCP calltolteck_read → list_unpaid_invoices

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

  Parameters

  Parameters: list_unpaid_invoices

  Name	Type	Description
  client string	string	Part of the client name.

  Example response

  {
    "invoices": [
      {
        "id": "doc_8f21c4",
        "number": "F-2026-0017",
        "client": "Martin Dupont",
        "total_ttc": 2400,
        "issued": "2026-10-28",
        "due": "2026-11-27"
      },
      {
        "id": "doc_6c11e9",
        "number": "F-2026-0012",
        "client": "SCI Les Tilleuls",
        "total_ttc": 960,
        "issued": "2026-09-15",
        "due": "2026-10-15"
      }
    ]
  }

• mark_invoice_paid Set an invoice to the status Payée. write

  Sets the status Payée. The invoice leaves the unpaid list and counts in your turnover tracking. It reaches no one and you can change the status back in Tolteck, so it does not wait for your OK.

  MCP calltolteck_write → mark_invoice_paid

  REST endpointPOST https://cotlet.dev/api/v1/tolteck/documents/{document_id}/invoice-paid/mark

  Parameters

  Parameters: mark_invoice_paid

  Name	Type	Description
  document_id string required	string	Invoice id from list_unpaid_invoices.

  Example input

  {
    "document_id": "document_8c41d2"
  }

  Example response

  {
    "document_id": "doc_8f21c4",
    "number": "F-2026-0017",
    "status": "Payée"
  }

ToolWhat it doesAccess

• list_clients List the client base of the Clients tab. read

  Returns each client with id, type (individual or company), name, email, phone and city. It shows whether a client already exists, so an agent does not create a duplicate. It changes nothing.

  MCP calltolteck_read → list_clients

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

  Parameters

  Parameters: list_clients

  Name	Type	Description
  search string	string	Part of a name, email or phone.

  Example response

  {
    "clients": [
      {
        "id": "cli_41d7",
        "type": "individual",
        "name": "Martin Dupont",
        "email": "martin.dupont@example.com",
        "phone": "0612345678",
        "city": "Lyon"
      }
    ]
  }

• get_client Read one client sheet, with its notes and documents. read

  Returns the details of the client sheet (address, phone, email, SIREN or SIRET and VAT number for a company), the notes and the ids of the client's documents. It changes nothing.

  MCP calltolteck_read → get_client

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

  Parameters

  Parameters: get_client

  Name	Type	Description
  client_id string required	string	Client id from list_clients.

  Example input

  {
    "client_id": "client_8c41d2"
  }

  Example response

  {
    "id": "cli_41d7",
    "type": "individual",
    "name": "Martin Dupont",
    "address": "12 rue des Lilas, 69003 Lyon",
    "email": "martin.dupont@example.com",
    "phone": "0612345678",
    "notes": "Key with the neighbor, access by the courtyard",
    "document_ids": [
      "doc_7a90b2",
      "doc_8f21c4"
    ]
  }

• create_client Create a client sheet. write

  Returns the new client id. Tolteck refuses an email in the wrong format or a phone number with dots, and the error names the field. The sheet reaches no one and you can edit it in the Clients tab, so it does not wait for your OK.

  MCP calltolteck_write → create_client

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

  Parameters

  Parameters: create_client

  Name	Type	Description
  type string required	string	individual or company.
  name string required	string	Name of the person or company.
  address string	string	Postal address.
  email string	string	Email address, in a valid format.
  phone string	string	Phone number without dots, for example 0612345678.
  siret string	string	SIREN or SIRET, for a company.

  Example input

  {
    "type": "type",
    "name": "Jane Doe"
  }

  Example response

  {
    "client_id": "cli_41d7",
    "name": "Martin Dupont",
    "type": "individual",
    "created": true
  }

ToolWhat it doesAccess

• list_materials Search your library of materials, labor and works. read

  Returns items from your own library with label, kind and unit price. Tolteck saves every material or work you use in a quote there. Items from supplier price lists you connected appear only if they are in your library. It changes nothing.

  MCP calltolteck_read → list_materials

  REST endpointGET https://cotlet.dev/api/v1/tolteck/materials

  Parameters

  Parameters: list_materials

  Name	Type	Description
  search string	string	Part of the item name.

  Example response

  {
    "items": [
      {
        "id": "mat_203",
        "kind": "material",
        "label": "Carrelage grès cérame 60x60",
        "unit": "m2",
        "unit_price_ht": 38.5
      },
      {
        "id": "mat_377",
        "kind": "material",
        "label": "Colle carrelage",
        "unit": "bag",
        "unit_price_ht": 24
      }
    ]
  }

• get_dashboard Read the turnover and activity figures of the dashboard. read

  Returns the figures the dashboard shows for the period, such as quoted, invoiced and paid amounts. Tolteck counts an invoice in turnover once it has the status Payée, so unpaid invoices are not in the paid figure. It changes nothing.

  MCP calltolteck_read → get_dashboard

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

  Parameters

  Parameters: get_dashboard

  Name	Type	Description
  from string	string	Start of the period, YYYY-MM-DD.
  to string	string	End of the period, YYYY-MM-DD.

  Example response

  {
    "from": "2026-10-01",
    "to": "2026-10-31",
    "quoted_ttc": 9180,
    "invoiced_ttc": 6840,
    "paid_ttc": 4440
  }