SUMIT MCP by usefulapi
Read documents, customer debts, stock levels and VAT and exchange rates in SUMIT.
¿Debería usar esto?
Calidad y seguridad
Hallazgos (2)
- HIGH
- MEDIUMen sumit_get_next_document_number
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": {
"sumit": {
"url": "https://sumit.usefulapi.io/mcp"
}
}
}Puntos de conexión remotos
https://sumit.usefulapi.io/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (9)
🟢sumit_list_documents(document_types, document_number_from, document_number_to, date_from, date_to, ...)
List accounting documents (invoices, receipts, credit notes, quotes, and more) in the SUMIT account, filtered by type, number, and date. Returns Documents and HasNextPage; page with start_index and page_size. SUMIT API: POST /accounting/documents/list/.
Esquema de entrada
{
"type": "object",
"properties": {
"document_types": {
"description": "Only these types, for example [\"Invoice\", \"Receipt\"].",
"type": "array",
"items": {
"type": "string",
"enum": [
"Invoice",
"InvoiceAndReceipt",
"Receipt",
"ProformaInvoice",
"DonationReceipt",
"CreditInvoice",
"CreditInvoiceAndReceipt",
"CreditReceipt",
"Order",
"DeliveryNote",
"GoodsReturnNote",
"PurchasingOrder",
"PriceQuotation",
"PaymentRequest",
"CreditDonationReceipt",
"ExpenseInvoiceReceipt",
"ExpenseInvoice",
"ExpenseReceipt",
"ExpenseRequest",
"CreditExpenseInvoiceReceipt",
"CreditExpenseInvoice",
"CreditExpenseReceipt",
"SupplierPayment"
]
}
},
"document_number_from": {
"description": "First document number.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"document_number_to": {
"description": "Last document number.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"date_from": {
"description": "First document date, yyyy-mm-dd.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"date_to": {
"description": "Last document date, yyyy-mm-dd.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"include_drafts": {
"description": "Include draft documents (default false).",
"type": "boolean"
},
"start_index": {
"description": "Paging start index. Leave empty for the first page.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"page_size": {
"description": "Items per page, 10 to 1000 (SUMIT default 10).",
"type": "integer",
"minimum": 10,
"maximum": 1000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sumit_get_document(document_id, document_type, document_number)
Get one document with its customer, items, payments, and totals. Give document_id, or document_type with document_number (the number printed in the title). SUMIT API: POST /accounting/documents/getdetails/.
Esquema de entrada
{
"type": "object",
"properties": {
"document_id": {
"description": "The SUMIT document id (from sumit_list_documents).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"document_type": {
"description": "Document type, with document_number.",
"type": "string",
"enum": [
"Invoice",
"InvoiceAndReceipt",
"Receipt",
"ProformaInvoice",
"DonationReceipt",
"CreditInvoice",
"CreditInvoiceAndReceipt",
"CreditReceipt",
"Order",
"DeliveryNote",
"GoodsReturnNote",
"PurchasingOrder",
"PriceQuotation",
"PaymentRequest",
"CreditDonationReceipt",
"ExpenseInvoiceReceipt",
"ExpenseInvoice",
"ExpenseReceipt",
"ExpenseRequest",
"CreditExpenseInvoiceReceipt",
"CreditExpenseInvoice",
"CreditExpenseReceipt",
"SupplierPayment"
]
},
"document_number": {
"description": "Document number, with document_type.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sumit_get_next_document_number(document_type)
Get the number SUMIT would give the next document of this type. It reserves nothing. SUMIT API: POST /accounting/general/getnextdocumentnumber/.
Esquema de entrada
{
"type": "object",
"properties": {
"document_type": {
"type": "string",
"enum": [
"Invoice",
"InvoiceAndReceipt",
"Receipt",
"ProformaInvoice",
"DonationReceipt",
"CreditInvoice",
"CreditInvoiceAndReceipt",
"CreditReceipt",
"Order",
"DeliveryNote",
"GoodsReturnNote",
"PurchasingOrder",
"PriceQuotation",
"PaymentRequest",
"CreditDonationReceipt",
"ExpenseInvoiceReceipt",
"ExpenseInvoice",
"ExpenseReceipt",
"ExpenseRequest",
"CreditExpenseInvoiceReceipt",
"CreditExpenseInvoice",
"CreditExpenseReceipt",
"SupplierPayment"
],
"description": "Document type, for example Invoice."
}
},
"required": [
"document_type"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sumit_get_customer_debt(customer_id, debit_source, credit_source, include_draft_documents)
Get how much one customer owes, by comparing the debit types (documents that raise debt) with the credit types (documents that settle it). SUMIT API: POST /accounting/documents/getdebt/.
Esquema de entrada
{
"type": "object",
"properties": {
"customer_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The SUMIT customer id."
},
"debit_source": {
"type": "string",
"enum": [
"TaxInvoice",
"ProformaInvoice",
"PaymentRequest",
"Receipt",
"ProformaInvoicePaymentRequest",
"ProformaInvoicePaymentRequestTaxInvoice"
],
"description": "Debit side, for example TaxInvoice."
},
"credit_source": {
"type": "string",
"enum": [
"TaxInvoice",
"ProformaInvoice",
"PaymentRequest",
"Receipt",
"ProformaInvoicePaymentRequest",
"ProformaInvoicePaymentRequestTaxInvoice"
],
"description": "Credit side, for example Receipt."
},
"include_draft_documents": {
"description": "Count draft documents too (default false).",
"type": "boolean"
}
},
"required": [
"customer_id",
"debit_source",
"credit_source"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sumit_get_debt_report(debit_source, credit_source, include_draft_documents)
Get the debt of every customer who owes money, using the same debit and credit types as sumit_get_customer_debt. SUMIT API: POST /accounting/documents/getdebtreport/.
Esquema de entrada
{
"type": "object",
"properties": {
"debit_source": {
"type": "string",
"enum": [
"TaxInvoice",
"ProformaInvoice",
"PaymentRequest",
"Receipt",
"ProformaInvoicePaymentRequest",
"ProformaInvoicePaymentRequestTaxInvoice"
],
"description": "Debit side, for example TaxInvoice."
},
"credit_source": {
"type": "string",
"enum": [
"TaxInvoice",
"ProformaInvoice",
"PaymentRequest",
"Receipt",
"ProformaInvoicePaymentRequest",
"ProformaInvoicePaymentRequestTaxInvoice"
],
"description": "Credit side, for example Receipt."
},
"include_draft_documents": {
"description": "Count draft documents too (default false).",
"type": "boolean"
}
},
"required": [
"debit_source",
"credit_source"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sumit_list_income_items(start_index, page_size)
List the income items (products and services) in the SUMIT catalog, with price, cost, SKU, and external identifier. SUMIT marks this API alpha, so its shape may change. SUMIT API: POST /accounting/incomeitems/list/.
Esquema de entrada
{
"type": "object",
"properties": {
"start_index": {
"description": "Paging start index. Leave empty for the first page.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"page_size": {
"description": "Items per page, 10 to 1000 (SUMIT default 10).",
"type": "integer",
"minimum": 10,
"maximum": 1000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sumit_list_stock_levels(item_ids, exclude_zero_stock)
List the stock level of catalog items. Leave item_ids empty for all items. SUMIT API: POST /stock/stock/list/.
Esquema de entrada
{
"type": "object",
"properties": {
"item_ids": {
"description": "Income item ids to check (up to 500).",
"maxItems": 500,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"exclude_zero_stock": {
"description": "Leave out items with no stock (default false).",
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sumit_get_vat_rate(date)
Get the VAT rate (Rate, in percent) that applies on a date. Leave date empty for today. SUMIT API: POST /accounting/general/getvatrate/.
Esquema de entrada
{
"type": "object",
"properties": {
"date": {
"description": "Date, yyyy-mm-dd (default today).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sumit_get_exchange_rate(date, currency_from, currency_to)
Get the exchange rate from one currency to another on a date (SUMIT defaults: USD to ILS, today). SUMIT API: POST /accounting/general/getexchangerate/.
Esquema de entrada
{
"type": "object",
"properties": {
"date": {
"description": "Date, yyyy-mm-dd (default today).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"currency_from": {
"description": "Original currency code (default USD).",
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"currency_to": {
"description": "Target currency code (default ILS).",
"type": "string",
"pattern": "^[A-Z]{3}$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Comunidad
Evidencia