MCP MeasureMCP Measure

索引已观测

Saldeo MCP by usefulapi

Read SaldeoSMART companies, contractors, documents, invoices, bank statements and employees.

我该使用它吗

质量与安全性

A
描述质量
100%
模式完整度
99%
命名质量
80%
投毒风险
100%
权限匹配度
100%
协议合规性
100%

基于对工具定义和协议合规性的自动分析。

上下文开销

~3,278token 数（工具定义）
~2.8 KB典型响应大小
对注意力有显著影响（占 128k 上下文窗口的 2.56%）

这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。

安装

一键安装

将以下内容添加到你的 `claude_desktop_config.json` 文件中：

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

远程端点

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

它能做什么

工具清单

工具（10）

🟢 只读🟡 写入🔴 删除⚪ 未知
🟢saldeo_list_companies(limit, offset)

List the companies (clients) the Saldeo user can see: COMPANY_PROGRAM_ID (needed by every other tool), COMPANY_ID, names, VAT number, address, bank accounts. Start here. Saldeo: GET /api/xml/3.0/company/list.

输入模式

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Entries per list in the reply, 1-1000 (default 100). The reply's \"paging\" says how many exist and the next offset.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "offset": {
      "description": "Skip this many entries of each list (default 0); use paging.next_offset from the previous reply.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢saldeo_list_contractors(company_program_id, limit, offset)

List the contractors (suppliers and customers) of one company: names, VAT number (NIP), address, bank accounts, e-mails, payment days. Saldeo: GET /api/xml/3.0/contractor/list.

输入模式

{
  "type": "object",
  "properties": {
    "company_program_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "pattern": "^[^\\u0000-\\u001f\\u007f]+$",
      "description": "The company's COMPANY_PROGRAM_ID, as returned by saldeo_list_companies."
    },
    "limit": {
      "description": "Entries per list in the reply, 1-1000 (default 50). The reply's \"paging\" says how many exist and the next offset.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "offset": {
      "description": "Skip this many entries of each list (default 0); use paging.next_offset from the previous reply.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "required": [
    "company_program_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢saldeo_search_documents(company_program_id, document_id, number, nip, guid, ...)

Find documents of one company by field (at least one of document_id, number, nip, guid; several are combined with AND). Returns the matching documents. Saldeo: POST /api/xml/3.1/document/search (policy BY_FIELDS).

输入模式

{
  "type": "object",
  "properties": {
    "company_program_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "pattern": "^[^\\u0000-\\u001f\\u007f]+$",
      "description": "The company's COMPANY_PROGRAM_ID, as returned by saldeo_list_companies."
    },
    "document_id": {
      "description": "The Saldeo DOCUMENT_ID.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "number": {
      "description": "The document number, e.g. FV/101/2016.",
      "type": "string",
      "minLength": 1,
      "maxLength": 255
    },
    "nip": {
      "description": "The contractor's VAT number (NIP).",
      "type": "string",
      "minLength": 1,
      "maxLength": 32
    },
    "guid": {
      "description": "The document GUID.",
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    },
    "limit": {
      "description": "Entries per list in the reply, 1-1000 (default 50). The reply's \"paging\" says how many exist and the next offset.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "offset": {
      "description": "Skip this many entries of each list (default 0); use paging.next_offset from the previous reply.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "required": [
    "company_program_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢saldeo_list_document_ids(company_program_id, year, month, limit, offset)

List the ids of all documents of one company in one month folder, grouped by type (contracts, cost/sale/internal/material invoices, orders, writings, other). Feed the ids to saldeo_get_documents_by_ids. Saldeo: POST /api/xml/3.0/document/getidlist.

输入模式

{
  "type": "object",
  "properties": {
    "company_program_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "pattern": "^[^\\u0000-\\u001f\\u007f]+$",
      "description": "The company's COMPANY_PROGRAM_ID, as returned by saldeo_list_companies."
    },
    "year": {
      "type": "integer",
      "minimum": 2000,
      "maximum": 2100,
      "description": "Year of the Saldeo folder (the month the document is booked in), e.g. 2026."
    },
    "month": {
      "type": "integer",
      "minimum": 1,
      "maximum": 12,
      "description": "Month of the Saldeo folder, 1-12."
    },
    "limit": {
      "description": "Entries per list in the reply, 1-1000 (default 500). The reply's \"paging\" says how many exist and the next offset.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "offset": {
      "description": "Skip this many entries of each list (default 0); use paging.next_offset from the previous reply.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "required": [
    "company_program_id",
    "year",
    "month"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢saldeo_get_documents_by_ids(company_program_id, contracts, invoices_cost, invoices_internal, invoices_material, ...)

Get full documents of one company by id, per type (use the groups from saldeo_list_document_ids; at most 200 ids per call). Saldeo: POST /api/xml/3.1/document/listbyid.

输入模式

{
  "type": "object",
  "properties": {
    "company_program_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "pattern": "^[^\\u0000-\\u001f\\u007f]+$",
      "description": "The company's COMPANY_PROGRAM_ID, as returned by saldeo_list_companies."
    },
    "contracts": {
      "description": "CONTRACT ids.",
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "invoices_cost": {
      "description": "INVOICE_COST ids (cost invoices).",
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "invoices_internal": {
      "description": "INVOICE_INTERNAL ids.",
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "invoices_material": {
      "description": "INVOICE_MATERIAL ids.",
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "invoices_sale": {
      "description": "INVOICE_SALE ids (sales invoices).",
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "orders": {
      "description": "ORDER ids.",
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "writings": {
      "description": "WRITING ids.",
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "other_documents": {
      "description": "OTHER_DOCUMENT ids.",
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "limit": {
      "description": "Entries per list in the reply, 1-1000 (default 50). The reply's \"paging\" says how many exist and the next offset.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "offset": {
      "description": "Skip this many entries of each list (default 0); use paging.next_offset from the previous reply.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "required": [
    "company_program_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢saldeo_list_invoices(company_program_id, limit, offset)

List the sales invoices of one company that were marked for export in Saldeo (policy SALDEO): number, dates, contractor, line items, amounts. Saldeo: GET /api/xml/3.0/invoice/list.

输入模式

{
  "type": "object",
  "properties": {
    "company_program_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "pattern": "^[^\\u0000-\\u001f\\u007f]+$",
      "description": "The company's COMPANY_PROGRAM_ID, as returned by saldeo_list_companies."
    },
    "limit": {
      "description": "Entries per list in the reply, 1-1000 (default 50). The reply's \"paging\" says how many exist and the next offset.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "offset": {
      "description": "Skip this many entries of each list (default 0); use paging.next_offset from the previous reply.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "required": [
    "company_program_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢saldeo_list_invoice_ids(company_program_id, year, month, limit, offset)

List the ids of the invoices (invoices, corrective invoices, pre-invoices, corrective pre-invoices) of one company in one month folder. Feed them to saldeo_get_invoices_by_ids. Saldeo: POST /api/xml/3.0/invoice/getidlist.

输入模式

{
  "type": "object",
  "properties": {
    "company_program_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "pattern": "^[^\\u0000-\\u001f\\u007f]+$",
      "description": "The company's COMPANY_PROGRAM_ID, as returned by saldeo_list_companies."
    },
    "year": {
      "type": "integer",
      "minimum": 2000,
      "maximum": 2100,
      "description": "Year of the Saldeo folder (the month the document is booked in), e.g. 2026."
    },
    "month": {
      "type": "integer",
      "minimum": 1,
      "maximum": 12,
      "description": "Month of the Saldeo folder, 1-12."
    },
    "limit": {
      "description": "Entries per list in the reply, 1-1000 (default 500). The reply's \"paging\" says how many exist and the next offset.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "offset": {
      "description": "Skip this many entries of each list (default 0); use paging.next_offset from the previous reply.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "required": [
    "company_program_id",
    "year",
    "month"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢saldeo_get_invoices_by_ids(company_program_id, invoices, corrective_invoices, pre_invoices, corrective_pre_invoices, ...)

Get full invoices of one company by id (ids from saldeo_list_invoice_ids; at most 200 per call). Saldeo: POST /api/xml/3.0/invoice/listbyid.

输入模式

{
  "type": "object",
  "properties": {
    "company_program_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "pattern": "^[^\\u0000-\\u001f\\u007f]+$",
      "description": "The company's COMPANY_PROGRAM_ID, as returned by saldeo_list_companies."
    },
    "invoices": {
      "description": "INVOICE_ID values.",
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "corrective_invoices": {
      "description": "CORRECTIVE_INVOICE_ID values.",
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "pre_invoices": {
      "description": "PRE_INVOICE_ID values.",
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "corrective_pre_invoices": {
      "description": "CORRECTIVE_PRE_INVOICE_ID values.",
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "limit": {
      "description": "Entries per list in the reply, 1-1000 (default 50). The reply's \"paging\" says how many exist and the next offset.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "offset": {
      "description": "Skip this many entries of each list (default 0); use paging.next_offset from the previous reply.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "required": [
    "company_program_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢saldeo_list_bank_statements(company_program_id, limit, offset)

List the bank statements of one company with their entries, contractors and links. Saldeo: GET /api/xml/3.0/bank_statement/list.

输入模式

{
  "type": "object",
  "properties": {
    "company_program_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "pattern": "^[^\\u0000-\\u001f\\u007f]+$",
      "description": "The company's COMPANY_PROGRAM_ID, as returned by saldeo_list_companies."
    },
    "limit": {
      "description": "Entries per list in the reply, 1-1000 (default 50). The reply's \"paging\" says how many exist and the next offset.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "offset": {
      "description": "Skip this many entries of each list (default 0); use paging.next_offset from the previous reply.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "required": [
    "company_program_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢saldeo_list_employees(company_program_id, limit, offset)

List the employees of one company (personnel module): names, acronym and HR master data. Contains personal data. Saldeo: GET /api/xml/3.0/employee/list.

输入模式

{
  "type": "object",
  "properties": {
    "company_program_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "pattern": "^[^\\u0000-\\u001f\\u007f]+$",
      "description": "The company's COMPANY_PROGRAM_ID, as returned by saldeo_list_companies."
    },
    "limit": {
      "description": "Entries per list in the reply, 1-1000 (default 50). The reply's \"paging\" says how many exist and the next offset.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "offset": {
      "description": "Skip this many entries of each list (default 0); use paging.next_offset from the previous reply.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "required": [
    "company_program_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

社区

评价此服务器

证据

最近观测

已验证未记录版本10 个工具