Kledo MCP by usefulapi
Read invoices, bills, contacts, bank balances and financial reports in Kledo.
我該用這個嗎
品質與安全性
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高,可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案:
{
"mcpServers": {
"kledo": {
"url": "https://kledo.usefulapi.io/mcp"
}
}
}遠端端點
https://kledo.usefulapi.io/mcpstreamable-http它能做什麼
工具清單
工具(21)
🟢kledo_list_invoices(search, contact_id, status_id, date_from, date_to, ...)
List sales invoices with contact, dates, amounts and status. Supports due-date and amount filters. Kledo API: GET /finance/invoices.
輸入結構描述
{
"type": "object",
"properties": {
"search": {
"description": "Free-text search.",
"type": "string"
},
"contact_id": {
"description": "Filter by contact id.",
"type": "string"
},
"status_id": {
"description": "Filter by status id (comma separated for several).",
"type": "string"
},
"date_from": {
"description": "Transaction date from (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"date_to": {
"description": "Transaction date to (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"sort_by": {
"description": "Sort column.",
"type": "string",
"enum": [
"trans_date",
"status_id",
"amount_after_tax",
"ref_number",
"memo"
]
},
"order_by": {
"description": "Sort direction.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"per_page": {
"description": "Results per page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"due_date_from": {
"description": "Due date from (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"due_date_to": {
"description": "Due date to (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"amount_gte": {
"description": "Minimum total after tax.",
"type": "number"
},
"amount_lte": {
"description": "Maximum total after tax.",
"type": "number"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢kledo_get_invoice(id)
Get one sales invoice with its line items, payments and contact. Kledo API: GET /finance/invoices/{id}.
輸入結構描述
{
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
],
"description": "Record id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢kledo_list_quotes(search, contact_id, status_id, date_from, date_to, ...)
List sales quotes (penawaran). Kledo API: GET /finance/quotes.
輸入結構描述
{
"type": "object",
"properties": {
"search": {
"description": "Free-text search.",
"type": "string"
},
"contact_id": {
"description": "Filter by contact id.",
"type": "string"
},
"status_id": {
"description": "Filter by status id (comma separated for several).",
"type": "string"
},
"date_from": {
"description": "Transaction date from (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"date_to": {
"description": "Transaction date to (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"sort_by": {
"description": "Sort column.",
"type": "string",
"enum": [
"trans_date",
"status_id",
"amount_after_tax",
"ref_number",
"memo"
]
},
"order_by": {
"description": "Sort direction.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"per_page": {
"description": "Results per page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢kledo_list_sales_orders(search, contact_id, status_id, date_from, date_to, ...)
List sales orders. Kledo API: GET /finance/orders.
輸入結構描述
{
"type": "object",
"properties": {
"search": {
"description": "Free-text search.",
"type": "string"
},
"contact_id": {
"description": "Filter by contact id.",
"type": "string"
},
"status_id": {
"description": "Filter by status id (comma separated for several).",
"type": "string"
},
"date_from": {
"description": "Transaction date from (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"date_to": {
"description": "Transaction date to (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"sort_by": {
"description": "Sort column.",
"type": "string",
"enum": [
"trans_date",
"status_id",
"amount_after_tax",
"ref_number",
"memo"
]
},
"order_by": {
"description": "Sort direction.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"per_page": {
"description": "Results per page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢kledo_list_purchase_invoices(search, contact_id, status_id, date_from, date_to, ...)
List purchase invoices (vendor bills) with amounts and status. Kledo API: GET /finance/purchaseInvoices.
輸入結構描述
{
"type": "object",
"properties": {
"search": {
"description": "Free-text search.",
"type": "string"
},
"contact_id": {
"description": "Filter by contact id.",
"type": "string"
},
"status_id": {
"description": "Filter by status id (comma separated for several).",
"type": "string"
},
"date_from": {
"description": "Transaction date from (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"date_to": {
"description": "Transaction date to (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"sort_by": {
"description": "Sort column.",
"type": "string",
"enum": [
"trans_date",
"status_id",
"amount_after_tax",
"ref_number",
"memo"
]
},
"order_by": {
"description": "Sort direction.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"per_page": {
"description": "Results per page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"due_date_from": {
"description": "Due date from (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"due_date_to": {
"description": "Due date to (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢kledo_get_purchase_invoice(id)
Get one purchase invoice with its line items. Kledo API: GET /finance/purchaseInvoices/{id}.
輸入結構描述
{
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
],
"description": "Record id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢kledo_list_expenses(search, contact_id, status_id, date_from, date_to, ...)
List recorded expenses (biaya). Kledo API: GET /finance/expenses.
輸入結構描述
{
"type": "object",
"properties": {
"search": {
"description": "Free-text search.",
"type": "string"
},
"contact_id": {
"description": "Filter by contact id.",
"type": "string"
},
"status_id": {
"description": "Filter by status id (comma separated for several).",
"type": "string"
},
"date_from": {
"description": "Transaction date from (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"date_to": {
"description": "Transaction date to (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"sort_by": {
"description": "Sort column.",
"type": "string",
"enum": [
"trans_date",
"status_id",
"amount_after_tax",
"ref_number",
"memo"
]
},
"order_by": {
"description": "Sort direction.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"per_page": {
"description": "Results per page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢kledo_list_contacts(search, name, type_id, group_id, include_stats, ...)
List customers, vendors and other contacts with receivable/payable totals when requested. Kledo API: GET /finance/contacts.
輸入結構描述
{
"type": "object",
"properties": {
"search": {
"description": "Free-text search.",
"type": "string"
},
"name": {
"description": "Filter by contact name.",
"type": "string"
},
"type_id": {
"description": "Contact type id (customer, vendor, ...).",
"type": "string"
},
"group_id": {
"description": "Contact group id.",
"type": "string"
},
"include_stats": {
"description": "1 = include receivable/payable stats.",
"anyOf": [
{
"type": "number",
"const": 0
},
{
"type": "number",
"const": 1
}
]
},
"sort_by": {
"description": "Sort column.",
"type": "string",
"enum": [
"name",
"company",
"email",
"phone",
"type_id",
"payable",
"receivable"
]
},
"order_by": {
"description": "Sort direction.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"per_page": {
"description": "Results per page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢kledo_get_contact(id, include_stats)
Get one contact with address, phone, email and (optionally) stats. Kledo API: GET /finance/contacts/{id}.
輸入結構描述
{
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
],
"description": "Record id."
},
"include_stats": {
"description": "1 = include stats.",
"anyOf": [
{
"type": "number",
"const": 0
},
{
"type": "number",
"const": 1
}
]
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢kledo_list_products(search, search_column, stock_status, include_warehouse_qty, sort_by, ...)
List products and services with prices; optionally with stock per warehouse. Kledo API: GET /finance/products.
輸入結構描述
{
"type": "object",
"properties": {
"search": {
"description": "Free-text search.",
"type": "string"
},
"search_column": {
"description": "Column the search applies to.",
"type": "string",
"enum": [
"name",
"code",
"description"
]
},
"stock_status": {
"description": "Filter by stock level.",
"type": "string",
"enum": [
"available",
"empty",
"almost_empty"
]
},
"include_warehouse_qty": {
"description": "1 = include quantity per warehouse.",
"anyOf": [
{
"type": "number",
"const": 0
},
{
"type": "number",
"const": 1
}
]
},
"sort_by": {
"description": "Sort column.",
"type": "string",
"enum": [
"name",
"code",
"category_name",
"base_price",
"price",
"qty"
]
},
"order_by": {
"description": "Sort direction.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"per_page": {
"description": "Results per page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢kledo_get_product(id)
Get one product or service with prices and settings. Kledo API: GET /finance/products/{id}.
輸入結構描述
{
"type": "object",
"properties": {
"id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
],
"description": "Record id."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢kledo_list_accounts(search, include_balance, page, per_page)
List accounts of the chart of accounts, optionally with balances. Kledo API: GET /finance/accounts.
輸入結構描述
{
"type": "object",
"properties": {
"search": {
"description": "Free-text search.",
"type": "string"
},
"include_balance": {
"description": "1 = include account balance.",
"anyOf": [
{
"type": "number",
"const": 0
},
{
"type": "number",
"const": 1
}
]
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"per_page": {
"description": "Results per page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢kledo_get_bank_balances
Get the balance of every cash and bank account. Kledo API: GET /finance/bank/balances.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢kledo_list_bank_transactions(bank_account_id, search, date_from, date_to, page, ...)
List bank transactions (money in, money out, transfers). Kledo API: GET /finance/bankTrans.
輸入結構描述
{
"type": "object",
"properties": {
"bank_account_id": {
"description": "Filter by bank account id.",
"type": "string"
},
"search": {
"description": "Free-text search.",
"type": "string"
},
"date_from": {
"description": "Date from (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"date_to": {
"description": "Date to (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"per_page": {
"description": "Results per page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢kledo_report_profit_loss(date_from, date_to, type)
Profit and loss (laba rugi) for a period. Kledo API: GET /reportings/profitLoss.
輸入結構描述
{
"type": "object",
"properties": {
"date_from": {
"description": "Period start (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"date_to": {
"description": "Period end (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"type": {
"description": "Column breakdown.",
"type": "string",
"enum": [
"monthly",
"yearly",
"quarters",
"custom"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢kledo_report_balance_sheet(date)
Balance sheet (neraca) as of a date. Kledo API: GET /reportings/balanceSheet.
輸入結構描述
{
"type": "object",
"properties": {
"date": {
"description": "As-of date (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢kledo_report_trial_balance(date_from, date_to)
Trial balance for a period. Kledo API: GET /reportings/trialBalance.
輸入結構描述
{
"type": "object",
"properties": {
"date_from": {
"description": "Period start (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"date_to": {
"description": "Period end (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢kledo_report_cash_flow(method, date_from, date_to)
Cash flow statement for a period (direct or indirect method). Kledo API: GET /reportings/cashFlow.
輸入結構描述
{
"type": "object",
"properties": {
"method": {
"description": "Cash flow method.",
"type": "string",
"enum": [
"direct",
"indirect"
]
},
"date_from": {
"description": "Period start (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"date_to": {
"description": "Period end (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢kledo_report_aged_receivable(date, page, per_page)
Unpaid customer invoices grouped by age. Kledo API: GET /reportings/agedReceivable.
輸入結構描述
{
"type": "object",
"properties": {
"date": {
"description": "As-of date (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"per_page": {
"description": "Results per page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢kledo_report_aged_payable(date, page, per_page)
Unpaid vendor bills grouped by age. Kledo API: GET /reportings/agedPayable.
輸入結構描述
{
"type": "object",
"properties": {
"date": {
"description": "As-of date (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"per_page": {
"description": "Results per page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢kledo_report_executive_summary(month, year)
Executive summary (revenue, cost, cash, receivables) for a month. Kledo API: GET /reportings/executiveSummary.
輸入結構描述
{
"type": "object",
"properties": {
"month": {
"description": "Month number 1-12.",
"type": "string",
"pattern": "^(0?[1-9]|1[0-2])$"
},
"year": {
"description": "Four-digit year.",
"type": "string",
"pattern": "^\\d{4}$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}社群
證據