Vendty MCP by usefulapi
Read sales, products, customers, purchases and restaurant tables in Vendty.
使うべきか
品質と安全性
検出事項(3)
- LOWvendty_list_restaurant_sections 内
- LOWvendty_get_restaurant_table_order 内
- LOWvendty_list_quick_service_orders 内
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"vendty": {
"url": "https://vendty.usefulapi.io/mcp"
}
}
}リモートエンドポイント
https://vendty.usefulapi.io/mcpstreamable-httpできること
ツール一覧
ツール(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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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"
}コミュニティ
エビデンス