Saldeo MCP by usefulapi is an MCP server published by io.usefulapi, hosted at saldeo.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 10 tools, including saldeo_list_companies, saldeo_list_contractors, saldeo_search_documents, saldeo_list_document_ids, saldeo_get_documents_by_ids.
Read SaldeoSMART companies, contractors, documents, invoices, bank statements and employees.
4,325 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Entries per list in the reply, 1-1000 (default 100). The reply's "paging" says how many exist and the next offset. |
| offset | integer | Skip this many entries of each list (default 0); use paging.next_offset from the previous reply. |
{
"name": "saldeo_list_companies",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Entries per list in the reply, 1-1000 (default 100). The reply's \"paging\" says how many exist and the next offset."
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Skip this many entries of each list (default 0); use paging.next_offset from the previous reply."
}
}
},
"annotations": {
"title": "List companies",
"readOnlyHint": true,
"openWorldHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Entries per list in the reply, 1-1000 (default 50). The reply's "paging" says how many exist and the next offset. |
| offset | integer | Skip this many entries of each list (default 0); use paging.next_offset from the previous reply. |
| company_program_id * | string | The company's COMPANY_PROGRAM_ID, as returned by saldeo_list_companies. |
{
"name": "saldeo_list_contractors",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"company_program_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Entries per list in the reply, 1-1000 (default 50). The reply's \"paging\" says how many exist and the next offset."
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Skip this many entries of each list (default 0); use paging.next_offset from the previous reply."
},
"company_program_id": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f]+$",
"maxLength": 255,
"minLength": 1,
"description": "The company's COMPANY_PROGRAM_ID, as returned by saldeo_list_companies."
}
}
},
"annotations": {
"title": "List contractors",
"readOnlyHint": true,
"openWorldHint": true
}
}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).
| Parameter | Type | Description |
|---|---|---|
| nip | string | The contractor's VAT number (NIP). |
| guid | string | The document GUID. |
| limit | integer | Entries per list in the reply, 1-1000 (default 50). The reply's "paging" says how many exist and the next offset. |
| number | string | The document number, e.g. FV/101/2016. |
| offset | integer | Skip this many entries of each list (default 0); use paging.next_offset from the previous reply. |
| document_id | integer | The Saldeo DOCUMENT_ID. |
| company_program_id * | string | The company's COMPANY_PROGRAM_ID, as returned by saldeo_list_companies. |
{
"name": "saldeo_search_documents",
"description": "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).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"company_program_id"
],
"properties": {
"nip": {
"type": "string",
"maxLength": 32,
"minLength": 1,
"description": "The contractor's VAT number (NIP)."
},
"guid": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "The document GUID."
},
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Entries per list in the reply, 1-1000 (default 50). The reply's \"paging\" says how many exist and the next offset."
},
"number": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "The document number, e.g. FV/101/2016."
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Skip this many entries of each list (default 0); use paging.next_offset from the previous reply."
},
"document_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The Saldeo DOCUMENT_ID.",
"exclusiveMinimum": 0
},
"company_program_id": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f]+$",
"maxLength": 255,
"minLength": 1,
"description": "The company's COMPANY_PROGRAM_ID, as returned by saldeo_list_companies."
}
}
},
"annotations": {
"title": "Search documents",
"readOnlyHint": true,
"openWorldHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| year * | integer | Year of the Saldeo folder (the month the document is booked in), e.g. 2026. |
| limit | integer | Entries per list in the reply, 1-1000 (default 500). The reply's "paging" says how many exist and the next offset. |
| month * | integer | Month of the Saldeo folder, 1-12. |
| offset | integer | Skip this many entries of each list (default 0); use paging.next_offset from the previous reply. |
| company_program_id * | string | The company's COMPANY_PROGRAM_ID, as returned by saldeo_list_companies. |
{
"name": "saldeo_list_document_ids",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"company_program_id",
"year",
"month"
],
"properties": {
"year": {
"type": "integer",
"maximum": 2100,
"minimum": 2000,
"description": "Year of the Saldeo folder (the month the document is booked in), e.g. 2026."
},
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Entries per list in the reply, 1-1000 (default 500). The reply's \"paging\" says how many exist and the next offset."
},
"month": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "Month of the Saldeo folder, 1-12."
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Skip this many entries of each list (default 0); use paging.next_offset from the previous reply."
},
"company_program_id": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f]+$",
"maxLength": 255,
"minLength": 1,
"description": "The company's COMPANY_PROGRAM_ID, as returned by saldeo_list_companies."
}
}
},
"annotations": {
"title": "List document ids",
"readOnlyHint": true,
"openWorldHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Entries per list in the reply, 1-1000 (default 50). The reply's "paging" says how many exist and the next offset. |
| offset | integer | Skip this many entries of each list (default 0); use paging.next_offset from the previous reply. |
| orders | array | ORDER ids. |
| writings | array | WRITING ids. |
| contracts | array | CONTRACT ids. |
| invoices_cost | array | INVOICE_COST ids (cost invoices). |
| invoices_sale | array | INVOICE_SALE ids (sales invoices). |
| other_documents | array | OTHER_DOCUMENT ids. |
| invoices_internal | array | INVOICE_INTERNAL ids. |
| invoices_material | array | INVOICE_MATERIAL ids. |
| company_program_id |
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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Entries per list in the reply, 1-1000 (default 50). The reply's "paging" says how many exist and the next offset. |
| offset | integer | Skip this many entries of each list (default 0); use paging.next_offset from the previous reply. |
| company_program_id * | string | The company's COMPANY_PROGRAM_ID, as returned by saldeo_list_companies. |
{
"name": "saldeo_list_invoices",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"company_program_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Entries per list in the reply, 1-1000 (default 50). The reply's \"paging\" says how many exist and the next offset."
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Skip this many entries of each list (default 0); use paging.next_offset from the previous reply."
},
"company_program_id": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f]+$",
"maxLength": 255,
"minLength": 1,
"description": "The company's COMPANY_PROGRAM_ID, as returned by saldeo_list_companies."
}
}
},
"annotations": {
"title": "List invoices",
"readOnlyHint": true,
"openWorldHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| year * | integer | Year of the Saldeo folder (the month the document is booked in), e.g. 2026. |
| limit | integer | Entries per list in the reply, 1-1000 (default 500). The reply's "paging" says how many exist and the next offset. |
| month * | integer | Month of the Saldeo folder, 1-12. |
| offset | integer | Skip this many entries of each list (default 0); use paging.next_offset from the previous reply. |
| company_program_id * | string | The company's COMPANY_PROGRAM_ID, as returned by saldeo_list_companies. |
{
"name": "saldeo_list_invoice_ids",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"company_program_id",
"year",
"month"
],
"properties": {
"year": {
"type": "integer",
"maximum": 2100,
"minimum": 2000,
"description": "Year of the Saldeo folder (the month the document is booked in), e.g. 2026."
},
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Entries per list in the reply, 1-1000 (default 500). The reply's \"paging\" says how many exist and the next offset."
},
"month": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "Month of the Saldeo folder, 1-12."
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Skip this many entries of each list (default 0); use paging.next_offset from the previous reply."
},
"company_program_id": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f]+$",
"maxLength": 255,
"minLength": 1,
"description": "The company's COMPANY_PROGRAM_ID, as returned by saldeo_list_companies."
}
}
},
"annotations": {
"title": "List invoice ids",
"readOnlyHint": true,
"openWorldHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Entries per list in the reply, 1-1000 (default 50). The reply's "paging" says how many exist and the next offset. |
| offset | integer | Skip this many entries of each list (default 0); use paging.next_offset from the previous reply. |
| invoices | array | INVOICE_ID values. |
| pre_invoices | array | PRE_INVOICE_ID values. |
| company_program_id * | string | The company's COMPANY_PROGRAM_ID, as returned by saldeo_list_companies. |
| corrective_invoices | array | CORRECTIVE_INVOICE_ID values. |
| corrective_pre_invoices | array | CORRECTIVE_PRE_INVOICE_ID values. |
{
"name": "saldeo_get_invoices_by_ids",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"company_program_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Entries per list in the reply, 1-1000 (default 50). The reply's \"paging\" says how many exist and the next offset."
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Skip this many entries of each list (default 0); use paging.next_offset from the previous reply."
},
"invoices": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"maxItems": 200,
"description": "INVOICE_ID values."
},
"pre_invoices": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"maxItems": 200,
"description": "PRE_INVOICE_ID values."
},
"company_program_id": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f]+$",
"maxLength": 255,
"minLength": 1,
"description": "The company's COMPANY_PROGRAM_ID, as returned by saldeo_list_companies."
},
"corrective_invoices": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"maxItems": 200,
"description": "CORRECTIVE_INVOICE_ID values."
},
"corrective_pre_invoices": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"maxItems": 200,
"description": "CORRECTIVE_PRE_INVOICE_ID values."
}
}
},
"annotations": {
"title": "Get invoices by id",
"readOnlyHint": true,
"openWorldHint": true
}
}List the bank statements of one company with their entries, contractors and links. Saldeo: GET /api/xml/3.0/bank_statement/list.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Entries per list in the reply, 1-1000 (default 50). The reply's "paging" says how many exist and the next offset. |
| offset | integer | Skip this many entries of each list (default 0); use paging.next_offset from the previous reply. |
| company_program_id * | string | The company's COMPANY_PROGRAM_ID, as returned by saldeo_list_companies. |
{
"name": "saldeo_list_bank_statements",
"description": "List the bank statements of one company with their entries, contractors and links. Saldeo: GET /api/xml/3.0/bank_statement/list.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"company_program_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Entries per list in the reply, 1-1000 (default 50). The reply's \"paging\" says how many exist and the next offset."
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Skip this many entries of each list (default 0); use paging.next_offset from the previous reply."
},
"company_program_id": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f]+$",
"maxLength": 255,
"minLength": 1,
"description": "The company's COMPANY_PROGRAM_ID, as returned by saldeo_list_companies."
}
}
},
"annotations": {
"title": "List bank statements",
"readOnlyHint": true,
"openWorldHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Entries per list in the reply, 1-1000 (default 50). The reply's "paging" says how many exist and the next offset. |
| offset | integer | Skip this many entries of each list (default 0); use paging.next_offset from the previous reply. |
| company_program_id * | string | The company's COMPANY_PROGRAM_ID, as returned by saldeo_list_companies. |
{
"name": "saldeo_list_employees",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"company_program_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Entries per list in the reply, 1-1000 (default 50). The reply's \"paging\" says how many exist and the next offset."
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Skip this many entries of each list (default 0); use paging.next_offset from the previous reply."
},
"company_program_id": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f]+$",
"maxLength": 255,
"minLength": 1,
"description": "The company's COMPANY_PROGRAM_ID, as returned by saldeo_list_companies."
}
}
},
"annotations": {
"title": "List employees",
"readOnlyHint": true,
"openWorldHint": true
}
}Tools for Saldeo, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "List the companies in our SaldeoSMART office account."; "Show the documents of company X that were sent for export."; "Which cost invoices are in the October 2026 folder of this company?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Saldeo data. Free plan: 50 tool calls per month. Run saldeo_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run saldeo_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run saldeo_upgrade without a plan: it returns both plans, each with a payment link for the user to open. saldeo_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| string |
| The company's COMPANY_PROGRAM_ID, as returned by saldeo_list_companies. |
{
"name": "saldeo_get_documents_by_ids",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"company_program_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Entries per list in the reply, 1-1000 (default 50). The reply's \"paging\" says how many exist and the next offset."
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Skip this many entries of each list (default 0); use paging.next_offset from the previous reply."
},
"orders": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"maxItems": 200,
"description": "ORDER ids."
},
"writings": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"maxItems": 200,
"description": "WRITING ids."
},
"contracts": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"maxItems": 200,
"description": "CONTRACT ids."
},
"invoices_cost": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"maxItems": 200,
"description": "INVOICE_COST ids (cost invoices)."
},
"invoices_sale": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"maxItems": 200,
"description": "INVOICE_SALE ids (sales invoices)."
},
"other_documents": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"maxItems": 200,
"description": "OTHER_DOCUMENT ids."
},
"invoices_internal": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"maxItems": 200,
"description": "INVOICE_INTERNAL ids."
},
"invoices_material": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"maxItems": 200,
"description": "INVOICE_MATERIAL ids."
},
"company_program_id": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f]+$",
"maxLength": 255,
"minLength": 1,
"description": "The company's COMPANY_PROGRAM_ID, as returned by saldeo_list_companies."
}
}
},
"annotations": {
"title": "Get documents by id",
"readOnlyHint": true,
"openWorldHint": true
}
}