Instrumente MCP

Fiecare instrument al serverului MCP, scris din propriile definiții. Conectați un asistent configurează serverul. Un asistent citește descrierea completă a fiecărui instrument în tools/list. Descrierile argumentelor sunt acolo în engleză, ca aici.

documents:read

get_document

Citește un document ca ocost.document.v1, la fel ca GET /public/v1/documents/{document_id}.

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

get_file

Returnează starea, motivul și documentele unui fișier, la fel ca GET /public/v1/files/{file_id}.

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

list_files

Listează fișierele după ultima modificare, cele mai vechi primele, la fel ca GET /public/v1/files.

ArgumentTipSemnificație
statuslistă 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, implicit 50Fișiere pe pagină.
JSON
{
  "name": "list_files",
  "arguments": {
    "status": ["read", "not_read", "failed"],
    "updated_since": "2026-11-09T08:00:00Z"
  }
}

read_document

Citește paginile unui document ca text, până la 4 pagini și 12.000 de caractere.

ArgumentTipSemnificație
document_iduuid, obligatoriuId-ul unui document.
pageslistă de integerNumerele paginilor din fișier de citit.
JSON
{
  "name": "read_document",
  "arguments": {
    "document_id": "01a1b08c-7aa1-7b52-9d4e-2f1f1c0c4f11",
    "pages": [1, 2]
  }
}

find_documents

Listează documentele, cele mai noi primele, după tip, familie sau companie.

ArgumentTipSemnificație
kindacceptance_protocol, agreement, bonus_payment_notification, … (valori: 82)Un tip de document, așa cum îl listează kind_detail în Valori.
company_iduuidId-ul unei companii, din find_company.
familyinvoices, payments, buying, contracts, reports, people, otherUn grup de tipuri, precum invoices sau contracts.
JSON
{
  "name": "find_documents",
  "arguments": {
    "kind": "credit_note",
    "company_id": "01a1b08c-5c2d-7e10-8b3a-1d2e3f4a5b6c"
  }
}

find_contracts

Listează contractele cu durata, preavizul și sumele recurente.

ArgumentTipSemnificație
company_iduuidId-ul unei companii, din find_company.
JSON
{
  "name": "find_contracts",
  "arguments": {
    "company_id": "01a1b08c-5c2d-7e10-8b3a-1d2e3f4a5b6c"
  }
}

find_company

Găsește furnizori și clienți după nume, cu id-urile lor.

ArgumentTipSemnificație
namestring, implicit ""O parte din nume. Fără el, se listează toate.
countrystringDoar companiile cu adresa principală în această țară (ISO 3166-1 alpha-2, DE).
relationsupplier, customerDoar furnizori sau doar clienți.
JSON
{
  "name": "find_company",
  "arguments": {
    "name": "Musterbüro"
  }
}

find_project

Găsește proiecte după nume, cu id-urile lor.

ArgumentTipSemnificație
namestring, implicit ""O parte din nume. Fără el, se listează toate.
JSON
{
  "name": "find_project",
  "arguments": {
    "name": "Neubau"
  }
}

company_documents

Listează documentele unei companii în ambele direcții, până la 30.

ArgumentTipSemnificație
company_iduuid, obligatoriuId-ul unei companii, din find_company.
JSON
{
  "name": "company_documents",
  "arguments": {
    "company_id": "01a1b08c-5c2d-7e10-8b3a-1d2e3f4a5b6c"
  }
}

invoice_detail

Arată o factură așa cum o arată pagina ei din Ocost: sume, scadență, discount, comandă și istoric.

ArgumentTipSemnificație
invoice_iduuid, obligatoriuId-ul unei facturi.
JSON
{
  "name": "invoice_detail",
  "arguments": {
    "invoice_id": "01a1b08c-8c3d-7f41-a2b5-3e4f5a6b7c8d"
  }
}

open_decisions

Listează deciziile deschise ale persoanei conectate, cele scadente primele.

Doar printr-o conexiune OAuth, ca persoana care a permis-o.

ArgumentTipSemnificație
company_iduuidId-ul unei companii, din find_company.
project_iduuidId-ul unui proiect, din find_project.
JSON
{
  "name": "open_decisions",
  "arguments": {
    "company_id": "01a1b08c-5c2d-7e10-8b3a-1d2e3f4a5b6c"
  }
}

check_invoice

Verifică facturile de furnizor față de § 14 UStG și dacă fiecare este o factură electronică.

ArgumentTipSemnificație
document_idslistă de uuidFacturile de verificat, după id-urile lor.
company_iduuidId-ul unei companii, din find_company.
issued_sincedateData emiterii, de la.
issued_untildateData emiterii, până la.
only_missingboolean, implicit falseDoar facturile cărora le lipsește ceva.
titlestringTitlul tabelului.
JSON
{
  "name": "check_invoice",
  "arguments": {
    "company_id": "01a1b08c-5c2d-7e10-8b3a-1d2e3f4a5b6c",
    "issued_since": "2026-01-01",
    "only_missing": true
  }
}

documents:write

send_file

Trimite un fișier ca base64, la fel ca POST /public/v1/files.

ArgumentTipSemnificație
filenamestring, obligatoriuIts name, e.g. bill.pdf
content_base64string, obligatoriuThe 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

Caută în ce spun documentele, după textul exact, cuvinte-cheie, sens sau ambele.

ArgumentTipSemnificație
querystring, obligatoriuCe se caută.
matchexact, keywords, meaning, hybrid, implicit "hybrid"exact așa cum este scris, keywords după cuvinte, meaning după sens, hybrid ambele.
document_iduuidCăutați doar în acest document.
kindslistă de acceptance_protocol, agreement, bonus_payment_notification, … (valori: 82)Doar aceste tipuri de documente, așa cum le listează kind_detail în Valori.
familyinvoices, payments, buying, contracts, reports, people, otherUn grup de tipuri, precum invoices sau contracts.
company_iduuidId-ul unei companii, din find_company.
project_iduuidId-ul unui proiect, din find_project.
site_iduuidId-ul unei locații.
issued_sincedateData emiterii, de la.
issued_untildateData emiterii, până la.
due_sincedateData scadenței unei facturi, de la.
due_untildateData scadenței unei facturi, până la.
gross_minzecimalSuma brută de la, în moneda firmei.
gross_maxzecimalSuma brută până la, în moneda firmei.
directionincoming, outgoingincoming de la furnizori, outgoing către clienți.
statusopen, paidAl unei facturi: open sau paid.
categorystringUn cod ECLASS de orice nivel, din find_category.
limitintegerCâte rânduri cel mult.
titlestringTitlul tabelului.
JSON
{
  "name": "search_documents",
  "arguments": {
    "query": "Bürostuhl",
    "match": "hybrid",
    "kinds": ["invoice"],
    "issued_since": "2026-01-01"
  }
}

search

Caută documente pentru deep research și cunoștințele companiei din ChatGPT.

ArgumentTipSemnificație
querystring, obligatoriuWhat to find
JSON
{
  "name": "search",
  "arguments": {
    "query": "Wartungsvertrag Aufzug"
  }
}

fetch

Aduce un rezultat search întreg: primele patru pagini, până la 12.000 de caractere.

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

figures:read

find_category

Transformă cuvinte din oricare dintre limbile Ocost în coduri ECLASS.

ArgumentTipSemnificație
wordsstring, obligatoriuCuvinte pentru o categorie, în oricare dintre limbile Ocost.
JSON
{
  "name": "find_category",
  "arguments": {
    "words": "Büromaterial"
  }
}

company_profile

Rezumă ultimele 12 luni ale unei companii: cumpărat, vândut, condiții, sume deschise și termene de plată.

ArgumentTipSemnificație
company_iduuid, obligatoriuId-ul unei companii, din find_company.
JSON
{
  "name": "company_profile",
  "arguments": {
    "company_id": "01a1b08c-5c2d-7e10-8b3a-1d2e3f4a5b6c"
  }
}

project_overview

Compară planul unui proiect cu ce s-a cheltuit și angajat, pe furnizor și lună.

ArgumentTipSemnificație
project_iduuid, obligatoriuId-ul unui proiect, din find_project.
JSON
{
  "name": "project_overview",
  "arguments": {
    "project_id": "01a1b08c-4b1c-7d20-9a4b-2c3d4e5f6a7b"
  }
}

query_figures

Adună înregistrări pentru un grafic, o comparație sau o numărătoare.

ArgumentTipSemnificație
sourcedocuments, lines, invoices, … (valori: 11), obligatoriuCe se adună, precum invoices sau lines.
group_bylistă de obiect (field, bucket, level), obligatoriuUnul sau două câmpuri: rândurile, apoi coloanele.
measureobiect (agg, field, signed)Ce se adună: o numărătoare sau suma, media, minimul ori maximul unui câmp.
filterslistă de obiect (field, values, since, until, min, max)Condiții pe câmpurile sursei.
yearintegerUn an de adunat. period îl înlocuiește.
compareprevious_period, previous_yearComparați cu perioada anterioară sau cu aceeași perioadă de acum un an.
top_nintegerDoar cele mai mari grupuri.
matchingobiect (query, match)Doar documentele găsite de o căutare.
titlestringTitlul tabelului.
periodstringCuvinte simple, precum 2025, Q3 2025 sau 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

Clasează principalii furnizori sau clienți după suma netă dintr-o perioadă.

ArgumentTipSemnificație
sidesuppliers, customers, implicit "suppliers"Furnizori (implicit) sau clienți.
periodstringCuvinte simple, precum 2025, Q3 2025 sau last year.
sincedateDe la această dată.
untildatePână la această dată.
categorystringUn cod ECLASS sau cuvinte.
ninteger, implicit 10Câte să fie listate.
titlestringTitlul tabelului.
JSON
{
  "name": "top_companies",
  "arguments": {
    "side": "suppliers",
    "period": "2025",
    "n": 10
  }
}

spend_over_time

Dă suma netă pe lună, trimestru sau an, pe companie sau categorie dacă se cere.

ArgumentTipSemnificație
periodstringCuvinte simple, precum 2025, Q3 2025 sau last year.
bucketmonth, quarter, year, implicit "month"Lună (implicit), trimestru sau an.
bycompany, categoryO coloană pe companie sau pe segment ECLASS.
sidesuppliers, customers, implicit "suppliers"Furnizori (implicit) sau clienți.
sincedateDe la această dată.
untildatePână la această dată.
titlestringTitlul tabelului.
JSON
{
  "name": "spend_over_time",
  "arguments": {
    "period": "last 12 months",
    "bucket": "month",
    "by": "company"
  }
}

largest_documents

Listează cele mai mari documente după suma brută dintr-o perioadă.

ArgumentTipSemnificație
kindstringUn alt tip decât facturile de plătit, precum credit_note.
sidesuppliers, customers, implicit "suppliers"Furnizori (implicit) sau clienți.
periodstringCuvinte simple, precum 2025, Q3 2025 sau last year.
sincedateDe la această dată.
untildatePână la această dată.
ninteger, implicit 10Câte să fie listate.
titlestringTitlul tabelului.
JSON
{
  "name": "largest_documents",
  "arguments": {
    "period": "Q3 2025",
    "n": 10
  }
}

payables_due

Listează facturile de furnizor neplătite scadente într-un interval, întâi termenele de Skonto.

ArgumentTipSemnificație
windowthis_week, next_7_days, next_14_days, next_30_days, this_monthCând sunt scadente facturile.
sincedateDe la această dată.
untildatePână la această dată.
company_iduuidId-ul unei companii, din find_company.
titlestringTitlul tabelului.
JSON
{
  "name": "payables_due",
  "arguments": {
    "window": "next_14_days"
  }
}

vat_preview

Previzualizează o USt-Voranmeldung pe Kennzahl, ca s-o verifice consultantul fiscal.

ArgumentTipSemnificație
periodstringO lună (2026-10) sau un trimestru (2026-Q4).
kzstringO Kennzahl, ca să-i listați facturile.
titlestringTitlul tabelului.
JSON
{
  "name": "vat_preview",
  "arguments": {
    "period": "2026-10"
  }
}

find_anomalies

Semnalează facturi duplicate, conturi bancare schimbate și prețuri peste comandă.

ArgumentTipSemnificație
sincedateDe la această dată.
untildatePână la această dată.
kindslistă de duplicate, bank_changed, price_above_orderDoar aceste semnalări.
titlestringTitlul tabelului.
JSON
{
  "name": "find_anomalies",
  "arguments": {
    "since": "2026-08-01",
    "until": "2026-10-31",
    "kinds": ["bank_changed"]
  }
}

supplier_profile

Rezumă un furnizor într-un singur apel: cheltuieli, condiții, viteza de plată, sume deschise și prețuri.

ArgumentTipSemnificație
company_iduuid, obligatoriuId-ul unei companii, din find_company.
JSON
{
  "name": "supplier_profile",
  "arguments": {
    "company_id": "01a1b08c-5c2d-7e10-8b3a-1d2e3f4a5b6c"
  }
}

exports:write

export_table

Exportă ca Excel sau CSV un tabel returnat de alt instrument, printr-un link valabil 30 de minute.

ArgumentTipSemnificație
queryobiect (tool, args), obligatoriuquery-ul unui tabel, neschimbat, așa cum l-a returnat un instrument.
titlestring, implicit "Ocost"Titlul tabelului.
formatxlsx, csv, implicit "xlsx"Excel (xlsx, implicit) sau CSV.
JSON
{
  "name": "export_table",
  "arguments": {
    "query": {"tool": "top_companies", "args": {"period": "2025"}},
    "title": "Top suppliers 2025",
    "format": "xlsx"
  }
}

make_datev_export

Creează exportul DATEV al unei perioade ca un singur ZIP, printr-un link semnat.

Doar printr-o conexiune OAuth, ca persoana care a permis-o.

ArgumentTipSemnificație
starts_ondate, obligatoriuPrima zi a perioadei.
ends_ondate, obligatoriuUltima zi a perioadei, în același an fiscal.
JSON
{
  "name": "make_datev_export",
  "arguments": {
    "starts_on": "2026-10-01",
    "ends_on": "2026-10-31"
  }
}

Vezi și