Vendty MCP by usefulapi
Read sales, products, customers, purchases and restaurant tables in Vendty.
Sollte ich dies verwenden
Qualität und Sicherheit
Befunde (3)
- LOWin vendty_list_restaurant_sections
- LOWin vendty_get_restaurant_table_order
- LOWin vendty_list_quick_service_orders
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
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": {
"vendty": {
"url": "https://vendty.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://vendty.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (28)
🟢vendty_get_client_info
Show the Vendty API client behind this token: name, rate tier, the scopes the token has, and allowed origins. Use it to see which data tools work. Vendty API: GET /v1/me.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢vendty_list_products(search, category_id, warehouse_id, active, include, ...)
List products of the business: code, name, price, category and active flag. Use updated_since for incremental sync. Use include=stock with warehouse_id for stock levels. Vendty API: GET /v1/products. Scope products:read. Offset pagination.
Eingabe-Schema
{
"type": "object",
"properties": {
"search": {
"description": "Substring of name or code, case-insensitive.",
"type": "string",
"maxLength": 80
},
"category_id": {
"description": "Only products in this category (cat_…).",
"type": "string",
"pattern": "^cat_[1-9A-HJ-NP-Za-km-z]{8,16}$"
},
"warehouse_id": {
"description": "Warehouse (wh_…). Required with include=stock.",
"type": "string",
"pattern": "^wh_[1-9A-HJ-NP-Za-km-z]{8,16}$"
},
"active": {
"description": "true for active, false for inactive products. Default true.",
"type": "boolean"
},
"include": {
"description": "Comma-separated: stock (needs warehouse_id) and/or category.",
"type": "string",
"maxLength": 100
},
"updated_since": {
"description": "ISO 8601 timestamp: only products created or updated at or after it.",
"type": "string",
"maxLength": 40
},
"sort": {
"description": "Sort order. Default -created_at.",
"type": "string",
"enum": [
"name",
"-name",
"price",
"-price",
"created_at",
"-created_at"
]
},
"page": {
"description": "Page number, from 1 (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Rows per page, 1 to 200.",
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢vendty_get_product(product_id)
Get one product by its public ID, with its details. Vendty API: GET /v1/products/{id}. Scope products:read.
Eingabe-Schema
{
"type": "object",
"properties": {
"product_id": {
"type": "string",
"pattern": "^p_[1-9A-HJ-NP-Za-km-z]{8,16}$",
"description": "Product ID (p_…) from vendty_list_products."
}
},
"required": [
"product_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢vendty_list_categories(page, per_page)
List the product categories of the business. Vendty API: GET /v1/categories. Scope products:read. Offset pagination.
Eingabe-Schema
{
"type": "object",
"properties": {
"page": {
"description": "Page number, from 1 (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Rows per page, 1 to 200.",
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢vendty_list_customers(search, identification, group_id, updated_since, sort, ...)
List the business's customers (third parties) with tax ID, contact data and group. Use identification for an exact tax ID match. Vendty API: GET /v1/customers. Scope customers:read. Offset pagination.
Eingabe-Schema
{
"type": "object",
"properties": {
"search": {
"description": "Substring of business name, trade name or tax ID, case-insensitive.",
"type": "string",
"maxLength": 80
},
"identification": {
"description": "Exact tax ID (NIT or other identification).",
"type": "string",
"maxLength": 30
},
"group_id": {
"description": "Only customers in this group (cg_…).",
"type": "string",
"pattern": "^cg_[1-9A-HJ-NP-Za-km-z]{8,16}$"
},
"updated_since": {
"description": "ISO 8601 timestamp: only customers created or updated at or after it.",
"type": "string",
"maxLength": 40
},
"sort": {
"description": "Sort order. Default -id.",
"type": "string",
"enum": [
"business_name",
"-business_name",
"identification",
"-identification",
"id",
"-id"
]
},
"page": {
"description": "Page number, from 1 (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Rows per page, 1 to 200.",
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢vendty_get_customer(customer_id)
Get one customer by its public ID. Vendty API: GET /v1/customers/{id}. Scope customers:read.
Eingabe-Schema
{
"type": "object",
"properties": {
"customer_id": {
"type": "string",
"pattern": "^c_[1-9A-HJ-NP-Za-km-z]{8,16}$",
"description": "Customer ID (c_…) from vendty_list_customers."
}
},
"required": [
"customer_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢vendty_list_customer_groups(page, per_page)
List the customer groups (price or discount groups) of the business. Vendty API: GET /v1/customer-groups. Scope customers:read. Offset pagination.
Eingabe-Schema
{
"type": "object",
"properties": {
"page": {
"description": "Page number, from 1 (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Rows per page, 1 to 200.",
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢vendty_list_customer_sales(customer_id, cursor, per_page)
List the sales of one customer, newest first. Pass meta.next_cursor as cursor for the next page. Vendty API: GET /v1/customers/{id}/sales. Scopes customers:read and sales:read.
Eingabe-Schema
{
"type": "object",
"properties": {
"customer_id": {
"type": "string",
"pattern": "^c_[1-9A-HJ-NP-Za-km-z]{8,16}$",
"description": "Customer ID (c_…)."
},
"cursor": {
"description": "Cursor from meta.next_cursor of the previous page. Omit it on the first page. Stop when the next cursor is null.",
"type": "string",
"maxLength": 2000
},
"per_page": {
"description": "Rows per page, 1 to 100.",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"required": [
"customer_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢vendty_list_sales(cursor, per_page, date_from, date_to, status, ...)
List sales of the business with customer, seller, warehouse and totals. Cursor pagination: pass meta.next_cursor as cursor. date_from to date_to can span at most 90 days. Vendty API: GET /v1/sales. Scope sales:read.
Eingabe-Schema
{
"type": "object",
"properties": {
"cursor": {
"description": "Cursor from meta.next_cursor of the previous page. Omit it on the first page. Stop when the next cursor is null.",
"type": "string",
"maxLength": 2000
},
"per_page": {
"description": "Rows per page, 1 to 100.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"date_from": {
"description": "First day, yyyy-mm-dd.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"date_to": {
"description": "Last day, yyyy-mm-dd.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"status": {
"description": "valid (default), voided, or all.",
"type": "string",
"enum": [
"valid",
"voided",
"all"
]
},
"customer_id": {
"description": "Only sales of this customer (c_…).",
"type": "string",
"pattern": "^c_[1-9A-HJ-NP-Za-km-z]{8,16}$"
},
"warehouse_id": {
"description": "Only sales of this warehouse (wh_…).",
"type": "string",
"pattern": "^wh_[1-9A-HJ-NP-Za-km-z]{8,16}$"
},
"seller_id": {
"description": "Only sales of this seller (sl_…).",
"type": "string",
"pattern": "^sl_[1-9A-HJ-NP-Za-km-z]{8,16}$"
},
"invoice_number": {
"description": "Exact invoice number.",
"type": "string",
"maxLength": 60
},
"include": {
"description": "Comma-separated: details, payments. Customer, seller and warehouse are always loaded.",
"type": "string",
"maxLength": 100
},
"sort": {
"description": "Sort order. Default -date.",
"type": "string",
"enum": [
"date",
"-date",
"total",
"-total",
"id",
"-id"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢vendty_get_sale(sale_id)
Get one sale by its public ID, with its lines and payments. Vendty API: GET /v1/sales/{id}. Scope sales:read.
Eingabe-Schema
{
"type": "object",
"properties": {
"sale_id": {
"type": "string",
"pattern": "^s_[1-9A-HJ-NP-Za-km-z]{8,16}$",
"description": "Sale ID (s_…) from vendty_list_sales."
}
},
"required": [
"sale_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢vendty_list_payment_methods(page, per_page)
List the payment methods the business accepts (cash, card, and others). Vendty API: GET /v1/payment-methods. Scope sales:read. Offset pagination.
Eingabe-Schema
{
"type": "object",
"properties": {
"page": {
"description": "Page number, from 1 (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Rows per page, 1 to 200.",
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢vendty_list_sale_credit_notes(sale_id, page, per_page)
List the credit notes (notas crédito) issued against one sale. Vendty API: GET /v1/sales/{id}/credit-notes. Scope credit-notes:read.
Eingabe-Schema
{
"type": "object",
"properties": {
"sale_id": {
"type": "string",
"pattern": "^s_[1-9A-HJ-NP-Za-km-z]{8,16}$",
"description": "Sale ID (s_…)."
},
"page": {
"description": "Page number, from 1 (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Rows per page, 1 to 200.",
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"required": [
"sale_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢vendty_list_restaurant_sections(warehouse_id, active, page, per_page)
List the floors and sections of the restaurant. Vendty API: GET /v1/restaurant/sections. Scope restaurant:read. Restaurant businesses only.
Eingabe-Schema
{
"type": "object",
"properties": {
"warehouse_id": {
"description": "Warehouse (wh_…).",
"type": "string",
"pattern": "^wh_[1-9A-HJ-NP-Za-km-z]{8,16}$"
},
"active": {
"description": "true (default) for active sections only.",
"type": "boolean"
},
"page": {
"description": "Page number, from 1 (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Rows per page, 1 to 200.",
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢vendty_list_restaurant_tables(warehouse_id, section_id, status, active, page, ...)
List the restaurant tables with their live state (occupied or free). Vendty API: GET /v1/restaurant/tables. Scope restaurant:read. Restaurant businesses only.
Eingabe-Schema
{
"type": "object",
"properties": {
"warehouse_id": {
"description": "Warehouse (wh_…).",
"type": "string",
"pattern": "^wh_[1-9A-HJ-NP-Za-km-z]{8,16}$"
},
"section_id": {
"description": "Only tables of this section (rs_…).",
"type": "string",
"pattern": "^rs_[1-9A-HJ-NP-Za-km-z]{8,16}$"
},
"status": {
"description": "Table state. Default all.",
"type": "string",
"enum": [
"occupied",
"free",
"all"
]
},
"active": {
"description": "true (default) for active tables only.",
"type": "boolean"
},
"page": {
"description": "Page number, from 1 (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Rows per page, 1 to 200.",
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢vendty_get_restaurant_table_order(table_id)
Get the open order of one restaurant table, with its items, additions and kitchen state. Vendty API: GET /v1/restaurant/tables/{id}/order. Scope restaurant:read.
Eingabe-Schema
{
"type": "object",
"properties": {
"table_id": {
"type": "string",
"pattern": "^rt_[1-9A-HJ-NP-Za-km-z]{8,16}$",
"description": "Table ID (rt_…) from vendty_list_restaurant_tables."
}
},
"required": [
"table_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢vendty_list_quick_service_orders(warehouse_id)
List the open Quick Service orders (zone -1), grouped by virtual table. Vendty API: GET /v1/quick-service/orders. Scope restaurant:read.
Eingabe-Schema
{
"type": "object",
"properties": {
"warehouse_id": {
"description": "Warehouse (wh_…).",
"type": "string",
"pattern": "^wh_[1-9A-HJ-NP-Za-km-z]{8,16}$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢vendty_list_warehouses(active, page, per_page)
List the warehouses (almacenes, bodegas) of the business. Vendty API: GET /v1/warehouses. Scope catalogs:read. Offset pagination.
Eingabe-Schema
{
"type": "object",
"properties": {
"active": {
"description": "true (default) for active warehouses, false for inactive ones.",
"type": "boolean"
},
"page": {
"description": "Page number, from 1 (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Rows per page, 1 to 200.",
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢vendty_list_taxes(page, per_page)
List the taxes (impuestos) configured for the business. Vendty API: GET /v1/taxes. Scope catalogs:read.
Eingabe-Schema
{
"type": "object",
"properties": {
"page": {
"description": "Page number, from 1 (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Rows per page, 1 to 200.",
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢vendty_list_sellers(warehouse_id, page, per_page)
List the sellers (vendedores, commission agents) of the business. Vendty API: GET /v1/sellers. Scope catalogs:read.
Eingabe-Schema
{
"type": "object",
"properties": {
"warehouse_id": {
"description": "Only sellers of this warehouse (wh_…).",
"type": "string",
"pattern": "^wh_[1-9A-HJ-NP-Za-km-z]{8,16}$"
},
"page": {
"description": "Page number, from 1 (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Rows per page, 1 to 200.",
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢vendty_list_users(is_admin, page, per_page)
List the human users of the business (not API clients). Vendty API: GET /v1/users. Scope catalogs:read.
Eingabe-Schema
{
"type": "object",
"properties": {
"is_admin": {
"description": "true for admins only, false for non-admins only.",
"type": "boolean"
},
"page": {
"description": "Page number, from 1 (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Rows per page, 1 to 200.",
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢vendty_list_price_lists(warehouse_id, page, per_page)
List the price lists (listas de precio) of the business. Vendty API: GET /v1/price-lists. Scope catalogs:read.
Eingabe-Schema
{
"type": "object",
"properties": {
"warehouse_id": {
"description": "Only price lists of this warehouse (wh_…).",
"type": "string",
"pattern": "^wh_[1-9A-HJ-NP-Za-km-z]{8,16}$"
},
"page": {
"description": "Page number, from 1 (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Rows per page, 1 to 200.",
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢vendty_list_suppliers(search, identification, page, per_page)
List the suppliers (proveedores) of the business. Vendty API: GET /v1/suppliers. Scope purchases:read. Offset pagination.
Eingabe-Schema
{
"type": "object",
"properties": {
"search": {
"description": "Substring of the supplier name, case-insensitive.",
"type": "string",
"maxLength": 80
},
"identification": {
"description": "Exact tax ID.",
"type": "string",
"maxLength": 30
},
"page": {
"description": "Page number, from 1 (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"per_page": {
"description": "Rows per page, 1 to 200.",
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢vendty_list_purchase_orders(cursor, per_page, status, date_from, date_to, ...)
List purchase invoices (facturas de compra) with supplier and totals. Cursor pagination: pass meta.next_cursor as cursor. Vendty API: GET /v1/purchase-orders. Scope purchases:read.
Eingabe-Schema
{
"type": "object",
"properties": {
"cursor": {
"description": "Cursor from meta.next_cursor of the previous page. Omit it on the first page. Stop when the next cursor is null.",
"type": "string",
"maxLength": 2000
},
"per_page": {
"description": "Rows per page, 1 to 100.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"status": {
"description": "valid (default), voided, or all.",
"type": "string",
"enum": [
"valid",
"voided",
"all"
]
},
"date_from": {
"description": "First day, yyyy-mm-dd.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"date_to": {
"description": "Last day, yyyy-mm-dd.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"warehouse_id": {
"description": "Warehouse (wh_…).",
"type": "string",
"pattern": "^wh_[1-9A-HJ-NP-Za-km-z]{8,16}$"
},
"supplier_id": {
"description": "Supplier (sup_…).",
"type": "string",
"pattern": "^sup_[1-9A-HJ-NP-Za-km-z]{8,16}$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢vendty_get_purchase_order(purchase_order_id)
Get one purchase invoice by its public ID, with its lines and payments. Vendty API: GET /v1/purchase-orders/{id}. Scope purchases:read.
Eingabe-Schema
{
"type": "object",
"properties": {
"purchase_order_id": {
"type": "string",
"pattern": "^po_[1-9A-HJ-NP-Za-km-z]{8,16}$",
"description": "Purchase invoice ID (po_…)."
}
},
"required": [
"purchase_order_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢vendty_list_support_documents(cursor, per_page, date_from, date_to, warehouse_id, ...)
List DIAN support documents (documentos soporte) for purchases from suppliers. Cursor pagination: pass meta.next_cursor as cursor. Vendty API: GET /v1/support-documents. Scope purchases:read.
Eingabe-Schema
{
"type": "object",
"properties": {
"cursor": {
"description": "Cursor from meta.next_cursor of the previous page. Omit it on the first page. Stop when the next cursor is null.",
"type": "string",
"maxLength": 2000
},
"per_page": {
"description": "Rows per page, 1 to 100.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"date_from": {
"description": "First day, yyyy-mm-dd.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"date_to": {
"description": "Last day, yyyy-mm-dd.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"warehouse_id": {
"description": "Warehouse (wh_…).",
"type": "string",
"pattern": "^wh_[1-9A-HJ-NP-Za-km-z]{8,16}$"
},
"supplier_id": {
"description": "Supplier (sup_…).",
"type": "string",
"pattern": "^sup_[1-9A-HJ-NP-Za-km-z]{8,16}$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢vendty_get_support_document(support_document_id)
Get one support document by its public ID. Vendty API: GET /v1/support-documents/{id}. Scope purchases:read.
Eingabe-Schema
{
"type": "object",
"properties": {
"support_document_id": {
"type": "string",
"pattern": "^supdoc_[1-9A-HJ-NP-Za-km-z]{8,16}$",
"description": "Support document ID (supdoc_…)."
}
},
"required": [
"support_document_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢vendty_list_reports(cursor, per_page, status, report_type)
List the asynchronous report jobs generated for the business, with their status. Cursor pagination: pass meta.next_cursor as cursor. Vendty API: GET /v1/reports. Scope reports:read.
Eingabe-Schema
{
"type": "object",
"properties": {
"cursor": {
"description": "Cursor from meta.next_cursor of the previous page. Omit it on the first page. Stop when the next cursor is null.",
"type": "string",
"maxLength": 2000
},
"per_page": {
"description": "Rows per page, 1 to 100.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"status": {
"description": "Only jobs in this status.",
"type": "string",
"maxLength": 40
},
"report_type": {
"description": "Only jobs of this report type.",
"type": "string",
"maxLength": 60
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢vendty_get_report(report_id)
Get one report job by its public ID: status and, when ready, where to download the file. Vendty API: GET /v1/reports/{id}. Scope reports:read.
Eingabe-Schema
{
"type": "object",
"properties": {
"report_id": {
"type": "string",
"pattern": "^rj_[1-9A-HJ-NP-Za-km-z]{8,16}$",
"description": "Report job ID (rj_…) from vendty_list_reports."
}
},
"required": [
"report_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Nachweis