Vendty MCP by usefulapi
Read sales, products, customers, purchases and restaurant tables in Vendty.
¿Debería usar esto?
Calidad y seguridad
Hallazgos (3)
- LOWen vendty_list_restaurant_sections
- LOWen vendty_get_restaurant_table_order
- LOWen vendty_list_quick_service_orders
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": {
"vendty": {
"url": "https://vendty.usefulapi.io/mcp"
}
}
}Puntos de conexión remotos
https://vendty.usefulapi.io/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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"
}Comunidad
Evidencia