Extrabat API and MCP server Let your AI agent chase quotes and book site visits.

ToolWhat it doesAccess

• search_customers Find customers and prospects by name, phone, email or city. read

  Returns the matching customer files with their contact details, in the order Extrabat lists them. Use it before create_customer to avoid duplicates. It reads what your user can open in the Gestion client / CRM module.

  MCP callextrabat_read → search_customers

  REST endpointGET https://cotlet.dev/api/v1/extrabat/customers/search

  Parameters

  Parameters: search_customers

  Name	Type	Description
  query string required	string	Text to match against name, phone, email or city
  limit integer	integer	Maximum results to return

  Example input

  {
    "query": "query"
  }

  Example response

  {
    "customers": [
      {
        "customer_id": "c_20481",
        "name": "Durand Piscines",
        "phone": "+33 5 45 00 00 01",
        "email": "contact@durand-example.fr",
        "city": "Angoulême"
      }
    ],
    "total": 1
  }

• create_customer Add a customer or prospect to the CRM. write

  Creates the file in Gestion client / CRM and returns its ID. It reaches no one: Cotlet sends no message to the customer. Search first with search_customers to avoid a duplicate; this tool does not check for one.

  MCP callextrabat_write → create_customer

  REST endpointPOST https://cotlet.dev/api/v1/extrabat/customers

  Parameters

  Parameters: create_customer

  Name	Type	Description
  name string required	string	Company or person name
  phone string	string	Phone number
  email string	string	Email address
  city string	string	City
  note string	string	Free text kept on the file, for example where the lead came from

  Example input

  {
    "name": "Martin Paysage",
    "phone": "+33 5 45 00 00 02",
    "email": "martin@example.fr",
    "city": "Cognac",
    "note": "Lead from website form"
  }

  Example response

  {
    "customer_id": "c_20533",
    "name": "Martin Paysage",
    "created": true
  }

ToolWhat it doesAccess

• list_quotes List quotes (devis) with customer, amount and signature state. read

  Returns quotes from the Gestion commerciale module, newest first, with number, customer, total and the signature state. Reads only, nothing is sent. Quotes you cannot open with your Extrabat user are left out.

  MCP callextrabat_read → list_quotes

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

  Parameters

  Parameters: list_quotes

  Name	Type	Description
  customer_id string	string	Only quotes of this customer
  status string	string	Signature state to filter on, as the Commercial documents list shows it
  created_before string	string	ISO date; only quotes created before it
  limit integer	integer	Maximum results to return

  Example response

  {
    "quotes": [
      {
        "quote_id": "q_5530",
        "number": "DEV-2026-0412",
        "customer": "Durand Piscines",
        "total": 8450,
        "created": "2026-10-28",
        "signature": "waiting"
      }
    ],
    "total": 1
  }

• get_quote Read one quote with its lines, totals and customer contact. read

  Returns the document lines, the totals and the customer email and phone that the e-signature request needs. Reads only.

  MCP callextrabat_read → get_quote

  REST endpointGET https://cotlet.dev/api/v1/extrabat/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": "q_5530",
    "number": "DEV-2026-0412",
    "customer": "Durand Piscines",
    "email": "contact@durand-example.fr",
    "phone": "+33 5 45 00 00 01",
    "lines": [
      {
        "label": "Pool liner replacement",
        "quantity": 1,
        "unit_price": 6800
      },
      {
        "label": "Filtration pump",
        "quantity": 1,
        "unit_price": 1650
      }
    ],
    "total": 8450
  }

• create_quote Create a draft quote for a customer from lines you give. write

  Creates the quote in Gestion commerciale and returns its number and total. It sends nothing to the customer: sending is a separate step, send_quote_for_signature. Check the draft in Extrabat before it goes out.

  MCP callextrabat_write → create_quote

  REST endpointPOST https://cotlet.dev/api/v1/extrabat/customers/{customer_id}/quotes

  Parameters

  Parameters: create_quote

  Name	Type	Description
  customer_id string required	string	Customer ID from search_customers
  lines array required	array	Lines, each with label, quantity and unit_price
  note string	string	Free text for the quote

  Example input

  {
    "customer_id": "customer_8c41d2",
    "lines": "lines"
  }

  Example response

  {
    "quote_id": "q_5561",
    "number": "DEV-2026-0431",
    "customer": "Martin Paysage",
    "total": 2160
  }

• send_quote_for_signature Send a quote to the customer to sign electronically. writeAsks first

  Sends the signature request through Extrabat's Oodrive Sign option, which must be switched on for your account. Extrabat needs both an email and a phone number for the customer, so the call fails when either is missing. The customer gets a message right away. By default you confirm each call; you can switch that off for this tool.

  MCP callextrabat_write → send_quote_for_signature

  REST endpointPOST https://cotlet.dev/api/v1/extrabat/quotes/{quote_id}/for-signature

  Parameters

  Parameters: send_quote_for_signature

  Name	Type	Description
  quote_id string required	string	Quote ID from list_quotes
  email string	string	Customer email; defaults to the one on the quote
  phone string	string	Customer phone; defaults to the one on the quote

  Example input

  {
    "quote_id": "quote_8c41d2"
  }

  Example response

  {
    "quote_id": "q_5530",
    "number": "DEV-2026-0412",
    "sent_to": "contact@durand-example.fr",
    "signature": "sent"
  }

• list_invoices List invoices with customer, amount, due date and payment state. read

  Returns invoices from the Gestion commerciale module with number, customer, total, amount still due and due date. Reads only. Payments are recorded in Extrabat, not by this tool.

  MCP callextrabat_read → list_invoices

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

  Parameters

  Parameters: list_invoices

  Name	Type	Description
  customer_id string	string	Only invoices of this customer
  unpaid_only boolean	boolean	Only invoices not fully paid
  due_before string	string	ISO date; only invoices due before it
  limit integer	integer	Maximum results to return

  Example response

  {
    "invoices": [
      {
        "invoice_id": "i_9021",
        "number": "FAC-2026-0388",
        "customer": "Durand Piscines",
        "total": 3200,
        "due": 1200,
        "due_date": "2026-10-15"
      }
    ],
    "total": 1
  }

ToolWhat it doesAccess

• list_agenda_events List agenda events of one user or the whole team for a date range. read

  Returns events in time order with title, start, end, the user and the linked customer when there is one. Use it to find a free slot before create_agenda_event. Reads only.

  MCP callextrabat_read → list_agenda_events

  REST endpointGET https://cotlet.dev/api/v1/extrabat/agenda-events

  Parameters

  Parameters: list_agenda_events

  Name	Type	Description
  from string required	string	ISO date or datetime, start of the range
  to string required	string	ISO date or datetime, end of the range
  user string	string	Only events of this Extrabat user

  Example input

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

  Example response

  {
    "events": [
      {
        "event_id": "e_7710",
        "title": "Visit: Durand Piscines",
        "start": "2026-11-17T09:00",
        "end": "2026-11-17T10:30",
        "user": "Luc",
        "customer": "Durand Piscines"
      }
    ],
    "total": 1
  }

• create_agenda_event Book an event in the agenda, optionally linked to a customer or worksite. writeAsks first

  Creates the event in the agenda and returns its ID. The agenda syncs to phones, so a technician can see it there soon after. Check list_agenda_events first for a free slot. By default you confirm each call; you can switch that off for this tool.

  MCP callextrabat_write → create_agenda_event

  REST endpointPOST https://cotlet.dev/api/v1/extrabat/agenda-events

  Parameters

  Parameters: create_agenda_event

  Name	Type	Description
  title string required	string	Event title
  start string required	string	ISO datetime
  end string required	string	ISO datetime
  user string	string	Extrabat user whose agenda gets the event
  customer_id string	string	Customer to link
  worksite_id string	string	Worksite to link

  Example input

  {
    "title": "title",
    "start": "start",
    "end": "end"
  }

  Example response

  {
    "event_id": "e_7745",
    "title": "Visit: Martin Paysage",
    "start": "2026-11-18T09:00",
    "end": "2026-11-18T10:00",
    "user": "Luc"
  }

• list_worksites List worksites (chantiers) with customer, address and planning state. read

  Returns the worksites from Gestion et planification des chantiers with customer, address and the planned dates when set. Reads only. Which worksites you see depends on your Extrabat user rights.

  MCP callextrabat_read → list_worksites

  REST endpointGET https://cotlet.dev/api/v1/extrabat/worksites

  Parameters

  Parameters: list_worksites

  Name	Type	Description
  customer_id string	string	Only worksites of this customer
  open_only boolean	boolean	Skip finished worksites
  limit integer	integer	Maximum results to return

  Example response

  {
    "worksites": [
      {
        "worksite_id": "w_3302",
        "name": "Pool renovation, rue des Lilas",
        "customer": "Durand Piscines",
        "city": "Angoulême",
        "planned_start": "2026-11-24"
      }
    ],
    "total": 1
  }

ToolWhat it doesAccess

• list_service_tickets List after-sales (SAV) tickets with customer, status and age. read

  Returns tickets from the Gestion SAV module, oldest first, with customer, status and creation date. Statuses are the ones your account uses, for example "Intervention en cours" or "Retour atelier". Reads only.

  MCP callextrabat_read → list_service_tickets

  REST endpointGET https://cotlet.dev/api/v1/extrabat/service-tickets

  Parameters

  Parameters: list_service_tickets

  Name	Type	Description
  status string	string	Only tickets in this status, using the status names set up in your account
  customer_id string	string	Only tickets of this customer
  limit integer	integer	Maximum results to return

  Example response

  {
    "tickets": [
      {
        "ticket_id": "s_1180",
        "customer": "Durand Piscines",
        "title": "Heat pump alarm",
        "status": "Intervention en cours",
        "created": "2026-11-03"
      }
    ],
    "total": 1
  }

• update_service_ticket_status Change the status of one after-sales ticket. write

  Sets the status and returns the ticket as it is now. It reaches no one and changes back with one more call. A status name that does not exist in your account is rejected.

  MCP callextrabat_write → update_service_ticket_status

  REST endpointPATCH https://cotlet.dev/api/v1/extrabat/tickets/{ticket_id}/service-ticket-status

  Parameters

  Parameters: update_service_ticket_status

  Name	Type	Description
  ticket_id string required	string	Ticket ID from list_service_tickets
  status string required	string	A status name that exists in your account, for example "Intervention terminée à facturer"

  Example input

  {
    "ticket_id": "ticket_8c41d2",
    "status": "status"
  }

  Example response

  {
    "ticket_id": "s_1180",
    "status": "Intervention terminée à facturer",
    "previous": "Intervention en cours"
  }

• list_service_contracts List maintenance (service) contracts with customer and end date. read

  Returns contracts from the Gestion des contrats de services module, ordered by end date. Extrabat can also send SMS reminders for service contracts if you switch them on in the app; this tool only reads.

  MCP callextrabat_read → list_service_contracts

  REST endpointGET https://cotlet.dev/api/v1/extrabat/service-contracts

  Parameters

  Parameters: list_service_contracts

  Name	Type	Description
  ends_before string	string	ISO date; only contracts ending before it
  customer_id string	string	Only contracts of this customer
  limit integer	integer	Maximum results to return

  Example response

  {
    "contracts": [
      {
        "contract_id": "k_640",
        "customer": "Durand Piscines",
        "title": "Yearly pool maintenance",
        "ends": "2027-01-12"
      }
    ],
    "total": 1
  }