OfficeGest MCP by usefulapi
Read customers, stock, sales documents and debt reports; create customers in OfficeGest.
¿Debería usar esto?
Calidad y seguridad
Hallazgos (5)
- LOWen officegest_get_customer_balance
- LOWen officegest_list_stock_quantities
- LOWen officegest_list_sale_document_types
- LOWen officegest_list_customer_invoices_due
- LOWen officegest_list_supplier_invoices_due
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"officegest": {
"url": "https://officegest.usefulapi.io/mcp"
}
}
}Puntos de conexión remotos
https://officegest.usefulapi.io/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (16)
🟢officegest_list_customers(name, tax_id, email, active, type, ...)
List customers with tax id, contacts and status. Filter by name, tax id, email, active flag or type. Pass meta.next as cursor for the next page. Uses GET /entities/customers.
Esquema de entrada
{
"type": "object",
"properties": {
"name": {
"description": "Filter by customer name.",
"type": "string"
},
"tax_id": {
"description": "Filter by tax id.",
"type": "string"
},
"email": {
"description": "Filter by e-mail address.",
"type": "string"
},
"active": {
"description": "true for active customers only, false for inactive ones.",
"type": "boolean"
},
"type": {
"description": "E = company, I = company in an individual's name, P = private individual.",
"type": "string",
"enum": [
"E",
"I",
"P"
]
},
"limit": {
"description": "Rows per page, 1 to 250 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 250
},
"cursor": {
"description": "Cursor from meta.next of the previous page. Omit it for the first page.",
"type": "string",
"minLength": 1
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢officegest_get_customer(customer)
Get one customer by id: name, tax id, address, contacts, type and status. Uses GET /entities/customers/{customer}.
Esquema de entrada
{
"type": "object",
"properties": {
"customer": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"pattern": "^(?!\\.{1,2}$)[^/\\\\?#%]+$",
"description": "The customer id (from officegest_list_customers)."
}
},
"required": [
"customer"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢officegest_get_customer_balance(customer)
Get the current balance of one customer: what the customer owes the company. Uses GET /entities/customers/{customer}/balance.
Esquema de entrada
{
"type": "object",
"properties": {
"customer": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"pattern": "^(?!\\.{1,2}$)[^/\\\\?#%]+$",
"description": "The customer id (from officegest_list_customers)."
}
},
"required": [
"customer"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴officegest_create_customer(name, country_code, type, tax_id, address, ...)
Create a customer record. Creates data in OfficeGest; it does not merge with an existing customer, so search first. Uses POST /entities/customers.
Esquema de entrada
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"description": "Customer name."
},
"country_code": {
"type": "string",
"minLength": 2,
"maxLength": 3,
"description": "Country code, for example PT or ES."
},
"type": {
"description": "E = company, I = company in an individual's name, P = private individual.",
"type": "string",
"enum": [
"E",
"I",
"P"
]
},
"tax_id": {
"description": "Tax id.",
"type": "string",
"maxLength": 50
},
"address": {
"description": "Street address.",
"type": "string",
"maxLength": 255
},
"postal_code": {
"description": "Postal code.",
"type": "string",
"maxLength": 20
},
"city": {
"description": "City.",
"type": "string",
"maxLength": 100
},
"email": {
"description": "E-mail address.",
"type": "string",
"maxLength": 255
},
"phone": {
"description": "Phone number.",
"type": "string",
"maxLength": 40
},
"mobile_phone": {
"description": "Mobile phone number.",
"type": "string",
"maxLength": 40
}
},
"required": [
"name",
"country_code"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢officegest_list_suppliers(search, name, tax_id, email, active, ...)
List suppliers with tax id, contacts and status. Filter by search text, name, tax id, e-mail or active flag. Uses GET /entities/suppliers.
Esquema de entrada
{
"type": "object",
"properties": {
"search": {
"description": "Free-text search over supplier fields.",
"type": "string"
},
"name": {
"description": "Filter by supplier name.",
"type": "string"
},
"tax_id": {
"description": "Filter by tax id.",
"type": "string"
},
"email": {
"description": "Filter by e-mail address.",
"type": "string"
},
"active": {
"description": "true for active suppliers only, false for inactive ones.",
"type": "boolean"
},
"limit": {
"description": "Rows per page, 1 to 250 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 250
},
"page": {
"description": "Page number, starting at 1.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢officegest_get_supplier(supplier)
Get one supplier by id: name, tax id, address and contacts. Uses GET /entities/suppliers/{supplier}.
Esquema de entrada
{
"type": "object",
"properties": {
"supplier": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"pattern": "^(?!\\.{1,2}$)[^/\\\\?#%]+$",
"description": "The supplier id (from officegest_list_suppliers)."
}
},
"required": [
"supplier"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢officegest_search_articles(txt, barcode, active, family_id, warehouse_id, ...)
Search articles (products and services) by text, barcode, family or warehouse. Uses GET /stocks/articles/search.
Esquema de entrada
{
"type": "object",
"properties": {
"txt": {
"description": "Free-text search: code, description or reference.",
"type": "string"
},
"barcode": {
"description": "Barcode, exact match.",
"type": "string"
},
"active": {
"description": "true for active articles only, false for inactive ones.",
"type": "boolean"
},
"family_id": {
"description": "Filter by family id.",
"type": "string"
},
"warehouse_id": {
"description": "Filter by warehouse id.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"limit": {
"description": "Rows per page, 1 to 250 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 250
},
"page": {
"description": "Page number, starting at 1.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢officegest_get_article(article)
Get one article by id: description, prices, measurement unit, VAT and stock totals. Uses GET /stocks/articles/{article}.
Esquema de entrada
{
"type": "object",
"properties": {
"article": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"pattern": "^(?!\\.{1,2}$)[^/\\\\?#%]+$",
"description": "The article id (from officegest_search_articles)."
}
},
"required": [
"article"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢officegest_list_stock_quantities(article_id, warehouse_id, include_zero_stock, limit, page)
List stock quantities per article and warehouse. Zero-stock rows are left out unless include_zero_stock is true. Uses GET /stocks/quantities.
Esquema de entrada
{
"type": "object",
"properties": {
"article_id": {
"description": "Filter by article id.",
"type": "string"
},
"warehouse_id": {
"description": "Filter by warehouse id.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"include_zero_stock": {
"description": "true to include rows with zero stock.",
"type": "boolean"
},
"limit": {
"description": "Rows per page, 1 to 250 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 250
},
"page": {
"description": "Page number, starting at 1.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢officegest_list_sale_document_types
List the sale document types of the company, with their codes. Use a code with officegest_list_sale_documents. Uses GET /sales/documents.
Esquema de entrada
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢officegest_list_sale_documents(type, customer_id, customer_tax_id, serie, canceled, ...)
List sale documents of one type (for example invoices), with number, customer, date, due date and state. Pass meta.next as cursor for the next page. Uses GET /sales/documents/{type}.
Esquema de entrada
{
"type": "object",
"properties": {
"type": {
"type": "string",
"minLength": 1,
"maxLength": 20,
"pattern": "^(?!\\.{1,2}$)[^/\\\\?#%]+$",
"description": "Document type code (from officegest_list_sale_document_types)."
},
"customer_id": {
"description": "Filter by customer id.",
"type": "string"
},
"customer_tax_id": {
"description": "Filter by customer tax id.",
"type": "string"
},
"serie": {
"description": "Filter by document series.",
"type": "string"
},
"canceled": {
"description": "T for cancelled documents only, F for the others.",
"type": "string",
"enum": [
"T",
"F"
]
},
"start_date": {
"description": "Date as YYYY-MM-DD.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"end_date": {
"description": "Date as YYYY-MM-DD.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"limit": {
"description": "Rows per page, 1 to 250 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 250
},
"cursor": {
"description": "Cursor from meta.next of the previous page. Omit it for the first page.",
"type": "string",
"minLength": 1
}
},
"required": [
"type"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢officegest_get_sale_document(type, id)
Get one sale document by type and id: header, customer, lines and totals. Uses GET /sales/documents/{type}/{id}.
Esquema de entrada
{
"type": "object",
"properties": {
"type": {
"type": "string",
"minLength": 1,
"maxLength": 20,
"pattern": "^(?!\\.{1,2}$)[^/\\\\?#%]+$",
"description": "Document type code (from officegest_list_sale_document_types)."
},
"id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"pattern": "^(?!\\.{1,2}$)[^/\\\\?#%]+$",
"description": "The document id (from officegest_list_sale_documents)."
}
},
"required": [
"type",
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢officegest_get_sales_summary
Get the sales summary: the current month, the previous month, the monthly average and the current year. Uses GET /sales/reports/sales-summary.
Esquema de entrada
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢officegest_list_customer_invoices_due(limit, order, sorder)
List customer invoices that are not yet fully paid, with the amount pending. Uses GET /sales/reports/customer-invoices-due.
Esquema de entrada
{
"type": "object",
"properties": {
"limit": {
"description": "Rows per page, 1 to 250 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 250
},
"order": {
"description": "Sort field.",
"type": "string",
"enum": [
"due_date",
"date",
"total"
]
},
"sorder": {
"description": "Sort direction.",
"type": "string",
"enum": [
"ASC",
"DESC"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢officegest_list_top_debtors(limit, order, sorder)
List the customers who owe the most, with their balance. Uses GET /sales/reports/top-debtors.
Esquema de entrada
{
"type": "object",
"properties": {
"limit": {
"description": "Rows per page, 1 to 250 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 250
},
"order": {
"description": "Sort field.",
"type": "string",
"enum": [
"balance",
"customer_name",
"customer_id"
]
},
"sorder": {
"description": "Sort direction.",
"type": "string",
"enum": [
"ASC",
"DESC"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢officegest_list_supplier_invoices_due(limit, order, sorder)
List supplier invoices that are not yet fully settled, with the amount pending. Uses GET /purchases/reports/supplier-invoices-due.
Esquema de entrada
{
"type": "object",
"properties": {
"limit": {
"description": "Rows per page, 1 to 250 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 250
},
"order": {
"description": "Sort field.",
"type": "string",
"enum": [
"due_date",
"date",
"total"
]
},
"sorder": {
"description": "Sort direction.",
"type": "string",
"enum": [
"ASC",
"DESC"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Comunidad
Evidencia