Narzędzia MCP

Każde narzędzie serwera MCP, wypisane z jego własnych definicji. Podłączyć asystenta konfiguruje serwer. Asystent czyta pełny opis każdego narzędzia w tools/list. Opisy argumentów są tam, tak jak tutaj, po angielsku.

documents:read

get_document

Odczytuje jeden dokument jako ocost.document.v1, jak GET /public/v1/documents/{document_id}.

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

get_file

Zwraca status pliku, powód i dokumenty, jak GET /public/v1/files/{file_id}.

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

list_files

Wymienia pliki według ostatniej zmiany, od najstarszej, jak GET /public/v1/files.

ArgumentTypZnaczenie
statuslista 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, domyślnie 50Pliki na stronę.
JSON
{
  "name": "list_files",
  "arguments": {
    "status": ["read", "not_read", "failed"],
    "updated_since": "2026-11-09T08:00:00Z"
  }
}

read_document

Odczytuje strony dokumentu jako tekst, do 4 stron i 12 000 znaków.

ArgumentTypZnaczenie
document_iduuid, wymaganeIdentyfikator dokumentu.
pageslista integerNumery stron pliku do odczytania.
JSON
{
  "name": "read_document",
  "arguments": {
    "document_id": "01a1b08c-7aa1-7b52-9d4e-2f1f1c0c4f11",
    "pages": [1, 2]
  }
}

find_documents

Wymienia dokumenty od najnowszych, według rodzaju, grupy lub firmy.

ArgumentTypZnaczenie
kindacceptance_protocol, agreement, bonus_payment_notification, … (82 wartości)Jeden typ dokumentu, tak jak wymienia je kind_detail w Wartości.
company_iduuidIdentyfikator firmy, z find_company.
familyinvoices, payments, buying, contracts, reports, people, otherGrupa rodzajów, na przykład invoices lub contracts.
JSON
{
  "name": "find_documents",
  "arguments": {
    "kind": "credit_note",
    "company_id": "01a1b08c-5c2d-7e10-8b3a-1d2e3f4a5b6c"
  }
}

find_contracts

Wymienia umowy z okresem obowiązywania, wypowiedzeniem i kwotami cyklicznymi.

ArgumentTypZnaczenie
company_iduuidIdentyfikator firmy, z find_company.
JSON
{
  "name": "find_contracts",
  "arguments": {
    "company_id": "01a1b08c-5c2d-7e10-8b3a-1d2e3f4a5b6c"
  }
}

find_company

Znajduje dostawców i klientów po nazwie, z ich identyfikatorami.

ArgumentTypZnaczenie
namestring, domyślnie ""Część nazwy. Bez niej wymienione są wszystkie.
countrystringTylko firmy, których główny adres jest w tym kraju (ISO 3166-1 alpha-2, DE).
relationsupplier, customerTylko dostawcy albo tylko klienci.
JSON
{
  "name": "find_company",
  "arguments": {
    "name": "Musterbüro"
  }
}

find_project

Znajduje projekty po nazwie, z ich identyfikatorami.

ArgumentTypZnaczenie
namestring, domyślnie ""Część nazwy. Bez niej wymienione są wszystkie.
JSON
{
  "name": "find_project",
  "arguments": {
    "name": "Neubau"
  }
}

company_documents

Wymienia dokumenty firmy w obu kierunkach, do 30.

ArgumentTypZnaczenie
company_iduuid, wymaganeIdentyfikator firmy, z find_company.
JSON
{
  "name": "company_documents",
  "arguments": {
    "company_id": "01a1b08c-5c2d-7e10-8b3a-1d2e3f4a5b6c"
  }
}

invoice_detail

Pokazuje jedną fakturę tak jak jej strona w Ocost: kwoty, termin płatności, rabat, zamówienie i historię.

ArgumentTypZnaczenie
invoice_iduuid, wymaganeIdentyfikator faktury.
JSON
{
  "name": "invoice_detail",
  "arguments": {
    "invoice_id": "01a1b08c-8c3d-7f41-a2b5-3e4f5a6b7c8d"
  }
}

open_decisions

Wymienia otwarte decyzje połączonej osoby, najpilniejsze najpierw.

Tylko przez połączenie OAuth, jako osoba, która na nie zezwoliła.

ArgumentTypZnaczenie
company_iduuidIdentyfikator firmy, z find_company.
project_iduuidIdentyfikator projektu, z find_project.
JSON
{
  "name": "open_decisions",
  "arguments": {
    "company_id": "01a1b08c-5c2d-7e10-8b3a-1d2e3f4a5b6c"
  }
}

check_invoice

Sprawdza faktury dostawców według § 14 UStG i to, czy każda jest e-fakturą.

ArgumentTypZnaczenie
document_idslista uuidFaktury do sprawdzenia, według ich identyfikatorów.
company_iduuidIdentyfikator firmy, z find_company.
issued_sincedateData wystawienia, od.
issued_untildateData wystawienia, do.
only_missingboolean, domyślnie falseTylko faktury, którym czegoś brakuje.
titlestringTytuł tabeli.
JSON
{
  "name": "check_invoice",
  "arguments": {
    "company_id": "01a1b08c-5c2d-7e10-8b3a-1d2e3f4a5b6c",
    "issued_since": "2026-01-01",
    "only_missing": true
  }
}

documents:write

send_file

Wysyła plik jako base64, jak POST /public/v1/files.

ArgumentTypZnaczenie
filenamestring, wymaganeIts name, e.g. bill.pdf
content_base64string, wymaganeThe 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

Przeszukuje treść dokumentów: po dokładnym tekście, słowach kluczowych, znaczeniu lub obu.

ArgumentTypZnaczenie
querystring, wymaganeCo znaleźć.
matchexact, keywords, meaning, hybrid, domyślnie "hybrid"exact tak, jak zapisano, keywords po słowach, meaning po znaczeniu, hybrid oba.
document_iduuidSzukaj tylko w tym dokumencie.
kindslista acceptance_protocol, agreement, bonus_payment_notification, … (82 wartości)Tylko te typy dokumentów, tak jak wymienia je kind_detail w Wartości.
familyinvoices, payments, buying, contracts, reports, people, otherGrupa rodzajów, na przykład invoices lub contracts.
company_iduuidIdentyfikator firmy, z find_company.
project_iduuidIdentyfikator projektu, z find_project.
site_iduuidIdentyfikator lokalizacji.
issued_sincedateData wystawienia, od.
issued_untildateData wystawienia, do.
due_sincedateTermin płatności faktury, od.
due_untildateTermin płatności faktury, do.
gross_minliczba dziesiętnaKwota brutto od, w walucie firmy.
gross_maxliczba dziesiętnaKwota brutto do, w walucie firmy.
directionincoming, outgoingincoming od dostawców, outgoing do klientów.
statusopen, paidStatus faktury: open lub paid.
categorystringKod ECLASS dowolnego poziomu, z find_category.
limitintegerNajwyżej tyle wierszy.
titlestringTytuł tabeli.
JSON
{
  "name": "search_documents",
  "arguments": {
    "query": "Bürostuhl",
    "match": "hybrid",
    "kinds": ["invoice"],
    "issued_since": "2026-01-01"
  }
}

search

Przeszukuje dokumenty na potrzeby deep research i wiedzy firmowej w ChatGPT.

ArgumentTypZnaczenie
querystring, wymaganeWhat to find
JSON
{
  "name": "search",
  "arguments": {
    "query": "Wartungsvertrag Aufzug"
  }
}

fetch

Pobiera cały wynik search: jego pierwsze cztery strony, do 12 000 znaków.

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

figures:read

find_category

Zamienia słowa w dowolnym z języków Ocost na kody ECLASS.

ArgumentTypZnaczenie
wordsstring, wymaganeSłowa dla kategorii, w dowolnym z języków Ocost.
JSON
{
  "name": "find_category",
  "arguments": {
    "words": "Büromaterial"
  }
}

company_profile

Podsumowuje ostatnie 12 miesięcy firmy: zakupy, sprzedaż, warunki, otwarte pozycje i czasy płatności.

ArgumentTypZnaczenie
company_iduuid, wymaganeIdentyfikator firmy, z find_company.
JSON
{
  "name": "company_profile",
  "arguments": {
    "company_id": "01a1b08c-5c2d-7e10-8b3a-1d2e3f4a5b6c"
  }
}

project_overview

Porównuje plan projektu z tym, co wydano i zaangażowano, według dostawcy i miesiąca.

ArgumentTypZnaczenie
project_iduuid, wymaganeIdentyfikator projektu, z find_project.
JSON
{
  "name": "project_overview",
  "arguments": {
    "project_id": "01a1b08c-4b1c-7d20-9a4b-2c3d4e5f6a7b"
  }
}

query_figures

Sumuje rekordy do wykresu, porównania lub zliczenia.

ArgumentTypZnaczenie
sourcedocuments, lines, invoices, … (11 wartości), wymaganeCo sumować, na przykład invoices lub lines.
group_bylista obiekt (field, bucket, level), wymaganeJedno lub dwa pola: wiersze, potem kolumny.
measureobiekt (agg, field, signed)Co sumować: liczbę albo sumę, średnią, minimum lub maksimum pola.
filterslista obiekt (field, values, since, until, min, max)Warunki na polach źródła.
yearintegerRok do zsumowania. period go zastępuje.
compareprevious_period, previous_yearPorównanie z poprzednim okresem lub z tym samym okresem rok wcześniej.
top_nintegerTylko największe grupy.
matchingobiekt (query, match)Tylko dokumenty, które znajduje wyszukiwanie.
titlestringTytuł tabeli.
periodstringZwykłe słowa, na przykład 2025, Q3 2025 lub 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

Szereguje największych dostawców lub klientów według kwoty netto w okresie.

ArgumentTypZnaczenie
sidesuppliers, customers, domyślnie "suppliers"Dostawcy (domyślnie) lub klienci.
periodstringZwykłe słowa, na przykład 2025, Q3 2025 lub last year.
sincedateOd tej daty.
untildateDo tej daty.
categorystringKod ECLASS lub słowa.
ninteger, domyślnie 10Ile wymienić.
titlestringTytuł tabeli.
JSON
{
  "name": "top_companies",
  "arguments": {
    "side": "suppliers",
    "period": "2025",
    "n": 10
  }
}

spend_over_time

Podaje kwotę netto według miesiąca, kwartału lub roku, na życzenie według firmy lub kategorii.

ArgumentTypZnaczenie
periodstringZwykłe słowa, na przykład 2025, Q3 2025 lub last year.
bucketmonth, quarter, year, domyślnie "month"Miesiąc (domyślnie), kwartał lub rok.
bycompany, categoryKolumna dla każdej firmy lub każdego segmentu ECLASS.
sidesuppliers, customers, domyślnie "suppliers"Dostawcy (domyślnie) lub klienci.
sincedateOd tej daty.
untildateDo tej daty.
titlestringTytuł tabeli.
JSON
{
  "name": "spend_over_time",
  "arguments": {
    "period": "last 12 months",
    "bucket": "month",
    "by": "company"
  }
}

largest_documents

Wymienia największe dokumenty według kwoty brutto w okresie.

ArgumentTypZnaczenie
kindstringRodzaj inny niż faktury do zapłaty, na przykład credit_note.
sidesuppliers, customers, domyślnie "suppliers"Dostawcy (domyślnie) lub klienci.
periodstringZwykłe słowa, na przykład 2025, Q3 2025 lub last year.
sincedateOd tej daty.
untildateDo tej daty.
ninteger, domyślnie 10Ile wymienić.
titlestringTytuł tabeli.
JSON
{
  "name": "largest_documents",
  "arguments": {
    "period": "Q3 2025",
    "n": 10
  }
}

payables_due

Wymienia nieopłacone faktury dostawców wymagalne w danym oknie, najpierw terminy Skonto.

ArgumentTypZnaczenie
windowthis_week, next_7_days, next_14_days, next_30_days, this_monthKiedy faktury są wymagalne.
sincedateOd tej daty.
untildateDo tej daty.
company_iduuidIdentyfikator firmy, z find_company.
titlestringTytuł tabeli.
JSON
{
  "name": "payables_due",
  "arguments": {
    "window": "next_14_days"
  }
}

vat_preview

Pokazuje podgląd USt-Voranmeldung według Kennzahl, do sprawdzenia przez doradcę podatkowego.

ArgumentTypZnaczenie
periodstringMiesiąc (2026-10) lub kwartał (2026-Q4).
kzstringKennzahl, aby wymienić jej faktury.
titlestringTytuł tabeli.
JSON
{
  "name": "vat_preview",
  "arguments": {
    "period": "2026-10"
  }
}

find_anomalies

Oznacza zduplikowane faktury, zmienione konta bankowe i ceny wyższe niż w zamówieniu.

ArgumentTypZnaczenie
sincedateOd tej daty.
untildateDo tej daty.
kindslista duplicate, bank_changed, price_above_orderTylko te oznaczenia.
titlestringTytuł tabeli.
JSON
{
  "name": "find_anomalies",
  "arguments": {
    "since": "2026-08-01",
    "until": "2026-10-31",
    "kinds": ["bank_changed"]
  }
}

supplier_profile

Podsumowuje dostawcę jednym wywołaniem: wydatki, warunki, szybkość płatności, otwarte pozycje i ceny.

ArgumentTypZnaczenie
company_iduuid, wymaganeIdentyfikator firmy, z find_company.
JSON
{
  "name": "supplier_profile",
  "arguments": {
    "company_id": "01a1b08c-5c2d-7e10-8b3a-1d2e3f4a5b6c"
  }
}

exports:write

export_table

Eksportuje tabelę zwróconą przez inne narzędzie do Excela lub CSV, pod linkiem ważnym 30 minut.

ArgumentTypZnaczenie
queryobiekt (tool, args), wymaganequery tabeli, bez zmian, tak jak zwróciło je narzędzie.
titlestring, domyślnie "Ocost"Tytuł tabeli.
formatxlsx, csv, domyślnie "xlsx"Excel (xlsx, domyślnie) lub CSV.
JSON
{
  "name": "export_table",
  "arguments": {
    "query": {"tool": "top_companies", "args": {"period": "2025"}},
    "title": "Top suppliers 2025",
    "format": "xlsx"
  }
}

make_datev_export

Tworzy eksport DATEV za okres jako jeden plik ZIP, pod podpisanym linkiem.

Tylko przez połączenie OAuth, jako osoba, która na nie zezwoliła.

ArgumentTypZnaczenie
starts_ondate, wymaganePierwszy dzień okresu.
ends_ondate, wymaganeOstatni dzień okresu, w tym samym roku obrotowym.
JSON
{
  "name": "make_datev_export",
  "arguments": {
    "starts_on": "2026-10-01",
    "ends_on": "2026-10-31"
  }
}

Zobacz też