OfficeGest MCP by usefulapi

Read customers, stock, sales documents and debt reports; create customers in OfficeGest.

Sollte ich dies verwenden

Qualität und Sicherheit

A
Qualität der Beschreibung
90%
Vollständigkeit des Schemas
87%
Qualität der Benennung
74%
Risiko der Vergiftung
100%
Übereinstimmung der Berechtigungen
100%
Einhaltung des Protokolls
100%

Befunde (5)

  • LOWTool 'officegest_get_customer_balance' name length outside 3-30 rangein officegest_get_customer_balance
  • LOWTool 'officegest_list_stock_quantities' name length outside 3-30 rangein officegest_list_stock_quantities
  • LOWTool 'officegest_list_sale_document_types' name length outside 3-30 rangein officegest_list_sale_document_types
  • LOWTool 'officegest_list_customer_invoices_due' name length outside 3-30 rangein officegest_list_customer_invoices_due
  • LOWTool 'officegest_list_supplier_invoices_due' name length outside 3-30 rangein officegest_list_supplier_invoices_due

Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.

Kontextkosten

~2,928Tokens (Tool-Definitionen)
~1.4 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (2.29% von 128k Kontext)

Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.

Installieren

Installation mit einem Klick

Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:

{
  "mcpServers": {
    "officegest": {
      "url": "https://officegest.usefulapi.io/mcp"
    }
  }
}

Remote-Endpunkte

https://officegest.usefulapi.io/mcpstreamable-http

Was es kann

Tool-Inventar

Tools (16)

🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢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.

Eingabe-Schema

{
  "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}.

Eingabe-Schema

{
  "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.

Eingabe-Schema

{
  "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.

Eingabe-Schema

{
  "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.

Eingabe-Schema

{
  "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}.

Eingabe-Schema

{
  "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.

Eingabe-Schema

{
  "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}.

Eingabe-Schema

{
  "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.

Eingabe-Schema

{
  "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.

Eingabe-Schema

{
  "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}.

Eingabe-Schema

{
  "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}.

Eingabe-Schema

{
  "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.

Eingabe-Schema

{
  "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.

Eingabe-Schema

{
  "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.

Eingabe-Schema

{
  "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.

Eingabe-Schema

{
  "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"
}

Community

Diesen Server bewerten

Nachweis

Aktuelle Beobachtungen

verifiziertVersion nicht aufgezeichnet16 Tools