SUMIT MCP by usefulapi

Read documents, customer debts, stock levels and VAT and exchange rates in SUMIT.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
93%
Naming quality
100%
Poisoning risk
80%
Permission match
100%
Protocol compliance
100%

Findings (2)

  • HIGHTool poisoning patterns detected
  • MEDIUMTool description contains suspicious base64-like encoded stringin sumit_get_next_document_number

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~2,037Tokens (tool definitions)
~1.9 KBTypical response size
Moderate attention impact (1.59% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "sumit": {
      "url": "https://sumit.usefulapi.io/mcp"
    }
  }
}

Remote endpoints

https://sumit.usefulapi.io/mcpstreamable-http

What it can do

Tool inventory

Tools (9)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢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/.

Input 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/.

Input 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/.

Input 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/.

Input 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/.

Input 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/.

Input 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/.

Input 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/.

Input 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/.

Input 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

Rate this Server

Evidence

Recent observations

verifiedversion not recorded9 tools