SUMIT MCP by usefulapi
Read documents, customer debts, stock levels and VAT and exchange rates in SUMIT.
사용해야 할까요
품질 및 안전성
발견 사항 (2)
- HIGH
- MEDIUMsumit_get_next_document_number에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"sumit": {
"url": "https://sumit.usefulapi.io/mcp"
}
}
}원격 엔드포인트
https://sumit.usefulapi.io/mcpstreamable-http할 수 있는 일
도구 목록
도구 (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/.
입력 스키마
{
"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/.
입력 스키마
{
"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/.
입력 스키마
{
"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/.
입력 스키마
{
"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/.
입력 스키마
{
"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/.
입력 스키마
{
"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/.
입력 스키마
{
"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/.
입력 스키마
{
"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/.
입력 스키마
{
"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"
}커뮤니티
증거