SUMIT MCP by usefulapi
Read documents, customer debts, stock levels and VAT and exchange rates in SUMIT.
Sollte ich dies verwenden
Qualität und Sicherheit
Befunde (2)
- HIGH
- MEDIUMin sumit_get_next_document_number
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": {
"sumit": {
"url": "https://sumit.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://sumit.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (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/.
Eingabe-Schema
{
"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/.
Eingabe-Schema
{
"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/.
Eingabe-Schema
{
"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/.
Eingabe-Schema
{
"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/.
Eingabe-Schema
{
"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/.
Eingabe-Schema
{
"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/.
Eingabe-Schema
{
"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/.
Eingabe-Schema
{
"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/.
Eingabe-Schema
{
"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"
}Community
Nachweis