Outils MCP

Chaque outil du serveur MCP, écrit à partir de ses propres définitions. Connecter un assistant configure le serveur. Un assistant lit la description complète de chaque outil dans tools/list. Les descriptions des arguments y sont en anglais, comme ici.

documents:read

get_document

Lit un document en ocost.document.v1, comme GET /public/v1/documents/{document_id}.

ArgumentTypeSignification
document_iduuid, obligatoireAn id Ocost gave (a UUID)
JSON
{
  "name": "get_document",
  "arguments": {
    "document_id": "01a1b08c-7aa1-7b52-9d4e-2f1f1c0c4f11"
  }
}

get_file

Renvoie le statut, la raison et les documents d'un fichier, comme GET /public/v1/files/{file_id}.

ArgumentTypeSignification
file_iduuid, obligatoireAn id Ocost gave (a UUID)
JSON
{
  "name": "get_file",
  "arguments": {
    "file_id": "01a1b08c-6e3a-7562-8f4a-7924722667b1"
  }
}

list_files

Liste les fichiers par leur dernière modification, du plus ancien au plus récent, comme GET /public/v1/files.

ArgumentTypeSignification
statusliste de received, reading, read, not_read, failed, needs_companyOnly files in these statuses
updated_sincedate-timeFiles changed at or after this time (ISO 8601)
external_refstringOnly the files carrying this id of yours among their external_refs
cursorstringnext_cursor of the page before
limitinteger 1–100, par défaut 50Fichiers par page.
JSON
{
  "name": "list_files",
  "arguments": {
    "status": ["read", "not_read", "failed"],
    "updated_since": "2026-11-09T08:00:00Z"
  }
}

read_document

Lit les pages d'un document en texte, jusqu'à 4 pages et 12 000 caractères.

ArgumentTypeSignification
document_iduuid, obligatoireL'identifiant d'un document.
pagesliste de integerLes numéros des pages du fichier à lire.
JSON
{
  "name": "read_document",
  "arguments": {
    "document_id": "01a1b08c-7aa1-7b52-9d4e-2f1f1c0c4f11",
    "pages": [1, 2]
  }
}

find_documents

Liste les documents du plus récent au plus ancien, par type, famille ou entreprise.

ArgumentTypeSignification
kindacceptance_protocol, agreement, bonus_payment_notification, … (82 valeurs)Un type de document, comme kind_detail les liste dans Valeurs.
company_iduuidL'identifiant d'une entreprise, issu de find_company.
familyinvoices, payments, buying, contracts, reports, people, otherUn groupe de types, comme invoices ou contracts.
JSON
{
  "name": "find_documents",
  "arguments": {
    "kind": "credit_note",
    "company_id": "01a1b08c-5c2d-7e10-8b3a-1d2e3f4a5b6c"
  }
}

find_contracts

Liste les contrats avec leur durée, leur préavis et leurs montants récurrents.

ArgumentTypeSignification
company_iduuidL'identifiant d'une entreprise, issu de find_company.
JSON
{
  "name": "find_contracts",
  "arguments": {
    "company_id": "01a1b08c-5c2d-7e10-8b3a-1d2e3f4a5b6c"
  }
}

find_company

Trouve des fournisseurs et des clients par leur nom, avec leurs identifiants.

ArgumentTypeSignification
namestring, par défaut ""Une partie du nom. Sans lui, tous sont listés.
countrystringSeulement les entreprises dont l'adresse principale est dans ce pays (ISO 3166-1 alpha-2, DE).
relationsupplier, customerSeulement les fournisseurs ou seulement les clients.
JSON
{
  "name": "find_company",
  "arguments": {
    "name": "Musterbüro"
  }
}

find_project

Trouve des projets par leur nom, avec leurs identifiants.

ArgumentTypeSignification
namestring, par défaut ""Une partie du nom. Sans lui, tous sont listés.
JSON
{
  "name": "find_project",
  "arguments": {
    "name": "Neubau"
  }
}

company_documents

Liste les documents d'une entreprise dans les deux sens, jusqu'à 30.

ArgumentTypeSignification
company_iduuid, obligatoireL'identifiant d'une entreprise, issu de find_company.
JSON
{
  "name": "company_documents",
  "arguments": {
    "company_id": "01a1b08c-5c2d-7e10-8b3a-1d2e3f4a5b6c"
  }
}

invoice_detail

Montre une facture comme sa page dans Ocost : montants, échéance, escompte, commande et historique.

ArgumentTypeSignification
invoice_iduuid, obligatoireL'identifiant d'une facture.
JSON
{
  "name": "invoice_detail",
  "arguments": {
    "invoice_id": "01a1b08c-8c3d-7f41-a2b5-3e4f5a6b7c8d"
  }
}

open_decisions

Liste les décisions ouvertes de la personne connectée, les plus urgentes d'abord.

Uniquement via une connexion OAuth, en tant que la personne qui l'a autorisée.

ArgumentTypeSignification
company_iduuidL'identifiant d'une entreprise, issu de find_company.
project_iduuidL'identifiant d'un projet, issu de find_project.
JSON
{
  "name": "open_decisions",
  "arguments": {
    "company_id": "01a1b08c-5c2d-7e10-8b3a-1d2e3f4a5b6c"
  }
}

check_invoice

Contrôle des factures fournisseurs selon le § 14 UStG, et si chacune est une facture électronique.

ArgumentTypeSignification
document_idsliste de uuidLes factures à contrôler, par leurs identifiants.
company_iduuidL'identifiant d'une entreprise, issu de find_company.
issued_sincedateLa date d'émission, à partir de.
issued_untildateLa date d'émission, jusqu'à.
only_missingboolean, par défaut falseSeulement les factures auxquelles il manque quelque chose.
titlestringLe titre du tableau.
JSON
{
  "name": "check_invoice",
  "arguments": {
    "company_id": "01a1b08c-5c2d-7e10-8b3a-1d2e3f4a5b6c",
    "issued_since": "2026-01-01",
    "only_missing": true
  }
}

documents:write

send_file

Envoie un fichier en base64, comme POST /public/v1/files.

ArgumentTypeSignification
filenamestring, obligatoireIts name, e.g. bill.pdf
content_base64string, obligatoireThe file's bytes in base64: a PDF, an image (JPEG, PNG, TIFF, WebP), a Word file (.docx, .doc) or an e-invoice's XML (XRechnung, UBL, CII), at most 25 MB
external_refstringYour own id for it, e.g. an Odoo bill's 'account.move,42'; kept and given back, beside the ones sent with the same bytes before
JSON
{
  "name": "send_file",
  "arguments": {
    "filename": "invoice.pdf",
    "content_base64": "JVBERi0xLjcK…",
    "external_ref": "account.move,42"
  }
}

search:read

search_documents

Recherche ce que disent les documents, par texte exact, mots-clés, sens ou les deux.

ArgumentTypeSignification
querystring, obligatoireCe qu'il faut trouver.
matchexact, keywords, meaning, hybrid, par défaut "hybrid"exact tel qu'écrit, keywords par mots, meaning par sens, hybrid les deux.
document_iduuidRechercher uniquement dans ce document.
kindsliste de acceptance_protocol, agreement, bonus_payment_notification, … (82 valeurs)Seulement ces types de documents, comme kind_detail les liste dans Valeurs.
familyinvoices, payments, buying, contracts, reports, people, otherUn groupe de types, comme invoices ou contracts.
company_iduuidL'identifiant d'une entreprise, issu de find_company.
project_iduuidL'identifiant d'un projet, issu de find_project.
site_iduuidL'identifiant d'un site.
issued_sincedateLa date d'émission, à partir de.
issued_untildateLa date d'émission, jusqu'à.
due_sincedateLa date d'échéance d'une facture, à partir de.
due_untildateLa date d'échéance d'une facture, jusqu'à.
gross_mindécimalLe montant TTC à partir de, dans la devise de l'entreprise.
gross_maxdécimalLe montant TTC jusqu'à, dans la devise de l'entreprise.
directionincoming, outgoingincoming venant des fournisseurs, outgoing vers les clients.
statusopen, paidCelui d'une facture : open ou paid.
categorystringUn code ECLASS de n'importe quel niveau, issu de find_category.
limitintegerCombien de lignes au plus.
titlestringLe titre du tableau.
JSON
{
  "name": "search_documents",
  "arguments": {
    "query": "Bürostuhl",
    "match": "hybrid",
    "kinds": ["invoice"],
    "issued_since": "2026-01-01"
  }
}

search

Recherche des documents pour la recherche approfondie et le savoir d'entreprise de ChatGPT.

ArgumentTypeSignification
querystring, obligatoireWhat to find
JSON
{
  "name": "search",
  "arguments": {
    "query": "Wartungsvertrag Aufzug"
  }
}

fetch

Récupère un résultat de search en entier : ses quatre premières pages, jusqu'à 12 000 caractères.

ArgumentTypeSignification
idstring, obligatoireA result's id
JSON
{
  "name": "fetch",
  "arguments": {
    "id": "01a1b08c-7aa1-7b52-9d4e-2f1f1c0c4f11"
  }
}

figures:read

find_category

Transforme des mots dans l'une des langues d'Ocost en codes ECLASS.

ArgumentTypeSignification
wordsstring, obligatoireDes mots pour une catégorie, dans l'une des langues d'Ocost.
JSON
{
  "name": "find_category",
  "arguments": {
    "words": "Büromaterial"
  }
}

company_profile

Résume les 12 derniers mois d'une entreprise : achats, ventes, conditions, postes ouverts et délais de paiement.

ArgumentTypeSignification
company_iduuid, obligatoireL'identifiant d'une entreprise, issu de find_company.
JSON
{
  "name": "company_profile",
  "arguments": {
    "company_id": "01a1b08c-5c2d-7e10-8b3a-1d2e3f4a5b6c"
  }
}

project_overview

Compare le budget d'un projet avec ce qui a été dépensé et engagé, par fournisseur et par mois.

ArgumentTypeSignification
project_iduuid, obligatoireL'identifiant d'un projet, issu de find_project.
JSON
{
  "name": "project_overview",
  "arguments": {
    "project_id": "01a1b08c-4b1c-7d20-9a4b-2c3d4e5f6a7b"
  }
}

query_figures

Additionne des enregistrements pour un graphique, une comparaison ou un décompte.

ArgumentTypeSignification
sourcedocuments, lines, invoices, … (11 valeurs), obligatoireCe qu'il faut additionner, comme invoices ou lines.
group_byliste de objet (field, bucket, level), obligatoireUn ou deux champs : les lignes, puis les colonnes.
measureobjet (agg, field, signed)Ce qu'il faut additionner : un décompte, ou la somme, la moyenne, le minimum ou le maximum d'un champ.
filtersliste de objet (field, values, since, until, min, max)Des conditions sur les champs de la source.
yearintegerUne année à additionner. period la remplace.
compareprevious_period, previous_yearComparer avec la période précédente, ou avec la même période un an plus tôt.
top_nintegerSeulement les plus grands groupes.
matchingobjet (query, match)Seulement les documents qu'une recherche trouve.
titlestringLe titre du tableau.
periodstringEn mots simples, comme 2025, Q3 2025 ou last year.
JSON
{
  "name": "query_figures",
  "arguments": {
    "source": "invoices",
    "measure": {"agg": "sum", "field": "net"},
    "group_by": [{"field": "company"}],
    "filters": [{"field": "direction", "values": ["incoming"]}],
    "period": "2025",
    "top_n": 10
  }
}

top_companies

Classe les principaux fournisseurs ou clients par montant HT sur une période.

ArgumentTypeSignification
sidesuppliers, customers, par défaut "suppliers"Les fournisseurs (par défaut) ou les clients.
periodstringEn mots simples, comme 2025, Q3 2025 ou last year.
sincedateÀ partir de cette date.
untildateJusqu'à cette date.
categorystringUn code ECLASS, ou des mots.
ninteger, par défaut 10Combien en lister.
titlestringLe titre du tableau.
JSON
{
  "name": "top_companies",
  "arguments": {
    "side": "suppliers",
    "period": "2025",
    "n": 10
  }
}

spend_over_time

Donne le montant HT par mois, trimestre ou année, par entreprise ou catégorie si demandé.

ArgumentTypeSignification
periodstringEn mots simples, comme 2025, Q3 2025 ou last year.
bucketmonth, quarter, year, par défaut "month"Mois (par défaut), trimestre ou année.
bycompany, categoryUne colonne par entreprise, ou par segment ECLASS.
sidesuppliers, customers, par défaut "suppliers"Les fournisseurs (par défaut) ou les clients.
sincedateÀ partir de cette date.
untildateJusqu'à cette date.
titlestringLe titre du tableau.
JSON
{
  "name": "spend_over_time",
  "arguments": {
    "period": "last 12 months",
    "bucket": "month",
    "by": "company"
  }
}

largest_documents

Liste les plus gros documents par montant TTC sur une période.

ArgumentTypeSignification
kindstringUn type autre que les factures à payer, comme credit_note.
sidesuppliers, customers, par défaut "suppliers"Les fournisseurs (par défaut) ou les clients.
periodstringEn mots simples, comme 2025, Q3 2025 ou last year.
sincedateÀ partir de cette date.
untildateJusqu'à cette date.
ninteger, par défaut 10Combien en lister.
titlestringLe titre du tableau.
JSON
{
  "name": "largest_documents",
  "arguments": {
    "period": "Q3 2025",
    "n": 10
  }
}

payables_due

Liste les factures fournisseurs impayées échues dans une fenêtre, les échéances d'escompte d'abord.

ArgumentTypeSignification
windowthis_week, next_7_days, next_14_days, next_30_days, this_monthQuand les factures sont échues.
sincedateÀ partir de cette date.
untildateJusqu'à cette date.
company_iduuidL'identifiant d'une entreprise, issu de find_company.
titlestringLe titre du tableau.
JSON
{
  "name": "payables_due",
  "arguments": {
    "window": "next_14_days"
  }
}

vat_preview

Prévisualise une USt-Voranmeldung par Kennzahl, que le conseiller fiscal vérifie.

ArgumentTypeSignification
periodstringUn mois (2026-10) ou un trimestre (2026-Q4).
kzstringUne Kennzahl, pour lister ses factures.
titlestringLe titre du tableau.
JSON
{
  "name": "vat_preview",
  "arguments": {
    "period": "2026-10"
  }
}

find_anomalies

Signale les factures en double, les comptes bancaires modifiés et les prix supérieurs à la commande.

ArgumentTypeSignification
sincedateÀ partir de cette date.
untildateJusqu'à cette date.
kindsliste de duplicate, bank_changed, price_above_orderSeulement ces signalements.
titlestringLe titre du tableau.
JSON
{
  "name": "find_anomalies",
  "arguments": {
    "since": "2026-08-01",
    "until": "2026-10-31",
    "kinds": ["bank_changed"]
  }
}

supplier_profile

Résume un fournisseur en un appel : dépenses, conditions, rapidité de paiement, postes ouverts et prix.

ArgumentTypeSignification
company_iduuid, obligatoireL'identifiant d'une entreprise, issu de find_company.
JSON
{
  "name": "supplier_profile",
  "arguments": {
    "company_id": "01a1b08c-5c2d-7e10-8b3a-1d2e3f4a5b6c"
  }
}

exports:write

export_table

Exporte un tableau renvoyé par un autre outil en Excel ou CSV, derrière un lien valable 30 minutes.

ArgumentTypeSignification
queryobjet (tool, args), obligatoireLa query d'un tableau, inchangée, telle qu'un outil l'a renvoyée.
titlestring, par défaut "Ocost"Le titre du tableau.
formatxlsx, csv, par défaut "xlsx"Excel (xlsx, par défaut) ou CSV.
JSON
{
  "name": "export_table",
  "arguments": {
    "query": {"tool": "top_companies", "args": {"period": "2025"}},
    "title": "Top suppliers 2025",
    "format": "xlsx"
  }
}

make_datev_export

Crée l'export DATEV d'une période en un seul ZIP, derrière un lien signé.

Uniquement via une connexion OAuth, en tant que la personne qui l'a autorisée.

ArgumentTypeSignification
starts_ondate, obligatoireLe premier jour de la période.
ends_ondate, obligatoireLe dernier jour de la période, dans le même exercice.
JSON
{
  "name": "make_datev_export",
  "arguments": {
    "starts_on": "2026-10-01",
    "ends_on": "2026-10-31"
  }
}

Voir aussi