Herramientas MCP

Cada herramienta del servidor MCP, escrita a partir de sus propias definiciones. Conectar un asistente configura el servidor. Un asistente lee la descripción completa de cada herramienta en tools/list. Las descripciones de los argumentos están ahí en inglés, como aquí.

documents:read

get_document

Lee un documento como ocost.document.v1, como GET /public/v1/documents/{document_id}.

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

get_file

Responde el estado, el motivo y los documentos de un archivo, como GET /public/v1/files/{file_id}.

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

list_files

Lista los archivos por su último cambio, el más antiguo primero, como GET /public/v1/files.

ArgumentoTipoSignificado
statuslista 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, por defecto 50Archivos por página.
JSON
{
  "name": "list_files",
  "arguments": {
    "status": ["read", "not_read", "failed"],
    "updated_since": "2026-11-09T08:00:00Z"
  }
}

read_document

Lee las páginas de un documento como texto, hasta 4 páginas y 12.000 caracteres.

ArgumentoTipoSignificado
document_iduuid, obligatorioEl id de un documento.
pageslista de integerLos números de página del archivo que leer.
JSON
{
  "name": "read_document",
  "arguments": {
    "document_id": "01a1b08c-7aa1-7b52-9d4e-2f1f1c0c4f11",
    "pages": [1, 2]
  }
}

find_documents

Lista documentos, el más reciente primero, por tipo, familia o empresa.

ArgumentoTipoSignificado
kindacceptance_protocol, agreement, bonus_payment_notification, … (82 valores)Un tipo de documento, como los lista kind_detail en Valores.
company_iduuidEl id de una empresa, de find_company.
familyinvoices, payments, buying, contracts, reports, people, otherUn grupo de tipos, como invoices o contracts.
JSON
{
  "name": "find_documents",
  "arguments": {
    "kind": "credit_note",
    "company_id": "01a1b08c-5c2d-7e10-8b3a-1d2e3f4a5b6c"
  }
}

find_contracts

Lista contratos con su duración, su preaviso y sus importes recurrentes.

ArgumentoTipoSignificado
company_iduuidEl id de una empresa, de find_company.
JSON
{
  "name": "find_contracts",
  "arguments": {
    "company_id": "01a1b08c-5c2d-7e10-8b3a-1d2e3f4a5b6c"
  }
}

find_company

Encuentra proveedores y clientes por nombre, con sus ids.

ArgumentoTipoSignificado
namestring, por defecto ""Parte del nombre. Sin él, se listan todos.
countrystringSolo empresas cuya dirección principal está en este país (ISO 3166-1 alpha-2, DE).
relationsupplier, customerSolo proveedores o solo clientes.
JSON
{
  "name": "find_company",
  "arguments": {
    "name": "Musterbüro"
  }
}

find_project

Encuentra proyectos por nombre, con sus ids.

ArgumentoTipoSignificado
namestring, por defecto ""Parte del nombre. Sin él, se listan todos.
JSON
{
  "name": "find_project",
  "arguments": {
    "name": "Neubau"
  }
}

company_documents

Lista los documentos de una empresa en ambas direcciones, hasta 30.

ArgumentoTipoSignificado
company_iduuid, obligatorioEl id de una empresa, de find_company.
JSON
{
  "name": "company_documents",
  "arguments": {
    "company_id": "01a1b08c-5c2d-7e10-8b3a-1d2e3f4a5b6c"
  }
}

invoice_detail

Muestra una factura como lo hace su página en Ocost: importes, vencimiento, descuento, pedido e historial.

ArgumentoTipoSignificado
invoice_iduuid, obligatorioEl id de una factura.
JSON
{
  "name": "invoice_detail",
  "arguments": {
    "invoice_id": "01a1b08c-8c3d-7f41-a2b5-3e4f5a6b7c8d"
  }
}

open_decisions

Lista las decisiones abiertas de la persona conectada, las que vencen primero.

Solo a través de una conexión OAuth, como la persona que la autorizó.

ArgumentoTipoSignificado
company_iduuidEl id de una empresa, de find_company.
project_iduuidEl id de un proyecto, de find_project.
JSON
{
  "name": "open_decisions",
  "arguments": {
    "company_id": "01a1b08c-5c2d-7e10-8b3a-1d2e3f4a5b6c"
  }
}

check_invoice

Comprueba facturas de proveedor según el § 14 UStG, y si cada una es una factura electrónica.

ArgumentoTipoSignificado
document_idslista de uuidLas facturas que comprobar, por sus ids.
company_iduuidEl id de una empresa, de find_company.
issued_sincedateLa fecha de emisión, desde.
issued_untildateLa fecha de emisión, hasta.
only_missingboolean, por defecto falseSolo las facturas a las que les falta algo.
titlestringEl título de la tabla.
JSON
{
  "name": "check_invoice",
  "arguments": {
    "company_id": "01a1b08c-5c2d-7e10-8b3a-1d2e3f4a5b6c",
    "issued_since": "2026-01-01",
    "only_missing": true
  }
}

documents:write

send_file

Envía un archivo en base64, como POST /public/v1/files.

ArgumentoTipoSignificado
filenamestring, obligatorioIts name, e.g. bill.pdf
content_base64string, obligatorioThe 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

Busca lo que dicen los documentos, por texto exacto, palabras clave, significado o ambos.

ArgumentoTipoSignificado
querystring, obligatorioQué encontrar.
matchexact, keywords, meaning, hybrid, por defecto "hybrid"exact tal como está escrito, keywords por palabras, meaning por significado, hybrid ambos.
document_iduuidBuscar solo en este documento.
kindslista de acceptance_protocol, agreement, bonus_payment_notification, … (82 valores)Solo estos tipos de documento, como los lista kind_detail en Valores.
familyinvoices, payments, buying, contracts, reports, people, otherUn grupo de tipos, como invoices o contracts.
company_iduuidEl id de una empresa, de find_company.
project_iduuidEl id de un proyecto, de find_project.
site_iduuidEl id de una sede.
issued_sincedateLa fecha de emisión, desde.
issued_untildateLa fecha de emisión, hasta.
due_sincedateLa fecha de vencimiento de una factura, desde.
due_untildateLa fecha de vencimiento de una factura, hasta.
gross_mindecimalEl bruto desde, en la moneda de la empresa.
gross_maxdecimalEl bruto hasta, en la moneda de la empresa.
directionincoming, outgoingincoming de proveedores, outgoing a clientes.
statusopen, paidEl de una factura: open o paid.
categorystringUn código ECLASS de cualquier nivel, de find_category.
limitintegerCuántas filas como máximo.
titlestringEl título de la tabla.
JSON
{
  "name": "search_documents",
  "arguments": {
    "query": "Bürostuhl",
    "match": "hybrid",
    "kinds": ["invoice"],
    "issued_since": "2026-01-01"
  }
}

search

Busca documentos para la investigación profunda y el conocimiento de empresa de ChatGPT.

ArgumentoTipoSignificado
querystring, obligatorioWhat to find
JSON
{
  "name": "search",
  "arguments": {
    "query": "Wartungsvertrag Aufzug"
  }
}

fetch

Obtiene un resultado de search completo: sus cuatro primeras páginas, hasta 12.000 caracteres.

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

figures:read

find_category

Convierte palabras en cualquiera de los idiomas de Ocost en códigos ECLASS.

ArgumentoTipoSignificado
wordsstring, obligatorioPalabras para una categoría, en cualquiera de los idiomas de Ocost.
JSON
{
  "name": "find_category",
  "arguments": {
    "words": "Büromaterial"
  }
}

company_profile

Resume los últimos 12 meses de una empresa: comprado, vendido, condiciones, partidas abiertas y plazos de pago.

ArgumentoTipoSignificado
company_iduuid, obligatorioEl id de una empresa, de find_company.
JSON
{
  "name": "company_profile",
  "arguments": {
    "company_id": "01a1b08c-5c2d-7e10-8b3a-1d2e3f4a5b6c"
  }
}

project_overview

Compara el plan de un proyecto con lo gastado y lo comprometido, por proveedor y por mes.

ArgumentoTipoSignificado
project_iduuid, obligatorioEl id de un proyecto, de find_project.
JSON
{
  "name": "project_overview",
  "arguments": {
    "project_id": "01a1b08c-4b1c-7d20-9a4b-2c3d4e5f6a7b"
  }
}

query_figures

Suma registros para un gráfico, una comparación o un recuento.

ArgumentoTipoSignificado
sourcedocuments, lines, invoices, … (11 valores), obligatorioQué sumar, como invoices o lines.
group_bylista de objeto (field, bucket, level), obligatorioUno o dos campos: las filas, después las columnas.
measureobjeto (agg, field, signed)Qué sumar: un recuento, o la suma, la media, el mínimo o el máximo de un campo.
filterslista de objeto (field, values, since, until, min, max)Condiciones sobre los campos de la fuente.
yearintegerUn año que sumar. period lo sustituye.
compareprevious_period, previous_yearComparar con el periodo anterior, o con el mismo periodo un año antes.
top_nintegerSolo los grupos más grandes.
matchingobjeto (query, match)Solo los documentos que encuentra una búsqueda.
titlestringEl título de la tabla.
periodstringPalabras sencillas, como 2025, Q3 2025 o 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

Clasifica los principales proveedores o clientes por neto en un periodo.

ArgumentoTipoSignificado
sidesuppliers, customers, por defecto "suppliers"Proveedores (por defecto) o clientes.
periodstringPalabras sencillas, como 2025, Q3 2025 o last year.
sincedateDesde esta fecha.
untildateHasta esta fecha.
categorystringUn código ECLASS, o palabras.
ninteger, por defecto 10Cuántos listar.
titlestringEl título de la tabla.
JSON
{
  "name": "top_companies",
  "arguments": {
    "side": "suppliers",
    "period": "2025",
    "n": 10
  }
}

spend_over_time

Da el neto por mes, trimestre o año, por empresa o categoría si se pide.

ArgumentoTipoSignificado
periodstringPalabras sencillas, como 2025, Q3 2025 o last year.
bucketmonth, quarter, year, por defecto "month"Mes (por defecto), trimestre o año.
bycompany, categoryUna columna por empresa, o por segmento ECLASS.
sidesuppliers, customers, por defecto "suppliers"Proveedores (por defecto) o clientes.
sincedateDesde esta fecha.
untildateHasta esta fecha.
titlestringEl título de la tabla.
JSON
{
  "name": "spend_over_time",
  "arguments": {
    "period": "last 12 months",
    "bucket": "month",
    "by": "company"
  }
}

largest_documents

Lista los documentos más grandes por bruto en un periodo.

ArgumentoTipoSignificado
kindstringUn tipo distinto de las facturas por pagar, como credit_note.
sidesuppliers, customers, por defecto "suppliers"Proveedores (por defecto) o clientes.
periodstringPalabras sencillas, como 2025, Q3 2025 o last year.
sincedateDesde esta fecha.
untildateHasta esta fecha.
ninteger, por defecto 10Cuántos listar.
titlestringEl título de la tabla.
JSON
{
  "name": "largest_documents",
  "arguments": {
    "period": "Q3 2025",
    "n": 10
  }
}

payables_due

Lista las facturas de proveedor sin pagar que vencen en un intervalo, primero los plazos de Skonto.

ArgumentoTipoSignificado
windowthis_week, next_7_days, next_14_days, next_30_days, this_monthCuándo vencen las facturas.
sincedateDesde esta fecha.
untildateHasta esta fecha.
company_iduuidEl id de una empresa, de find_company.
titlestringEl título de la tabla.
JSON
{
  "name": "payables_due",
  "arguments": {
    "window": "next_14_days"
  }
}

vat_preview

Anticipa una USt-Voranmeldung por Kennzahl, para que la revise el asesor fiscal.

ArgumentoTipoSignificado
periodstringUn mes (2026-10) o un trimestre (2026-Q4).
kzstringUna Kennzahl, para listar sus facturas.
titlestringEl título de la tabla.
JSON
{
  "name": "vat_preview",
  "arguments": {
    "period": "2026-10"
  }
}

find_anomalies

Señala facturas duplicadas, cuentas bancarias cambiadas y precios por encima del pedido.

ArgumentoTipoSignificado
sincedateDesde esta fecha.
untildateHasta esta fecha.
kindslista de duplicate, bank_changed, price_above_orderSolo estas señales.
titlestringEl título de la tabla.
JSON
{
  "name": "find_anomalies",
  "arguments": {
    "since": "2026-08-01",
    "until": "2026-10-31",
    "kinds": ["bank_changed"]
  }
}

supplier_profile

Resume un proveedor en una llamada: gasto, condiciones, rapidez de pago, partidas abiertas y precios.

ArgumentoTipoSignificado
company_iduuid, obligatorioEl id de una empresa, de find_company.
JSON
{
  "name": "supplier_profile",
  "arguments": {
    "company_id": "01a1b08c-5c2d-7e10-8b3a-1d2e3f4a5b6c"
  }
}

exports:write

export_table

Exporta como Excel o CSV una tabla que devolvió otra herramienta, tras un enlace válido 30 minutos.

ArgumentoTipoSignificado
queryobjeto (tool, args), obligatorioLa query de una tabla, sin cambios, tal como la devolvió una herramienta.
titlestring, por defecto "Ocost"El título de la tabla.
formatxlsx, csv, por defecto "xlsx"Excel (xlsx, por defecto) o CSV.
JSON
{
  "name": "export_table",
  "arguments": {
    "query": {"tool": "top_companies", "args": {"period": "2025"}},
    "title": "Top suppliers 2025",
    "format": "xlsx"
  }
}

make_datev_export

Crea la exportación DATEV de un periodo como un ZIP, tras un enlace firmado.

Solo a través de una conexión OAuth, como la persona que la autorizó.

ArgumentoTipoSignificado
starts_ondate, obligatorioEl primer día del periodo.
ends_ondate, obligatorioEl último día del periodo, en el mismo ejercicio fiscal.
JSON
{
  "name": "make_datev_export",
  "arguments": {
    "starts_on": "2026-10-01",
    "ends_on": "2026-10-31"
  }
}

Véase también