OfficeGest MCP by usefulapi is an MCP server published by io.usefulapi, hosted at officegest.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 16 tools, including officegest_list_customers, officegest_get_customer, officegest_get_customer_balance, officegest_create_customer, officegest_list_suppliers.
Read customers, stock, sales documents and debt reports; create customers in OfficeGest.
4,281 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
| Parameter | Type | Description |
|---|---|---|
| name | string | Filter by customer name. |
| type | string | E = company, I = company in an individual's name, P = private individual. |
| string | Filter by e-mail address. | |
| limit | integer | Rows per page, 1 to 250 (default 50). |
| active | boolean | true for active customers only, false for inactive ones. |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
| cursor | string | Cursor from meta.next of the previous page. Omit it for the first page. |
| tax_id | string | Filter by tax id. |
{
"name": "officegest_list_customers",
"title": "List customers",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"description": "Filter by customer name."
},
"type": {
"enum": [
"E",
"I",
"P"
],
"type": "string",
"description": "E = company, I = company in an individual's name, P = private individual."
},
"email": {
"type": "string",
"description": "Filter by e-mail address."
},
"limit": {
"type": "integer",
"maximum": 250,
"minimum": 1,
"description": "Rows per page, 1 to 250 (default 50)."
},
"active": {
"type": "boolean",
"description": "true for active customers only, false for inactive ones."
},
"cursor": {
"type": "string",
"minLength": 1,
"description": "Cursor from meta.next of the previous page. Omit it for the first page."
},
"tax_id": {
"type": "string",
"description": "Filter by tax id."
}
}
},
"annotations": {
"title": "List customers",
"readOnlyHint": true
}
}Get one customer by id: name, tax id, address, contacts, type and status. Uses GET /entities/customers/{customer}.
| Parameter | Type | Description |
|---|---|---|
| customer * | string | The customer id (from officegest_list_customers). |
{
"name": "officegest_get_customer",
"title": "Get a customer",
"description": "Get one customer by id: name, tax id, address, contacts, type and status. Uses GET /entities/customers/{customer}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"customer"
],
"properties": {
"customer": {
"type": "string",
"pattern": "^(?!\\.{1,2}$)[^/\\\\?#%]+$",
"maxLength": 64,
"minLength": 1,
"description": "The customer id (from officegest_list_customers)."
}
}
},
"annotations": {
"title": "Get a customer",
"readOnlyHint": true
}
}Get the current balance of one customer: what the customer owes the company. Uses GET /entities/customers/{customer}/balance.
| Parameter | Type | Description |
|---|---|---|
| customer * | string | The customer id (from officegest_list_customers). |
{
"name": "officegest_get_customer_balance",
"title": "Get a customer balance",
"description": "Get the current balance of one customer: what the customer owes the company. Uses GET /entities/customers/{customer}/balance.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"customer"
],
"properties": {
"customer": {
"type": "string",
"pattern": "^(?!\\.{1,2}$)[^/\\\\?#%]+$",
"maxLength": 64,
"minLength": 1,
"description": "The customer id (from officegest_list_customers)."
}
}
},
"annotations": {
"title": "Get a customer balance",
"readOnlyHint": true
}
}Create a customer record. Creates data in OfficeGest; it does not merge with an existing customer, so search first. Uses POST /entities/customers.
| Parameter | Type | Description |
|---|---|---|
| city | string | City. |
| name * | string | Customer name. |
| type | string | E = company, I = company in an individual's name, P = private individual. |
| string | E-mail address. | |
| phone | string | Phone number. |
| tax_id | string | Tax id. |
| address | string | Street address. |
| postal_code | string | Postal code. |
| country_code * | string | Country code, for example PT or ES. |
| mobile_phone | string | Mobile phone number. |
{
"name": "officegest_create_customer",
"title": "Create a customer",
"description": "Create a customer record. Creates data in OfficeGest; it does not merge with an existing customer, so search first. Uses POST /entities/customers.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"country_code"
],
"properties": {
"city": {
"type": "string",
"maxLength": 100,
"description": "City."
},
"name": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "Customer name."
},
"type": {
"enum": [
"E",
"I",
"P"
],
"type": "string",
"description": "E = company, I = company in an individual's name, P = private individual."
},
"email": {
"type": "string",
"maxLength": 255,
"description": "E-mail address."
},
"phone": {
"type": "string",
"maxLength": 40,
"description": "Phone number."
},
"tax_id": {
"type": "string",
"maxLength": 50,
"description": "Tax id."
},
"address": {
"type": "string",
"maxLength": 255,
"description": "Street address."
},
"postal_code": {
"type": "string",
"maxLength": 20,
"description": "Postal code."
},
"country_code": {
"type": "string",
"maxLength": 3,
"minLength": 2,
"description": "Country code, for example PT or ES."
},
"mobile_phone": {
"type": "string",
"maxLength": 40,
"description": "Mobile phone number."
}
}
},
"annotations": {
"title": "Create a customer",
"idempotentHint": false,
"destructiveHint": true
}
}List suppliers with tax id, contacts and status. Filter by search text, name, tax id, e-mail or active flag. Uses GET /entities/suppliers.
| Parameter | Type | Description |
|---|---|---|
| name | string | Filter by supplier name. |
| page | integer | Page number, starting at 1. |
| string | Filter by e-mail address. | |
| limit | integer | Rows per page, 1 to 250 (default 50). |
| active | boolean | true for active suppliers only, false for inactive ones. |
| search | string | Free-text search over supplier fields. |
| tax_id | string | Filter by tax id. |
{
"name": "officegest_list_suppliers",
"title": "List suppliers",
"description": "List suppliers with tax id, contacts and status. Filter by search text, name, tax id, e-mail or active flag. Uses GET /entities/suppliers.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"description": "Filter by supplier name."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number, starting at 1."
},
"email": {
"type": "string",
"description": "Filter by e-mail address."
},
"limit": {
"type": "integer",
"maximum": 250,
"minimum": 1,
"description": "Rows per page, 1 to 250 (default 50)."
},
"active": {
"type": "boolean",
"description": "true for active suppliers only, false for inactive ones."
},
"search": {
"type": "string",
"description": "Free-text search over supplier fields."
},
"tax_id": {
"type": "string",
"description": "Filter by tax id."
}
}
},
"annotations": {
"title": "List suppliers",
"readOnlyHint": true
}
}Get one supplier by id: name, tax id, address and contacts. Uses GET /entities/suppliers/{supplier}.
| Parameter | Type | Description |
|---|---|---|
| supplier * | string | The supplier id (from officegest_list_suppliers). |
{
"name": "officegest_get_supplier",
"title": "Get a supplier",
"description": "Get one supplier by id: name, tax id, address and contacts. Uses GET /entities/suppliers/{supplier}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"supplier"
],
"properties": {
"supplier": {
"type": "string",
"pattern": "^(?!\\.{1,2}$)[^/\\\\?#%]+$",
"maxLength": 64,
"minLength": 1,
"description": "The supplier id (from officegest_list_suppliers)."
}
}
},
"annotations": {
"title": "Get a supplier",
"readOnlyHint": true
}
}Search articles (products and services) by text, barcode, family or warehouse. Uses GET /stocks/articles/search.
| Parameter | Type | Description |
|---|---|---|
| txt | string | Free-text search: code, description or reference. |
| page | integer | Page number, starting at 1. |
| limit | integer | Rows per page, 1 to 250 (default 50). |
| active | boolean | true for active articles only, false for inactive ones. |
| barcode | string | Barcode, exact match. |
| family_id | string | Filter by family id. |
| warehouse_id | integer | Filter by warehouse id. |
{
"name": "officegest_search_articles",
"title": "Search articles",
"description": "Search articles (products and services) by text, barcode, family or warehouse. Uses GET /stocks/articles/search.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"txt": {
"type": "string",
"description": "Free-text search: code, description or reference."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number, starting at 1."
},
"limit": {
"type": "integer",
"maximum": 250,
"minimum": 1,
"description": "Rows per page, 1 to 250 (default 50)."
},
"active": {
"type": "boolean",
"description": "true for active articles only, false for inactive ones."
},
"barcode": {
"type": "string",
"description": "Barcode, exact match."
},
"family_id": {
"type": "string",
"description": "Filter by family id."
},
"warehouse_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Filter by warehouse id."
}
}
},
"annotations": {
"title": "Search articles",
"readOnlyHint": true
}
}Get one article by id: description, prices, measurement unit, VAT and stock totals. Uses GET /stocks/articles/{article}.
| Parameter | Type | Description |
|---|---|---|
| article * | string | The article id (from officegest_search_articles). |
{
"name": "officegest_get_article",
"title": "Get an article",
"description": "Get one article by id: description, prices, measurement unit, VAT and stock totals. Uses GET /stocks/articles/{article}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"article"
],
"properties": {
"article": {
"type": "string",
"pattern": "^(?!\\.{1,2}$)[^/\\\\?#%]+$",
"maxLength": 64,
"minLength": 1,
"description": "The article id (from officegest_search_articles)."
}
}
},
"annotations": {
"title": "Get an article",
"readOnlyHint": true
}
}List stock quantities per article and warehouse. Zero-stock rows are left out unless include_zero_stock is true. Uses GET /stocks/quantities.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1. |
| limit | integer | Rows per page, 1 to 250 (default 50). |
| article_id | string | Filter by article id. |
| warehouse_id | integer | Filter by warehouse id. |
| include_zero_stock | boolean | true to include rows with zero stock. |
{
"name": "officegest_list_stock_quantities",
"title": "List stock quantities",
"description": "List stock quantities per article and warehouse. Zero-stock rows are left out unless include_zero_stock is true. Uses GET /stocks/quantities.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number, starting at 1."
},
"limit": {
"type": "integer",
"maximum": 250,
"minimum": 1,
"description": "Rows per page, 1 to 250 (default 50)."
},
"article_id": {
"type": "string",
"description": "Filter by article id."
},
"warehouse_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Filter by warehouse id."
},
"include_zero_stock": {
"type": "boolean",
"description": "true to include rows with zero stock."
}
}
},
"annotations": {
"title": "List stock quantities",
"readOnlyHint": true
}
}List the sale document types of the company, with their codes. Use a code with officegest_list_sale_documents. Uses GET /sales/documents.
No parameters.
{
"name": "officegest_list_sale_document_types",
"title": "List sale document types",
"description": "List the sale document types of the company, with their codes. Use a code with officegest_list_sale_documents. Uses GET /sales/documents.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List sale document types",
"readOnlyHint": true
}
}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}.
| Parameter | Type | Description |
|---|---|---|
| type * | string | Document type code (from officegest_list_sale_document_types). |
| limit | integer | Rows per page, 1 to 250 (default 50). |
| serie | string | Filter by document series. |
| cursor | string | Cursor from meta.next of the previous page. Omit it for the first page. |
| canceled | string | T for cancelled documents only, F for the others. |
| end_date | string | Date as YYYY-MM-DD. |
| start_date | string | Date as YYYY-MM-DD. |
| customer_id | string | Filter by customer id. |
| customer_tax_id | string | Filter by customer tax id. |
{
"name": "officegest_list_sale_documents",
"title": "List sale documents",
"description": "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}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"type"
],
"properties": {
"type": {
"type": "string",
"pattern": "^(?!\\.{1,2}$)[^/\\\\?#%]+$",
"maxLength": 20,
"minLength": 1,
"description": "Document type code (from officegest_list_sale_document_types)."
},
"limit": {
"type": "integer",
"maximum": 250,
"minimum": 1,
"description": "Rows per page, 1 to 250 (default 50)."
},
"serie": {
"type": "string",
"description": "Filter by document series."
},
"cursor": {
"type": "string",
"minLength": 1,
"description": "Cursor from meta.next of the previous page. Omit it for the first page."
},
"canceled": {
"enum": [
"T",
"F"
],
"type": "string",
"description": "T for cancelled documents only, F for the others."
},
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date as YYYY-MM-DD."
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date as YYYY-MM-DD."
},
"customer_id": {
"type": "string",
"description": "Filter by customer id."
},
"customer_tax_id": {
"type": "string",
"description": "Filter by customer tax id."
}
}
},
"annotations": {
"title": "List sale documents",
"readOnlyHint": true
}
}Get one sale document by type and id: header, customer, lines and totals. Uses GET /sales/documents/{type}/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The document id (from officegest_list_sale_documents). |
| type * | string | Document type code (from officegest_list_sale_document_types). |
{
"name": "officegest_get_sale_document",
"title": "Get a sale document",
"description": "Get one sale document by type and id: header, customer, lines and totals. Uses GET /sales/documents/{type}/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"type",
"id"
],
"properties": {
"id": {
"type": "string",
"pattern": "^(?!\\.{1,2}$)[^/\\\\?#%]+$",
"maxLength": 64,
"minLength": 1,
"description": "The document id (from officegest_list_sale_documents)."
},
"type": {
"type": "string",
"pattern": "^(?!\\.{1,2}$)[^/\\\\?#%]+$",
"maxLength": 20,
"minLength": 1,
"description": "Document type code (from officegest_list_sale_document_types)."
}
}
},
"annotations": {
"title": "Get a sale document",
"readOnlyHint": true
}
}Get the sales summary: the current month, the previous month, the monthly average and the current year. Uses GET /sales/reports/sales-summary.
No parameters.
{
"name": "officegest_get_sales_summary",
"title": "Get the sales summary",
"description": "Get the sales summary: the current month, the previous month, the monthly average and the current year. Uses GET /sales/reports/sales-summary.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get the sales summary",
"readOnlyHint": true
}
}List customer invoices that are not yet fully paid, with the amount pending. Uses GET /sales/reports/customer-invoices-due.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Rows per page, 1 to 250 (default 50). |
| order | string | Sort field. |
| sorder | string | Sort direction. |
{
"name": "officegest_list_customer_invoices_due",
"title": "List customer invoices due",
"description": "List customer invoices that are not yet fully paid, with the amount pending. Uses GET /sales/reports/customer-invoices-due.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 250,
"minimum": 1,
"description": "Rows per page, 1 to 250 (default 50)."
},
"order": {
"enum": [
"due_date",
"date",
"total"
],
"type": "string",
"description": "Sort field."
},
"sorder": {
"enum": [
"ASC",
"DESC"
],
"type": "string",
"description": "Sort direction."
}
}
},
"annotations": {
"title": "List customer invoices due",
"readOnlyHint": true
}
}List the customers who owe the most, with their balance. Uses GET /sales/reports/top-debtors.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Rows per page, 1 to 250 (default 50). |
| order | string | Sort field. |
| sorder | string | Sort direction. |
{
"name": "officegest_list_top_debtors",
"title": "List top debtors",
"description": "List the customers who owe the most, with their balance. Uses GET /sales/reports/top-debtors.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 250,
"minimum": 1,
"description": "Rows per page, 1 to 250 (default 50)."
},
"order": {
"enum": [
"balance",
"customer_name",
"customer_id"
],
"type": "string",
"description": "Sort field."
},
"sorder": {
"enum": [
"ASC",
"DESC"
],
"type": "string",
"description": "Sort direction."
}
}
},
"annotations": {
"title": "List top debtors",
"readOnlyHint": true
}
}List supplier invoices that are not yet fully settled, with the amount pending. Uses GET /purchases/reports/supplier-invoices-due.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Rows per page, 1 to 250 (default 50). |
| order | string | Sort field. |
| sorder | string | Sort direction. |
{
"name": "officegest_list_supplier_invoices_due",
"title": "List supplier invoices due",
"description": "List supplier invoices that are not yet fully settled, with the amount pending. Uses GET /purchases/reports/supplier-invoices-due.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 250,
"minimum": 1,
"description": "Rows per page, 1 to 250 (default 50)."
},
"order": {
"enum": [
"due_date",
"date",
"total"
],
"type": "string",
"description": "Sort field."
},
"sorder": {
"enum": [
"ASC",
"DESC"
],
"type": "string",
"description": "Sort direction."
}
}
},
"annotations": {
"title": "List supplier invoices due",
"readOnlyHint": true
}
}Tools for OfficeGest, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which customers owe us the most, and how much?"; "Show the sales summary for this month and last month."; "Which supplier invoices are due in the next two weeks?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes OfficeGest data. Free plan: 50 tool calls per month. Run officegest_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run officegest_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run officegest_upgrade without a plan: it returns both plans, each with a payment link for the user to open. officegest_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.