The Holded MCP connector routes your AI agent's tool calls to Holded's own MCP server through Scalekit. Each user signs in to Holded once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 142 tools.
- Tools
- 142
- What they doRead · write · destructive
- 142 · 0 · 0142 read0 write0 destructive
- Users sign in with
- OAuth
- OAuth app
- Your own Holded MCP server app
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Holded MCP connection
In AgentKit > Connections, create a Holded MCP connection and copy its redirect URI. The name you give it is the
connection_nameyour code passes. See Configure connections.Register an OAuth app
Holded MCP server connections use your own OAuth app. Register one with Holded MCP server and add the redirect URI you copied.
Then enter the app's Client ID and Client Secret on the Holded MCP connection.
Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'holdedmcp'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Holded MCP:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'holdedmcp_get_usage',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "holdedmcp"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Holded MCP:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="holdedmcp_get_usage",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user signs in once. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolholdedmcp_download_inbox_file**Required permission:** `inbox:inbox.read` Returns the raw content of a file attached to an incoming document.Read-onlyDownload a file from an inbox document
**Required permission:** `inbox:inbox.read` Returns the raw content of a file attached to an incoming document. Use `?variant=inline` to display the file in-browser with 24-hour caching instead of triggering a download.
Inputs
filenamestringrequired- Name of the file to retrieve
incomingDocumentIdstringrequired- Incoming document identifier
variantstring- Delivery mode: download (attachment) or inline (display with cache)one of
downloadinlinedefaultdownload
holdedmcp_find_invoices_by_document_number**Required permission:** `sales:invoices.read` Returns invoices in your account whose document number matches the given value.Read-onlyFind invoices by document number
**Required permission:** `sales:invoices.read` Returns invoices in your account whose document number matches the given value. The match is **fuzzy autocomplete**: partial prefixes (e.g. `F260`) return all invoices that start with that token, and minor typos are tolerated. Results are scored by relevance and limited to the authenticated account. Draft, deleted and cancelled invoices are excluded. Results are cursor-paginated: the response includes a `cursor` value and a `has_more` boolean. Pass the `cursor` to the next request to fetch the following page.
Inputs
document_numberstringrequired- Document number to look up. Supports prefixes (e.g. `F260`) and tolerates minor typos.
cursorstring- Pagination cursor returned by the previous response. Omit to start from the first page.
limitinteger- Maximum number of invoices to return per page.default
50
holdedmcp_get_banking_account**Required permission:** `accounting:banks.read` Retrieves the full details of a single banking account by its unique identifier.Read-onlyGet a banking account by ID
**Required permission:** `accounting:banks.read` Retrieves the full details of a single banking account by its unique identifier. The response includes the current balance, bank details (IBAN, BIC), synchronization status, and archived state.
Inputs
idstringrequired- Banking account identifier
holdedmcp_get_booking**Required permission:** `crm:booking-services.read` Returns a single booking identified by its unique ID.Read-onlyGet a booking by ID
**Required permission:** `crm:booking-services.read` Returns a single booking identified by its unique ID.
Inputs
bookingIdstringrequired- Booking ID (24-char hex ObjectId)
holdedmcp_get_booking_location_slots**Required permission:** `crm:booking-services.read` Returns available time slots for a specific service at a location on a given day.Read-onlyGet available slots for a location
**Required permission:** `crm:booking-services.read` Returns available time slots for a specific service at a location on a given day. The response also includes the booking form fields (under `form`) that must be collected from the user before calling Create a booking.
Inputs
daystringrequired- Date in YYYY-MM-DD format
locationIdstringrequired- Location ID (24-char hex ObjectId)
service_idstringrequired- Service identifier
holdedmcp_get_contact**Required permission:** `contacts:contacts.read` Retrieves the full details of a single contact by its unique identifier.Read-onlyGet a contact by ID
**Required permission:** `contacts:contacts.read` Retrieves the full details of a single contact by its unique identifier. The response includes all contact data: billing address, shipping addresses, contact persons, custom fields, default invoicing settings, social networks, and accounting records. Use this endpoint when you need the complete contact profile — for list views, prefer the List contacts endpoint which returns the same fields but paginated.
Inputs
contactIdstringrequired- Contact ID (24-char hex ObjectId)
holdedmcp_get_contact_attachment**Required permission:** `contacts:contacts.read` Downloads a single attachment from a contact.Read-onlyGet a contact attachment
**Required permission:** `contacts:contacts.read` Downloads a single attachment from a contact. The response body contains the raw file bytes. Use the `Content-Disposition` header to obtain the original file name.
Inputs
contactIdstringrequired- Contact ID (24-char hex ObjectId)
filenamestringrequired- Attachment file name (case-insensitive match)
holdedmcp_get_contact_group**Required permission:** `contacts:contacts.read` Returns a single contact group by its ID.Read-onlyGet a contact group
**Required permission:** `contacts:contacts.read` Returns a single contact group by its ID.
Inputs
contactGroupIdstringrequired- Contact Group ID (24-char hex ObjectId)
holdedmcp_get_contact_portal_link**Required permission:** `contacts:contacts.read` Generates a portal access link for a specific contact.Read-onlyGet client portal link for a contact
**Required permission:** `contacts:contacts.read` Generates a portal access link for a specific contact. The link allows the contact to access their client portal where they can view documents. The link expires after 2 days.
Inputs
contactIdstringrequired- Contact ID (24-char hex ObjectId)
holdedmcp_get_credit_note**Required permission:** `sales:invoices.read` Retrieves the full details of a single credit note by its unique identifier.Read-onlyGet a credit note
**Required permission:** `sales:invoices.read` Retrieves the full details of a single credit note by its unique identifier. The response includes line items, payment status and breakdown, custom fields, and the source document if the credit note was created from an invoice.
Inputs
creditNoteIdstringrequired- Credit Note ID (24-char hex ObjectId)
holdedmcp_get_credit_note_attachment**Required permission:** `sales:invoices.read` Downloads a specific attachment from a credit note.Read-onlyGet credit note attachment
**Required permission:** `sales:invoices.read` Downloads a specific attachment from a credit note. The response contains the raw binary content of the file.
Inputs
attachmentIdstringrequired- Attachment identifier (filename)
creditNoteIdstringrequired- Credit Note ID (24-char hex ObjectId)
holdedmcp_get_credit_note_pdf**Required permission:** `sales:invoices.read` Downloads the credit note as a PDF file.Read-onlyGet credit note PDF
**Required permission:** `sales:invoices.read` Downloads the credit note as a PDF file. The response Content-Type is `application/pdf`. The PDF is generated using the template configured in your account settings.
Inputs
creditNoteIdstringrequired- Credit Note ID (24-char hex ObjectId)
holdedmcp_get_employee**Required permission:** `team:employees.read` Returns a single employee by its ID.Read-onlyGet an employee
**Required permission:** `team:employees.read` Returns a single employee by its ID.
Inputs
employeeIdstringrequired- Employee ID
holdedmcp_get_employee_contract**Required permission:** `team:employees.read` Returns all fields of the employee's active contract.Read-onlyGet active contract
**Required permission:** `team:employees.read` Returns all fields of the employee's active contract. Use this as the first step before updating a contract field: fetch the current data here, then send ALL fields back to the PUT endpoint modifying only what you want to change. Field names in this response match exactly the field names expected by the PUT endpoint.
Inputs
employeeIdstringrequired- Employee ID
holdedmcp_get_employee_time**Required permission:** `team:time-tracking.read` Returns a single employee time tracking entry by its ID.Read-onlyGet an employee time entry
**Required permission:** `team:time-tracking.read` Returns a single employee time tracking entry by its ID.
Inputs
timeIdstringrequired- Employee time entry ID
holdedmcp_get_estimate**Required permission:** `sales:estimates.read` Retrieves the full details of a single estimate by its unique identifier.Read-onlyGet an estimate
**Required permission:** `sales:estimates.read` Retrieves the full details of a single estimate by its unique identifier. The response includes line items, custom fields, pipeline stage, and the source document if the estimate was converted from another document. A signed-in user with limited access to estimates only reaches the estimates assigned to them or created by them; any other is reported as not found. API keys still need the scope of this endpoint.
Inputs
estimateIdstringrequired- Estimate ID (24-char hex ObjectId)
holdedmcp_get_estimate_attachment**Required permission:** `sales:estimates.read` Downloads a specific attachment from an estimate.Read-onlyGet estimate attachment
**Required permission:** `sales:estimates.read` Downloads a specific attachment from an estimate. The response contains the raw binary content of the file. A signed-in user with limited access to estimates only reaches the estimates assigned to them or created by them; any other is reported as not found. API keys still need the scope of this endpoint.
Inputs
attachmentIdstringrequired- Attachment identifier (filename)
estimateIdstringrequired- Estimate ID (24-char hex ObjectId)
holdedmcp_get_estimate_pdf**Required permission:** `sales:estimates.read` Downloads the estimate as a PDF file.Read-onlyGet estimate PDF
**Required permission:** `sales:estimates.read` Downloads the estimate as a PDF file. The response Content-Type is `application/pdf`. The PDF is generated using the template configured in your account settings and reflects the current state of the estimate. A signed-in user with limited access to estimates only reaches the estimates assigned to them or created by them; any other is reported as not found. API keys still need the scope of this endpoint.
Inputs
estimateIdstringrequired- Estimate ID (24-char hex ObjectId)
holdedmcp_get_event**Required permission:** `crm:events.read` Retrieves the full details of a single CRM event by its unique identifier.Read-onlyGet an event by ID
**Required permission:** `crm:events.read` Retrieves the full details of a single CRM event by its unique identifier.
Inputs
eventIdstringrequired- Event ID (24-char hex ObjectId)
holdedmcp_get_expenses_account**Required permission:** `accounting:expenses-accounts.read` Retrieves the details of a single expenses account by its unique identifier.Read-onlyGet an expenses account by ID
**Required permission:** `accounting:expenses-accounts.read` Retrieves the details of a single expenses account by its unique identifier. The response includes the account name, color, accounting number, and archived status.
Inputs
expensesAccountIdstringrequired- Expenses Account ID (24-char hex ObjectId)
holdedmcp_get_funnel**Required permission:** `crm:funnels.read` Returns a single funnel by its ID.Read-onlyGet a funnel
**Required permission:** `crm:funnels.read` Returns a single funnel by its ID.
Inputs
funnelIdstringrequired- Funnel ID
holdedmcp_get_inbox**Required permission:** `inbox:inbox.read` Retrieves the full details of a single incoming document by its unique identifier.Read-onlyGet an incoming document by ID
**Required permission:** `inbox:inbox.read` Retrieves the full details of a single incoming document by its unique identifier.
Inputs
incomingDocumentIdstringrequired- Incoming document identifier (24-char hex ObjectId)
holdedmcp_get_invoice**Required permission:** `sales:invoices.read` Retrieves the full details of a single invoice by its unique identifier.Read-onlyGet an invoice
**Required permission:** `sales:invoices.read` Retrieves the full details of a single invoice by its unique identifier. The response includes line items, payment status and breakdown, custom fields, pipeline stage, and the source document if the invoice was converted from an estimate or sales order.
Inputs
invoiceIdstringrequired- Invoice ID (24-char hex ObjectId)
holdedmcp_get_invoice_attachment**Required permission:** `sales:invoices.read` Downloads a specific attachment from an invoice.Read-onlyGet invoice attachment
**Required permission:** `sales:invoices.read` Downloads a specific attachment from an invoice. The response contains the raw binary content of the file.
Inputs
attachmentIdstringrequired- Attachment identifier (filename)
invoiceIdstringrequired- Invoice ID (24-char hex ObjectId)
holdedmcp_get_invoice_pdf**Required permission:** `sales:invoices.read` Downloads the invoice as a PDF file.Read-onlyGet invoice PDF
**Required permission:** `sales:invoices.read` Downloads the invoice as a PDF file. The response Content-Type is `application/pdf`. The PDF is generated using the template configured in your account settings. It reflects the current state of the invoice, including any updates made after creation.
Inputs
invoiceIdstringrequired- Invoice ID (24-char hex ObjectId)
holdedmcp_get_invoice_recurring**Required permission:** `sales:invoices.read` Retrieves the full details of a single recurring invoice by its unique identifier.Read-onlyGet a recurring invoice
**Required permission:** `sales:invoices.read` Retrieves the full details of a single recurring invoice by its unique identifier.
Inputs
invoiceRecurringIdstringrequired- Recurring invoice ID (24-char hex ObjectId)
holdedmcp_get_invoicing_forecast**Required permission:** `accounting:cashflow.read` Returns the full details of a single invoicing forecast by its unique identifier.Read-onlyGet an invoicing forecast
**Required permission:** `accounting:cashflow.read` Returns the full details of a single invoicing forecast by its unique identifier. An invoicing forecast represents a scheduled payment milestone on an estimate or purchase order. Use when the user asks for the details of a specific cashflow forecast by id. Distinct from the List endpoint: this returns one complete forecast record rather than a paginated collection.
Inputs
forecastIdstringrequired- Invoicing forecast identifier (24-character hex ObjectId)
holdedmcp_get_lead**Required permission:** `crm:deals.read` Returns a single lead by its ID.Read-onlyGet a lead
**Required permission:** `crm:deals.read` Returns a single lead by its ID.
Inputs
leadIdstringrequired- Lead ID
holdedmcp_get_ledger_entry**Required permission:** `accounting:daily-ledger.read` Retrieves a single ledger entry (asiento contable) by its ID, including every debit/credit line that makes up the entry.Read-onlyGet a ledger entry
**Required permission:** `accounting:daily-ledger.read` Retrieves a single ledger entry (asiento contable) by its ID, including every debit/credit line that makes up the entry.
Inputs
ledgerEntryIdstringrequired- Ledger entry ID (24-char hex ObjectId)
holdedmcp_get_payment**Required permission:** `accounting:payments.read` Retrieves the full details of a single payment record by its unique identifier.Read-onlyGet a payment by ID
**Required permission:** `accounting:payments.read` Retrieves the full details of a single payment record by its unique identifier. The response includes amount, date, status, reconciliation status, and the linked contact and source document.
Inputs
paymentIdstringrequired- Payment ID (24-char hex ObjectId)
holdedmcp_get_payment_method**Required permission:** `sales:invoicing-settings.read` Returns a single configured payment method by its ID.Read-onlyGet a payment method by ID
**Required permission:** `sales:invoicing-settings.read` Returns a single configured payment method by its ID. The ID comes from the 'id' field in the list endpoint response. Note: this returns a configured payment method (manual or connected gateway such as Stripe, PayPal, GoCardless, Square, Monei, or Wallet) — not an individual transaction. Use /api/v2/payments/{id} to fetch a specific payment transaction.
Inputs
paymentMethodIdstringrequired- Payment method identifier
holdedmcp_get_price_list**Required permission:** `inventory:rates.read` Retrieves the details of a single price list (rate) by its unique identifier.Read-onlyGet a price list by ID
**Required permission:** `inventory:rates.read` Retrieves the details of a single price list (rate) by its unique identifier. The response includes the price list name and optional description.
Inputs
priceListIdstringrequired- Price List ID (24-char hex ObjectId)
holdedmcp_get_product**Required permission:** `inventory:products.read` Retrieves the full details of a single product by its unique identifier.Read-onlyGet a product by ID
**Required permission:** `inventory:products.read` Retrieves the full details of a single product by its unique identifier. The response includes variants, stock levels across warehouses, custom fields, tax configuration, and pricing information.
Inputs
productIdstringrequired- Product ID (24-char hex ObjectId)
holdedmcp_get_product_image**Required permission:** `inventory:products.read` Retrieves a single image from a product by its image identifier.Read-onlyGet a product image by ID
**Required permission:** `inventory:products.read` Retrieves a single image from a product by its image identifier. The response includes the image URL, available sizes with dimensions, position, and description.
Inputs
imageIdstringrequired- Image ID (24-char hex ObjectId)
productIdstringrequired- Product ID (24-char hex ObjectId)
holdedmcp_get_product_main_image**Required permission:** `inventory:products.read` Retrieves the main (first) image of a product.Read-onlyGet the main product image
**Required permission:** `inventory:products.read` Retrieves the main (first) image of a product. Returns 404 if the product has no images.
Inputs
productIdstringrequired- Product ID (24-char hex ObjectId)
holdedmcp_get_product_stock**Required permission:** `inventory:products.read` Returns the stock availability of a product, broken down into total, available, reserved and in-transit quantities across all warehouses, plus the physical stock stored in each warehouse.Read-onlyGet stock availability for a product
**Required permission:** `inventory:products.read` Returns the stock availability of a product, broken down into total, available, reserved and in-transit quantities across all warehouses, plus the physical stock stored in each warehouse. Reserved stock represents units committed to pending sales orders. In-transit stock represents units incoming from purchase orders. Available stock equals total minus reserved.
Inputs
productIdstringrequired- Product ID (24-char hex ObjectId)
holdedmcp_get_product_stock_transit**Required permission:** `inventory:products.read` Returns the stock in transit for a product, including per-document movement details.Read-onlyGet stock in transit for a product
**Required permission:** `inventory:products.read` Returns the stock in transit for a product, including per-document movement details. Each movement represents a document (purchase order, sales order or production order) that affects the product's transit stock. Incoming movements come from purchase orders. Compromised movements come from sales or production orders. For pack products, the response aggregates transit data from all component products.
Inputs
productIdstringrequired- Product ID (24-char hex ObjectId)
holdedmcp_get_production_order**Required permission:** `inventory:production-orders.read` Retrieves the full details of a single production order by its unique identifier.Read-onlyGet a production order
**Required permission:** `inventory:production-orders.read` Retrieves the full details of a single production order by its unique identifier.
Inputs
productionOrderIdstringrequired- Production Order ID (24-char hex ObjectId)
holdedmcp_get_proforma**Required permission:** `sales:proforms.read` Retrieves the full details of a single proforma invoice by its unique identifier.Read-onlyGet a proforma
**Required permission:** `sales:proforms.read` Retrieves the full details of a single proforma invoice by its unique identifier. The response includes line items, custom fields, pipeline stage, and the source document if the proforma was converted from another document.
Inputs
proformaIdstringrequired- Proforma ID (24-char hex ObjectId)
holdedmcp_get_proforma_attachment**Required permission:** `sales:proforms.read` Downloads a specific attachment from a proforma.Read-onlyGet proforma attachment
**Required permission:** `sales:proforms.read` Downloads a specific attachment from a proforma. The response contains the raw binary content of the file.
Inputs
attachmentIdstringrequired- Attachment identifier (filename)
proformaIdstringrequired- Proforma ID (24-char hex ObjectId)
holdedmcp_get_proforma_pdf**Required permission:** `sales:proforms.read` Downloads the proforma invoice as a PDF file.Read-onlyGet proforma PDF
**Required permission:** `sales:proforms.read` Downloads the proforma invoice as a PDF file. The response Content-Type is `application/pdf`. The PDF reflects the current state of the proforma.
Inputs
proformaIdstringrequired- Proforma ID (24-char hex ObjectId)
holdedmcp_get_project**Required permission:** `projects:projects.read` Returns a single project by its ID.Read-onlyGet a project
**Required permission:** `projects:projects.read` Returns a single project by its ID.
Inputs
projectIdstringrequired- Project ID
holdedmcp_get_project_summary**Required permission:** `projects:projects.read` Returns the summary of a project by its ID.Read-onlyGet a project summary
**Required permission:** `projects:projects.read` Returns the summary of a project by its ID.
Inputs
projectIdstringrequired- Project ID
holdedmcp_get_project_time**Required permission:** `projects:projects.read` Returns a single project time tracking entry by its ID.Read-onlyGet a project time entry
**Required permission:** `projects:projects.read` Returns a single project time tracking entry by its ID.
Inputs
projectIdstringrequired- Project ID
timeIdstringrequired- Project time entry ID
holdedmcp_get_purchase**Required permission:** `accounting:purchases.read` Retrieves the full details of a single purchase invoice by its unique identifier.Read-onlyGet a purchase
**Required permission:** `accounting:purchases.read` Retrieves the full details of a single purchase invoice by its unique identifier. The response includes line items, payment status and breakdown, custom fields, and the source document if the purchase was created from a purchase order.
Inputs
purchaseIdstringrequired- Purchase ID (24-char hex ObjectId)
holdedmcp_get_purchase_attachment**Required permission:** `accounting:purchases.read` Downloads a specific attachment from a purchase.Read-onlyGet purchase attachment
**Required permission:** `accounting:purchases.read` Downloads a specific attachment from a purchase. The response contains the raw binary content of the file.
Inputs
attachmentIdstringrequired- Attachment identifier (filename)
purchaseIdstringrequired- Purchase ID (24-char hex ObjectId)
holdedmcp_get_purchase_order**Required permission:** `inventory:purchase-orders.read` Retrieves the full details of a single purchase order by its unique identifier.Read-onlyGet a purchase order
**Required permission:** `inventory:purchase-orders.read` Retrieves the full details of a single purchase order by its unique identifier. The response includes line items, delivery tracking information, custom fields, and pipeline stage.
Inputs
purchaseOrderIdstringrequired- Purchase Order ID (24-char hex ObjectId)
holdedmcp_get_purchase_order_attachment**Required permission:** `inventory:purchase-orders.read` Downloads a specific attachment from a purchase order.Read-onlyGet purchase order attachment
**Required permission:** `inventory:purchase-orders.read` Downloads a specific attachment from a purchase order. The response contains the raw binary content of the file.
Inputs
attachmentIdstringrequired- Attachment identifier (filename)
purchaseOrderIdstringrequired- Purchase Order ID (24-char hex ObjectId)
holdedmcp_get_purchase_order_pdf**Required permission:** `inventory:purchase-orders.read` Downloads the purchase order as a PDF file.Read-onlyGet purchase order PDF
**Required permission:** `inventory:purchase-orders.read` Downloads the purchase order as a PDF file. The response Content-Type is `application/pdf`.
Inputs
purchaseOrderIdstringrequired- Purchase Order ID (24-char hex ObjectId)
holdedmcp_get_purchase_order_received_items**Required permission:** `inventory:purchase-orders.read` Returns the items that have already been received for this purchase order.Read-onlyGet received items for a purchase order
**Required permission:** `inventory:purchase-orders.read` Returns the items that have already been received for this purchase order. The response includes received quantities and pending quantities for each line item, so you can track receipt progress.
Inputs
purchaseOrderIdstringrequired- Purchase Order ID (24-char hex ObjectId)
holdedmcp_get_purchase_refund**Required permission:** `accounting:purchases.read` Retrieves the full details of a single purchase refund (compra rectificativa) by its unique identifier.Read-onlyGet a purchase refund
**Required permission:** `accounting:purchases.read` Retrieves the full details of a single purchase refund (compra rectificativa) by its unique identifier. The response includes line items, payment status and breakdown, custom fields, and the source purchase document if the refund was created from an existing purchase.
Inputs
purchaseRefundIdstringrequired- Purchase Refund ID (24-char hex ObjectId)
holdedmcp_get_purchase_shipment**Required permission:** `inventory:purchase-shipments.read` Retrieves the full details of a single purchase shipment by its unique identifier.Read-onlyGet a purchase shipment
**Required permission:** `inventory:purchase-shipments.read` Retrieves the full details of a single purchase shipment by its unique identifier. The response includes line items, custom fields, and warehouse information.
Inputs
purchaseShipmentIdstringrequired- Purchase Shipment ID (24-char hex ObjectId)
holdedmcp_get_receipt_note**Required permission:** `sales:invoices.read` Retrieves the full details of a single receipt note by its unique identifier.Read-onlyGet a receipt note
**Required permission:** `sales:invoices.read` Retrieves the full details of a single receipt note by its unique identifier. The response includes line items, payment status and breakdown, custom fields, and the source document if the receipt note was created from a sales receipt.
Inputs
receiptNoteIdstringrequired- Receipt Note ID (24-char hex ObjectId)
holdedmcp_get_receipt_note_attachment**Required permission:** `sales:invoices.read` Downloads a specific attachment from a receipt note.Read-onlyGet receipt note attachment
**Required permission:** `sales:invoices.read` Downloads a specific attachment from a receipt note. The response contains the raw binary content of the file.
Inputs
attachmentIdstringrequired- Attachment identifier (filename)
receiptNoteIdstringrequired- Receipt Note ID (24-char hex ObjectId)
holdedmcp_get_receipt_note_pdf**Required permission:** `sales:invoices.read` Downloads the receipt note as a PDF file.Read-onlyGet receipt note PDF
**Required permission:** `sales:invoices.read` Downloads the receipt note as a PDF file. The response Content-Type is `application/pdf`. The PDF is generated using the template configured in your account settings.
Inputs
receiptNoteIdstringrequired- Receipt Note ID (24-char hex ObjectId)
holdedmcp_get_recurring_schedule**Required permission:** `sales:invoices.read` Returns the occurrence schedule for a recurring invoice, including past converted, skipped, and future pending dates.Read-onlyGet recurring invoice schedule
**Required permission:** `sales:invoices.read` Returns the occurrence schedule for a recurring invoice, including past converted, skipped, and future pending dates.
Inputs
invoiceRecurringIdstringrequired- Recurring invoice ID (24-char hex ObjectId)
untilstring- Upper date boundary (YYYY-MM-DD). Defaults to one year from today.
holdedmcp_get_remittance**Required permission:** `accounting:remittances.read` Retrieves the full details of a remittance by its unique identifier.Read-onlyGet a remittance
**Required permission:** `accounting:remittances.read` Retrieves the full details of a remittance by its unique identifier. A remittance groups multiple invoices or purchases into a single SEPA direct debit or credit transfer for batch processing. The response includes the list of documents bundled in the remittance, each with its contact, amount, and payment status.
Inputs
remittanceIdstringrequired- Remittance ID
holdedmcp_get_sales_channel**Required permission:** `sales:sales-channels.read` Retrieves the details of a single sales channel by its unique identifier.Read-onlyGet a sales channel by ID
**Required permission:** `sales:sales-channels.read` Retrieves the details of a single sales channel by its unique identifier. The response includes the channel name, color, accounting number, and archived status.
Inputs
salesChannelIdstringrequired- Sales Channel ID (24-char hex ObjectId)
holdedmcp_get_sales_order**Required permission:** `inventory:sales-orders.read` Retrieves the full details of a single sales order by its unique identifier.Read-onlyGet a sales order
**Required permission:** `inventory:sales-orders.read` Retrieves the full details of a single sales order by its unique identifier. The response includes line items, shipping tracking information, custom fields, pipeline stage, and shipped item quantities.
Inputs
salesOrderIdstringrequired- Sales Order ID (24-char hex ObjectId)
holdedmcp_get_sales_order_attachment**Required permission:** `inventory:sales-orders.read` Downloads a specific attachment from a sales order.Read-onlyGet sales order attachment
**Required permission:** `inventory:sales-orders.read` Downloads a specific attachment from a sales order. The response contains the raw binary content of the file.
Inputs
attachmentIdstringrequired- Attachment identifier (filename)
salesOrderIdstringrequired- Sales Order ID (24-char hex ObjectId)
holdedmcp_get_sales_order_pdf**Required permission:** `inventory:sales-orders.read` Downloads the sales order as a PDF file.Read-onlyGet sales order PDF
**Required permission:** `inventory:sales-orders.read` Downloads the sales order as a PDF file. The response Content-Type is `application/pdf`.
Inputs
salesOrderIdstringrequired- Sales Order ID (24-char hex ObjectId)
holdedmcp_get_sales_order_shipped_items**Required permission:** `inventory:sales-orders.read` Returns the items that have already been shipped for this sales order.Read-onlyGet shipped items for a sales order
**Required permission:** `inventory:sales-orders.read` Returns the items that have already been shipped for this sales order. The response includes shipped quantities and dates for each line item, so you can track fulfillment progress.
Inputs
salesOrderIdstringrequired- Sales Order ID (24-char hex ObjectId)
holdedmcp_get_sales_receipt**Required permission:** `sales:receipts.read` Retrieves the full details of a single sales receipt by its unique identifier.Read-onlyGet a sales receipt
**Required permission:** `sales:receipts.read` Retrieves the full details of a single sales receipt by its unique identifier. The response includes line items, payment status and breakdown, custom fields, and pipeline stage.
Inputs
salesReceiptIdstringrequired- Sales Receipt ID (24-char hex ObjectId)
holdedmcp_get_sales_receipt_attachment**Required permission:** `sales:receipts.read` Downloads a specific attachment from a sales receipt.Read-onlyGet sales receipt attachment
**Required permission:** `sales:receipts.read` Downloads a specific attachment from a sales receipt. The response contains the raw binary content of the file.
Inputs
attachmentIdstringrequired- Attachment identifier (filename)
salesReceiptIdstringrequired- Sales Receipt ID (24-char hex ObjectId)
holdedmcp_get_sales_receipt_pdf**Required permission:** `sales:receipts.read` Downloads the sales receipt as a PDF file.Read-onlyGet sales receipt PDF
**Required permission:** `sales:receipts.read` Downloads the sales receipt as a PDF file. The response Content-Type is `application/pdf`.
Inputs
salesReceiptIdstringrequired- Sales Receipt ID (24-char hex ObjectId)
holdedmcp_get_service**Required permission:** `sales:services.read` Retrieves the full details of a single service by its unique identifier.Read-onlyGet a service
**Required permission:** `sales:services.read` Retrieves the full details of a single service by its unique identifier. The response includes pricing, tax configuration, sales channel assignment, and duration.
Inputs
serviceIdstringrequired- Service ID (24-char hex ObjectId)
holdedmcp_get_task**Required permission:** `projects:projects.read` Returns a single task by its ID.Read-onlyGet a task
**Required permission:** `projects:projects.read` Returns a single task by its ID.
Inputs
taskIdstringrequired- Task ID
holdedmcp_get_tax_per_country_sorted_keys**Required permission:** `accounting:taxes.read` Returns the ordered list of tax keys applicable for a given country and ecommerce section.Read-onlyGet sorted tax keys by country and section
**Required permission:** `accounting:taxes.read` Returns the ordered list of tax keys applicable for a given country and ecommerce section. Combines default country rules with section-specific overrides.
Inputs
countrystringrequired- ISO 3166-1 alpha-2 country code (e.g. ES, FR, DE)
sectionstring- Ecommerce section (all|shopify|prestashop|woocommerce|amazon|wix|stripe). Defaults to "all" when omitted.default
all
holdedmcp_get_usage**Required permission:** `developers:usage.read` Returns the current month API usage for the API.Read-onlyGet API usage (automation token)
**Required permission:** `developers:usage.read` Returns the current month API usage for the API.
Inputs
This tool takes no inputs.
holdedmcp_get_usage_by_type**Required permission:** `developers:usage.read` Returns the current month API usage for the given type.Read-onlyGet API usage by type
**Required permission:** `developers:usage.read` Returns the current month API usage for the given type.
Inputs
typestringrequired- Usage type identifierone of
automation_tokendigital_signatureai_banking_rule_suggestionllm_tokens
holdedmcp_get_warehouse**Required permission:** `inventory:warehouses.read` Retrieves the details of a single warehouse by its unique identifier.Read-onlyGet a warehouse by ID
**Required permission:** `inventory:warehouses.read` Retrieves the details of a single warehouse by its unique identifier. The response includes the warehouse name, contact information, address, and whether it is the default warehouse.
Inputs
warehouseIdstringrequired- Warehouse ID (24-char hex ObjectId)
holdedmcp_get_warehouse_stock**Required permission:** `inventory:warehouses.read` Returns the stock levels for all products stored in a specific warehouse.Read-onlyGet stock levels for a warehouse
**Required permission:** `inventory:warehouses.read` Returns the stock levels for all products stored in a specific warehouse. The response includes each product's ID, variant ID (if applicable), and current stock quantity. Use this endpoint to audit inventory or synchronize stock with external systems.
Inputs
warehouseIdstringrequired- Warehouse ID (24-char hex ObjectId)
holdedmcp_get_waybill**Required permission:** `inventory:shipments.read` Retrieves the full details of a single waybill by its unique identifier.Read-onlyGet a waybill
**Required permission:** `inventory:shipments.read` Retrieves the full details of a single waybill by its unique identifier. The response includes line items, shipping tracking information, custom fields, and pipeline stage.
Inputs
waybillIdstringrequired- Waybill ID (24-char hex ObjectId)
holdedmcp_get_waybill_attachment**Required permission:** `inventory:shipments.read` Downloads a specific attachment from a waybill.Read-onlyGet waybill attachment
**Required permission:** `inventory:shipments.read` Downloads a specific attachment from a waybill. The response contains the raw binary content of the file.
Inputs
attachmentIdstringrequired- Attachment identifier (filename)
waybillIdstringrequired- Waybill ID (24-char hex ObjectId)
holdedmcp_get_waybill_pdf**Required permission:** `inventory:shipments.read` Downloads the waybill as a PDF file.Read-onlyGet waybill PDF
**Required permission:** `inventory:shipments.read` Downloads the waybill as a PDF file. The response Content-Type is `application/pdf`.
Inputs
waybillIdstringrequired- Waybill ID (24-char hex ObjectId)
holdedmcp_get_webhook**Required permission:** `developers:webhooks.read` Retrieves a webhook by its unique identifier.Read-onlyGet a webhook
**Required permission:** `developers:webhooks.read` Retrieves a webhook by its unique identifier.
Inputs
webhookIdstringrequired- Webhook ID
holdedmcp_get_webhook_events**Required permission:** `developers:webhooks.read` Returns all supported webhook event types grouped by domain.Read-onlyList supported webhook event types
**Required permission:** `developers:webhooks.read` Returns all supported webhook event types grouped by domain.
Inputs
This tool takes no inputs.
holdedmcp_list_accounting_accounts**Required permission:** `accounting:chart-of-accounts.read` Returns the list of all accounting accounts in your chart of accounts.Read-onlyList chart of accounts
**Required permission:** `accounting:chart-of-accounts.read` Returns the list of all accounting accounts in your chart of accounts. The response includes each account's number, name, and group. Use this endpoint to discover available accounts before creating ledger entries.
Inputs
archivedboolean- Include archived accounts when true
end_datestring- Filter accounts with activity up to this date (YYYY-MM-DD)
include_emptyboolean- Include accounts with no transactions when true
start_datestring- Filter accounts with activity from this date (YYYY-MM-DD)
textstring- Case-insensitive partial search on account name or number
holdedmcp_list_all_employee_times**Required permission:** `team:time-tracking.read` Returns a paginated list of all employee time tracking entries for the account.Read-onlyList all employee time entries
**Required permission:** `team:time-tracking.read` Returns a paginated list of all employee time tracking entries for the account. Results are cursor-paginated: the response includes a `cursor` value and a `has_more` boolean. Pass the `cursor` to the next request to fetch the following page. Default page size is 50, configurable up to 200.
Inputs
cursorstring- Opaque cursor for pagination. Use the value returned in the previous response to fetch the next page.
limitinteger- Maximum number of items to returndefault
50
holdedmcp_list_all_project_times**Required permission:** `projects:projects.read` Returns a paginated list of the project time tracking entries of the account, across every project the caller can see.Read-onlyList all project time entries
**Required permission:** `projects:projects.read` Returns a paginated list of the project time tracking entries of the account, across every project the caller can see. Without `startDate`, only entries from the 18 months before `endDate` (or before today) are returned; without `endDate`, entries dated after now are left out. Results are paginated with `limit` and `cursor` parameters. Default page size is 50, configurable up to 200.
Inputs
cursorstring- Pagination cursor returned by the previous response. Omit to start from the first page.
employee_idstring- Filter by employee: only the entries logged by the employee's linked user are returned, and an employee with no linked user has none. Takes an employee id, not a user id (neither an entry's `user_id` nor an employee's `holded_user_id`). An id that is not an employee of the account returns 404.
endDatestring- Filter entries on or before this date (ISO 8601, YYYY-MM-DD)
limitinteger- Maximum number of items to returndefault
50 startDatestring- Filter entries on or after this date (ISO 8601, YYYY-MM-DD)
holdedmcp_list_banking_account_bank_movements**Required permission:** `accounting:banks.read` Returns a cursor-paginated list of raw bank movements for a banking account, with the bank-reported amount, balance after the movement, value date and reconciliation status.Read-onlyList banking account movements
**Required permission:** `accounting:banks.read` Returns a cursor-paginated list of raw bank movements for a banking account, with the bank-reported amount, balance after the movement, value date and reconciliation status. Use this endpoint to build reconciliation flows, cash-flow analysis, balance alerts or banking dashboards. Unlike Payment records (available at `/api/v2/payments`), which link bank movements to invoices and documents, this endpoint exposes the raw entries that come from the bank statement. Results are ordered by value date descending (then by id descending to break ties). Returns an empty list for cash-type accounts (their movements live in the ledger, not the bank statement) — use `GET /api/v2/treasury/accounts/{id}/cash-movements` instead.
Inputs
idstringrequired- Banking account identifier
cursorstring- Opaque cursor returned by the previous page
end_datestring- Inclusive upper bound on the movement value date (ISO 8601 date or date-time)
limitinteger- Maximum number of movements per page. Defaults to 50, maximum 200.default
50 start_datestring- Inclusive lower bound on the movement value date (ISO 8601 date or date-time)
statusarray- Reconciliation statuses to filter by: 'pending' (not reconciled), 'reconciled' (fully matched), 'partial' (partially matched), 'forced_reconciled' (manually marked).
holdedmcp_list_banking_account_cash_movements**Required permission:** `accounting:banks.read` Returns a cursor-paginated list of ledger entries for a cash-type banking account.Read-onlyList banking account cash movements
**Required permission:** `accounting:banks.read` Returns a cursor-paginated list of ledger entries for a cash-type banking account. Use this endpoint to list cash register movements — entries created manually or automatically from payments linked to a cash account. This endpoint only works for accounts of type cash; for bank, card, or gateway accounts use `/api/v2/treasury/accounts/{id}/bank-movements` instead (which returns raw bank-statement entries from providers).
Inputs
idstringrequired- Banking account identifier
cursorstring- Opaque cursor returned by the previous page
end_datestring- Inclusive upper bound on the movement accounting date (ISO 8601 date or date-time)
limitinteger- Maximum number of movements per page. Defaults to 50, maximum 200.default
50 start_datestring- Inclusive lower bound on the movement accounting date (ISO 8601 date or date-time)
holdedmcp_list_banking_accounts**Required permission:** `accounting:banks.read` Returns a cursor-paginated list of banking accounts in your account.Read-onlyList banking accounts
**Required permission:** `accounting:banks.read` Returns a cursor-paginated list of banking accounts in your account. Use `archived=true` to retrieve only archived accounts, `archived=false` for only active accounts, or omit the parameter to return both. Use the `cursor` returned by `ApiListResponse` to fetch the next page; `limit` defaults to the standard list page size and is capped at the API-wide maximum.
Inputs
archivedboolean- Filter by archived state. `true` returns only archived accounts, `false` returns only active accounts. Omit to return both (default).
cursorstring- Opaque cursor for pagination
limitinteger- Maximum number of banking accounts to return per pagedefault
50 typestring- Filter banking accounts by account type. Allowed values: `bank` (bank account), `card` (credit or debit card), `gateway` (payment gateway such as Stripe or PayPal), `cash` (cash register / petty cash).one of
bankcardgatewaycash
holdedmcp_list_booking_locations**Required permission:** `crm:booking-services.read` Returns all booking locations for your account.Read-onlyList all booking locations
**Required permission:** `crm:booking-services.read` Returns all booking locations for your account. Locations are not paginated — all are returned in a single response.
Inputs
This tool takes no inputs.
holdedmcp_list_bookings**Required permission:** `crm:booking-services.read` Returns a paginated list of bookings for your account.Read-onlyList all bookings
**Required permission:** `crm:booking-services.read` Returns a paginated list of bookings for your account. Results are cursor-paginated: the response includes a `cursor` value and a `has_more` boolean. Default page size is 50, configurable up to 200 with `limit`. You can filter by date range and service. To query bookings for a single day pass the same date for both `start_date` and `end_date` (e.g. `start_date=2024-01-15&end_date=2024-01-15`). A date-only value for `end_date` automatically includes the full day up to 23:59:59. When `items` is an empty array and `has_more` is false, there are no bookings matching the given criteria — this is a definitive result, do not retry with different parameters.
Inputs
cursorstring- Opaque cursor for pagination
end_datestring- Filter bookings up to this date (inclusive). Accepts ISO 8601 datetime (e.g. 2024-12-31T23:59:59+00:00) or date only (e.g. 2024-12-31). A date-only value includes the full day up to 23:59:59.
limitinteger- Number of items per pagedefault
50 service_idstring- Filter by service identifier
sort_fieldstring- Field to sort byone of
start_timecreated_at sort_orderstring- Sort directionone of
ascdesc start_datestring- Filter bookings starting from this date. Accepts ISO 8601 datetime (e.g. 2024-01-01T00:00:00+00:00) or date only (e.g. 2024-01-01)
holdedmcp_list_business_plan_goals**Required permission:** `accounting:cashflow.read` Returns Business Plan goals for the authenticated account, one row per accounting account, broken down by month.Read-onlyList business plan goals vs actuals
**Required permission:** `accounting:cashflow.read` Returns Business Plan goals for the authenticated account, one row per accounting account, broken down by month. Each month carries both the `goal` (the target the account set for itself) and the `actual` (what really happened, from the ledger) for the same period, so goal and reality can be compared without a second call. Use when the user wants to compare a client's Business Plan targets against what actually happened, e.g. to prepare a monthly review. Only `tree=profit_and_loss` is supported today; Cashflow goals are not available through this endpoint yet. `start_date` must not be after `end_date`, and the range between them must not exceed 36 months. Returns an empty list, not an error, when the account has no Business Plan configured or no goals exist in the requested range.
Inputs
end_datestringrequired- End of the reporting range (inclusive — any day within the last desired month)
start_datestringrequired- Start of the reporting range (inclusive, snapped to the first day of its month)
treestringrequired- Goal tree to query. Only "profit_and_loss" is supported today.one of
profit_and_loss accounting_account_idstring- Restrict the response to a single accounting account. Omit to return every account in the tree.
cursorstring- Opaque cursor for pagination
limitinteger- Maximum number of accounting accounts to return per page. Defaults to 50, maximum 200.default
50 only_with_goalsboolean- When true, excludes accounting accounts with no goal set anywhere in the requested range. Without it, a chart of accounts with few goals mostly returns rows with goal: null — this filters those out before pagination, so pages are not spent on empty accounts.default
false scenario_idstring- Business Plan scenario to query — see GET /api/v2/business-plan/scenarios. Defaults to the account's main scenario.
holdedmcp_list_business_plan_scenarios**Required permission:** `accounting:cashflow.read` Returns the Business Plan scenarios configured for the authenticated account.Read-onlyList business plan scenarios
**Required permission:** `accounting:cashflow.read` Returns the Business Plan scenarios configured for the authenticated account. A Business Plan can hold several scenarios, each with its own goals; use the returned `id` as `scenario_id` when calling the goals endpoint. Use when the user asks which business plan scenarios exist, or before requesting goals for a scenario other than the main one. Returns an empty list, not an error, when the account has no Business Plan configured yet.
Inputs
This tool takes no inputs.
holdedmcp_list_contact_attachments**Required permission:** `contacts:contacts.read` Returns the list of file names attached to a contact.Read-onlyList contact attachments
**Required permission:** `contacts:contacts.read` Returns the list of file names attached to a contact. Each item is a plain file name string (e.g. `invoice.pdf`). Use the file name to download individual files via the Get attachment endpoint.
Inputs
contactIdstringrequired- Contact ID (24-char hex ObjectId)
holdedmcp_list_contact_groups**Required permission:** `contacts:contacts.read` Returns a paginated list of contact groups.Read-onlyList contact groups
**Required permission:** `contacts:contacts.read` Returns a paginated list of contact groups. Results are cursor-paginated: the response includes a `cursor` value and a `has_more` boolean. Pass the `cursor` to the next request to fetch the following page.
Inputs
cursorstring- Pagination cursor returned by the previous response. Omit to start from the first page.
limitinteger- Maximum number of items to returndefault
50
holdedmcp_list_contact_shipping_addresses**Required permission:** `contacts:contacts.read` Returns the shipping addresses of a contact.Read-onlyList the shipping addresses of a contact
**Required permission:** `contacts:contacts.read` Returns the shipping addresses of a contact. Each one carries the `shipping_id` that identifies it.
Inputs
contactIdstringrequired- Contact ID (24-char hex ObjectId)
holdedmcp_list_contacts**Required permission:** `contacts:contacts.read` Returns a paginated list of contacts in your account.Read-onlyList contacts
**Required permission:** `contacts:contacts.read` Returns a paginated list of contacts in your account. You can filter by `phone`, `mobile`, `email`, `code`, or `custom_id` to find specific contacts. All filters use exact matching. Results are cursor-paginated: the response includes a `cursor` value and a `has_more` boolean. Pass the `cursor` to the next request to fetch the following page. The default page size is 25 contacts. You can increase it up to 100 using the `limit` parameter.
Inputs
codestring- Filter contacts by exact tax identification number (NIF/CIF)
cursorstring- Opaque cursor for pagination. Use the value returned in the previous response to fetch the next page.
custom_idstring- Filter contacts by your external reference identifier
emailstring- Filter contacts by exact email address match
limitinteger- Maximum number of contacts to return per page. Defaults to 25, maximum 100.default
50 mobilestring- Filter contacts by exact mobile number match
phonestring- Filter contacts by exact phone number match
holdedmcp_list_credit_note_attachments**Required permission:** `sales:invoices.read` Returns the list of files attached to a credit note.Read-onlyList credit note attachments
**Required permission:** `sales:invoices.read` Returns the list of files attached to a credit note. Each attachment includes its identifier, file name, and size.
Inputs
creditNoteIdstringrequired- Credit Note ID (24-char hex ObjectId)
holdedmcp_list_credit_notes**Required permission:** `sales:invoices.read` Returns a paginated list of credit notes in your account.Read-onlyList credit notes
**Required permission:** `sales:invoices.read` Returns a paginated list of credit notes in your account. Results are cursor-paginated: the response includes a `cursor` value and a `has_more` boolean. Pass the `cursor` to the next request to fetch the following page.
Inputs
approval_statusstring- Filter by approval status. Use "draft" for unapproved credit notes, "approved" for approved ones.one of
draftapproved contact_idstring- Filter credit notes by contact identifier
cursorstring- Pagination cursor returned by the previous response. Omit to start from the first page.
end_datestring- Return only credit notes issued on or before this date. Accepts ISO 8601 datetime (e.g. 2026-12-31T23:59:59+00:00) or date only (e.g. 2026-12-31). A date without a time (YYYY-MM-DD) includes that whole day; a value with a time is applied exactly as sent.
limitinteger- Maximum number of credit notes to return per page. Defaults to 50, maximum 200.default
50 sortstring- Sort order for results. Prefix with - for descending.one of
date-datedueDate-dueDatetotal-total start_datestring- Return only credit notes issued on or after this date. Accepts ISO 8601 datetime (e.g. 2026-01-01T00:00:00+00:00) or date only (e.g. 2026-01-01)
statusstring- Filter credit notes by payment status. "pending" matches credit notes with no payment recorded and "partial" those paid in part; both still owe a balance. "outstanding" returns the two together, and "overdue" narrows that set to a due date already past.one of
pendingcompletedpartialcancelledfailedoverdueoutstanding
holdedmcp_list_employee_times**Required permission:** `team:time-tracking.read` Returns a paginated list of time tracking entries for a specific employee.Read-onlyList time entries for an employee
**Required permission:** `team:time-tracking.read` Returns a paginated list of time tracking entries for a specific employee. Results are cursor-paginated: the response includes a `cursor` value and a `has_more` boolean. Pass the `cursor` to the next request to fetch the following page.
Inputs
employeeIdstringrequired- Employee ID
cursorstring- Opaque cursor for pagination. Use the value returned in the previous response to fetch the next page.
endDatestring- Filter entries starting on or before this date (ISO 8601, YYYY-MM-DD)
limitinteger- Maximum number of items to returndefault
50 startDatestring- Filter entries starting on or after this date (ISO 8601, YYYY-MM-DD)
holdedmcp_list_employees**Required permission:** `team:employees.read` Returns a paginated list of employees.Read-onlyList all employees
**Required permission:** `team:employees.read` Returns a paginated list of employees. Results are paginated with `limit` and `cursor` parameters. Default page size is 50, configurable up to 200. When resolving an employee the user named, match against BOTH first name and surname, accent- and case-insensitively, and gather ALL matches — never stop at the first result. If more than one employee matches, present the complete list of matches (name plus email or employee code) and let the user choose; never pick one on your own.
Inputs
cursorstring- Pagination cursor returned by the previous response. Omit to start from the first page.
limitinteger- Maximum number of items to returndefault
50 searchstring- Server-side free-text filter over name, surname, email and code, ignoring case and accents (e.g. "pablo diaz" matches "Pablo Díaz"). ALWAYS use this parameter to resolve an employee the user named — pass the user's exact text. Do NOT filter by name yourself client-side (jmespath/contains): that only sees the current page and cannot fold accents, so it misses matches and picks the wrong person. This search scans ALL employees and returns every match; if more than one comes back, present them and let the user choose.
holdedmcp_list_estimate_attachments**Required permission:** `sales:estimates.read` Returns the list of files attached to an estimate.Read-onlyList estimate attachments
**Required permission:** `sales:estimates.read` Returns the list of files attached to an estimate. Each attachment includes its identifier, file name, and size. A signed-in user with limited access to estimates only reaches the estimates assigned to them or created by them; any other is reported as not found. API keys still need the scope of this endpoint.
Inputs
estimateIdstringrequired- Estimate ID (24-char hex ObjectId)
holdedmcp_list_estimates**Required permission:** `sales:estimates.read` Returns a paginated list of estimates in your account.Read-onlyList estimates
**Required permission:** `sales:estimates.read` Returns a paginated list of estimates in your account. Results are cursor-paginated: the response includes a `cursor` value and a `has_more` boolean. Pass the `cursor` to the next request to fetch the following page. A signed-in user with limited access to estimates gets only the estimates assigned to them. API keys still need the scope of this endpoint.
Inputs
approval_statusstring- Filter by approval status. Use "draft" for unapproved estimates, "approved" for approved ones.one of
draftapproved billing_statusstring- Filter estimates by their invoicing status (the **Billed** column in Sales > Quotes). Independent of `status`.one of
pendingpaidpartial contact_idstring- Filter estimates by contact identifier
cursorstring- Pagination cursor returned by the previous response. Omit to start from the first page.
end_datestring- Filter up to this date. Accepts ISO 8601 datetime or date only (YYYY-MM-DD). A date without a time (YYYY-MM-DD) includes that whole day; a value with a time is applied exactly as sent.
limitinteger- Maximum number of estimates to return per page. Defaults to 50, maximum 200.default
50 sortstring- Sort order for results. Prefix with - for descending.one of
date-datedueDate-dueDatetotal-total start_datestring- Filter from this date. Accepts ISO 8601 datetime or date only (YYYY-MM-DD)
statusstring- Filter estimates by the customer's decision on the quote: "completed" is shown as **Accepted** in the app, "failed" as **Rejected**, "pending" as awaiting an answer. Independent of `billing_status`.one of
pendingcompletedpartialcancelledfailedoverdue
holdedmcp_list_events**Required permission:** `crm:events.read` Returns a paginated list of CRM events.Read-onlyList all events
**Required permission:** `crm:events.read` Returns a paginated list of CRM events. Results are cursor-paginated: the response includes a `cursor` value and a `has_more` boolean. Default page size is 50, configurable up to 100 with `limit`.
Inputs
cursorstring- Pagination cursor from a previous response
limitinteger- Maximum number of items to returndefault
50
holdedmcp_list_expenses_accounts**Required permission:** `accounting:expenses-accounts.read` Returns the list of all expenses accounts in your account.Read-onlyList all expenses accounts
**Required permission:** `accounting:expenses-accounts.read` Returns the list of all expenses accounts in your account. The response includes both active and archived expenses accounts. Use expenses account IDs when setting defaults on contacts or assigning costs to purchase lines.
Inputs
This tool takes no inputs.
holdedmcp_list_funnels**Required permission:** `crm:funnels.read` Returns a paginated list of funnels.Read-onlyList all funnels
**Required permission:** `crm:funnels.read` Returns a paginated list of funnels. Results are paginated with `limit` and `cursor` parameters. Default page size is 50, configurable up to 200.
Inputs
cursorstring- Pagination cursor returned by the previous response. Omit to start from the first page.
limitinteger- Maximum number of items to returndefault
50
holdedmcp_list_inbox**Required permission:** `inbox:inbox.read` Returns a cursor-paginated list of incoming documents in your inbox.Read-onlyList inbox incoming documents
**Required permission:** `inbox:inbox.read` Returns a cursor-paginated list of incoming documents in your inbox. Optional filters: `status` (comma-separated list of statuses: `new`, `processing`, `error`, `pending_to_verify`, `done`, `rejected`), `start_date`/`end_date` (ISO 8601 date range on creation date), `user_id` (comma-separated user IDs). Results are ordered by creation date descending (newest first). Pass `cursor` from the previous response to fetch the next page.
Inputs
cursorstring- Opaque pagination cursor from the previous response
end_datestring- Filter documents created on or before this ISO 8601 date
limitinteger- Number of items per page. Defaults to 50, maximum 200.default
50 start_datestring- Filter documents created on or after this ISO 8601 date
statusstring- Comma-separated statuses to filter by (e.g. pending_to_verify,done)
user_idstring- Comma-separated user IDs to filter by uploader
holdedmcp_list_invoice_attachments**Required permission:** `sales:invoices.read` Returns the list of files attached to an invoice.Read-onlyList invoice attachments
**Required permission:** `sales:invoices.read` Returns the list of files attached to an invoice. Each attachment includes its identifier, file name, and size. Use the attachment ID to download or delete individual files.
Inputs
invoiceIdstringrequired- Invoice ID (24-char hex ObjectId)
holdedmcp_list_invoice_recurrings**Required permission:** `sales:invoices.read` Returns a paginated list of recurring invoices in your account.Read-onlyList recurring invoices
**Required permission:** `sales:invoices.read` Returns a paginated list of recurring invoices in your account. Results are cursor-paginated: the response includes a `cursor` value and a `has_more` boolean. Pass the `cursor` to the next request to fetch the following page.
Inputs
contact_idstring- No description.
cursorstring- Pagination cursor returned by the previous response. Omit to start from the first page.
limitinteger- Maximum number of recurring invoices to return per page. Defaults to 50, maximum 200.default
50
holdedmcp_list_invoices**Required permission:** `sales:invoices.read` Returns a paginated list of invoices in your account.Read-onlyList invoices
**Required permission:** `sales:invoices.read` Returns a paginated list of invoices in your account. Results are cursor-paginated: the response includes a `cursor` value and a `has_more` boolean. Pass the `cursor` to the next request to fetch the following page. The list includes payment summary fields (`payments_total`, `payments_pending`) so you can display outstanding balances without fetching each invoice individually. Payment status: an invoice with no payment recorded is `pending`, one collected in part is `partial`, and both still owe a balance. `status=outstanding` returns the two together; `status=overdue` narrows that set to invoices whose due date has passed. Date parameters (`start_date`, `end_date`) filter by ISSUE date; `due_date_start`/`due_date_end` filter by DUE date; all are optional and unfiltered means the whole account. Use `status=overdue` to list all unpaid invoices (pending or partial) whose due date has passed. All date parameters accept RFC 3339 (e.g. `2026-01-01T00:00:00+00:00`) or date-only (`2026-01-01`).
Inputs
accounting_account_numinteger- Filter invoices that have at least one line booked to this accounting account, identified by its numeric PGC code (e.g. 70000000 for "Ventas de mercaderias"). Only the numeric code is accepted; a non-numeric value returns 400. Returns 404 if no accounting account with that number exists in the tenant. When called through the AI assistant, an account name is resolved to its code automatically before the request reaches this endpoint.
approval_statusstring- Filter by approval status. Use "draft" for unapproved invoices, "approved" for approved ones.one of
draftapproved contact_idstring- Filter invoices by contact identifier
cursorstring- Pagination cursor returned by the previous response. Omit to start from the first page.
due_date_endstring- Filter invoices whose DUE date is on or before this date. Accepts ISO 8601 datetime or date only (e.g. 2026-03-12). A date without a time (YYYY-MM-DD) includes that whole day; a value with a time is applied exactly as sent.
due_date_startstring- Filter invoices whose DUE date is on or after this date. Accepts ISO 8601 datetime or date only (e.g. 2026-01-01).
end_datestring- Filter invoices up to this date. Accepts ISO 8601 datetime (e.g. 2026-12-31T23:59:59+00:00) or date only (e.g. 2026-12-31). A date without a time (YYYY-MM-DD) includes that whole day; a value with a time is applied exactly as sent.
limitinteger- Maximum number of invoices to return per page. Defaults to 50, maximum 200.default
50 sortstring- Sort order for results. Prefix with - for descending.one of
date-datedueDate-dueDatetotal-total start_datestring- Filter invoices from this date. Accepts ISO 8601 datetime (e.g. 2026-01-01T00:00:00+00:00) or date only (e.g. 2026-01-01)
statusstring- Filter invoices by payment status. "pending" matches invoices with no payment recorded and "partial" those collected in part; both still owe a balance. "outstanding" returns the two together, "overdue" narrows that set to a due date already past, and "completed" returns the settled ones.one of
pendingcompletedpartialcancelledfailedoverdueoutstanding
holdedmcp_list_invoicing_forecasts**Required permission:** `accounting:cashflow.read` Returns a cursor-paginated list of invoicing forecasts for the authenticated account.Read-onlyList invoicing forecasts
**Required permission:** `accounting:cashflow.read` Returns a cursor-paginated list of invoicing forecasts for the authenticated account. Each forecast represents a scheduled payment milestone linked to an estimate or purchase order. Use when the user asks to list, search or browse cashflow invoicing forecasts, optionally filtered by the source document. Distinct from the Remittances endpoint: invoicing forecasts model future payment milestones on open documents, not batch SEPA transfers.
Inputs
cursorstring- Opaque cursor for pagination
document_idstring- Filter by the related estimate or purchase order identifier
document_typestring- Filter by related document typeone of
estimateorder limitinteger- Maximum number of forecasts to return per page. Defaults to 50, maximum 200.default
50
holdedmcp_list_leads**Required permission:** `crm:deals.read` Returns a paginated list of leads.Read-onlyList all leads
**Required permission:** `crm:deals.read` Returns a paginated list of leads. Results are paginated with `limit` and `cursor` parameters. Default page size is 50, configurable up to 200.
Inputs
cursorstring- Pagination cursor returned by the previous response. Omit to start from the first page.
limitinteger- Maximum number of items to returndefault
50
holdedmcp_list_ledger_entries**Required permission:** `accounting:daily-ledger.read` Returns a paginated list of ledger entries in your accounting books.Read-onlyList ledger entries
**Required permission:** `accounting:daily-ledger.read` Returns a paginated list of ledger entries in your accounting books. Results are cursor-paginated: the response includes a `cursor` value and a `has_more` boolean. Default page size is 50, configurable up to 200 with `limit`.
Inputs
end_datestringrequired- Filter entries up to and including this date
start_datestringrequired- Filter entries from this date onward
accountinteger- Filter entries by accounting account number (e.g. 70500001). Returns only entries posted to this exact account.
cursorstring- Opaque cursor for pagination
limitinteger- Maximum number of ledger entries to return per page. Defaults to 50, maximum 200.default
50
holdedmcp_list_numbering_series**Required permission:** `sales:invoicing-settings.read` Returns the list of all numbering series configured in your account, grouped by document type.Read-onlyList numbering series by document type
**Required permission:** `sales:invoicing-settings.read` Returns the list of all numbering series configured in your account, grouped by document type. Use this endpoint to discover available series before creating documents with a specific `number_line_id`.
Inputs
typestringrequired- Document type for the numbering seriesone of
invoicesalesreceiptcreditnoteestimateproformwaybillsalesorderpurchasepurchaserefundorderpurchaseshipmentreceiptnoteproductionorder
holdedmcp_list_payment_methods**Required permission:** `sales:invoicing-settings.read` Returns all payment methods configured for the account, including both manual methods (bank transfer, cash on delivery, cheque) and online connected providers (Stripe, PayPal, GoCardless, Square, Monei, Wallet).Read-onlyList payment methods
**Required permission:** `sales:invoicing-settings.read` Returns all payment methods configured for the account, including both manual methods (bank transfer, cash on delivery, cheque) and online connected providers (Stripe, PayPal, GoCardless, Square, Monei, Wallet). Use when the user asks which payment methods they have set up or how they collect payments from customers. Different from the payments endpoint which returns individual transactions — this returns the configured methods themselves. A signed-in user who can write estimates reads them too, as the estimate editor shows them every payment method. API keys still need the scope of this endpoint.
Inputs
cursorstring- Opaque cursor for pagination. Pass the value returned in the previous response to fetch the next page.
limitinteger- Maximum number of payment methods to return per page. Defaults to 50, maximum 200.default
50
holdedmcp_list_payments**Required permission:** `accounting:payments.read` Lists the money received (cobros) and paid out (pagos) recorded in the account, newest first, with its date, amount, banking account and the document it settles.Read-onlyList payments and collections
**Required permission:** `accounting:payments.read` Lists the money received (cobros) and paid out (pagos) recorded in the account, newest first, with its date, amount, banking account and the document it settles. Use it when the user asks about a collection or a payment, e.g. "show me the last collection" (último cobro) or "payments made this month" (pagos de este mes): pass `type` collection or payment, and narrow by dates, banking account or document. Not the payment methods configured in the account (métodos de pago: transfer, card, cash), which have their own list. It lists recorded movements, not what is still owed: for supplier bills or invoices pending payment, list purchases or invoices with `status=outstanding` and their due dates.
Inputs
banking_account_idstring- Filter payments linked to this banking account
cursorstring- Opaque cursor for pagination
document_idstring- Filter payments linked to this document. Combine with document_type to match a specific document
document_typestring- Filter payments by document type. Can be used alone, or combined with document_id to match a specific document
end_datestring- Filter payments up to this date. Accepts ISO 8601 datetime (e.g. 2024-12-31T23:59:59+00:00) or date only (e.g. 2024-12-31)
limitinteger- Maximum number of payments to return per pagedefault
50 start_datestring- Filter payments from this date onward. Accepts ISO 8601 datetime (e.g. 2024-01-01T00:00:00+00:00) or date only (e.g. 2024-01-01)
typestring- Filter by direction: "collection" for money received (cobro), "payment" for money paid out (pago)one of
collectionpayment
holdedmcp_list_price_lists**Required permission:** `inventory:rates.read` Lists all price lists (rates) of the authenticated account.Read-onlyList price lists
**Required permission:** `inventory:rates.read` Lists all price lists (rates) of the authenticated account.
Inputs
This tool takes no inputs.
holdedmcp_list_product_images**Required permission:** `inventory:products.read` Retrieves the list of all images associated with a product.Read-onlyList product images
**Required permission:** `inventory:products.read` Retrieves the list of all images associated with a product. Each image includes its URL, available sizes (original, large, medium, small, thumbnail), position in the gallery, and description.
Inputs
productIdstringrequired- Product ID (24-char hex ObjectId)
holdedmcp_list_production_orders**Required permission:** `inventory:production-orders.read` Returns a paginated list of production orders in your account.Read-onlyList production orders
**Required permission:** `inventory:production-orders.read` Returns a paginated list of production orders in your account. Results are cursor-paginated: the response includes a `cursor` value and a `has_more` boolean. Pass the `cursor` to the next request to fetch the following page.
Inputs
cursorstring- Pagination cursor returned by the previous response. Omit to start from the first page.
limitinteger- Maximum number of production orders to return per page. Defaults to 50, maximum 200.default
50
holdedmcp_list_products**Required permission:** `inventory:products.read` Returns a cursor-paginated list of products in your catalog.Read-onlyList all products
**Required permission:** `inventory:products.read` Returns a cursor-paginated list of products in your catalog. Default page size is 50, configurable up to 200 with `limit`. Pass the returned `cursor` value to retrieve the next page. Provide `name` to return only products whose name matches, searched across your whole catalog. Pagination works the same way (`cursor` + `limit`).
Inputs
cursorstring- Opaque cursor for pagination
limitinteger- Number of products per page. Defaults to 50, maximum 200.default
50 namestring- Search products by name across your whole catalog. Optional.
holdedmcp_list_proforma_attachments**Required permission:** `sales:proforms.read` Returns the list of files attached to a proforma invoice.Read-onlyList proforma attachments
**Required permission:** `sales:proforms.read` Returns the list of files attached to a proforma invoice. Each attachment includes its identifier, file name, and size.
Inputs
proformaIdstringrequired- Proforma ID (24-char hex ObjectId)
holdedmcp_list_proformas**Required permission:** `sales:proforms.read` Returns a paginated list of proforma invoices in your account.Read-onlyList proformas
**Required permission:** `sales:proforms.read` Returns a paginated list of proforma invoices in your account. Results are cursor-paginated: the response includes a `cursor` value and a `has_more` boolean. Pass the `cursor` to the next request to fetch the following page.
Inputs
contact_idstring- Filter proformas by contact identifier
cursorstring- Pagination cursor returned by the previous response. Omit to start from the first page.
end_datestring- Filter up to this date. Accepts ISO 8601 datetime or date only (YYYY-MM-DD). A date without a time (YYYY-MM-DD) includes that whole day; a value with a time is applied exactly as sent.
limitinteger- Maximum number of proformas to return per page. Defaults to 50, maximum 200.default
50 sortstring- Sort order for results. Prefix with - for descending.one of
date-datedueDate-dueDatetotal-total start_datestring- Filter from this date. Accepts ISO 8601 datetime or date only (YYYY-MM-DD)
statusstring- Filter proformas by statusone of
pendingcompletedpartialcancelledfailedoverdue
holdedmcp_list_project_times**Required permission:** `projects:projects.read` Returns a paginated list of time tracking entries for a specific project.Read-onlyList time entries for a project
**Required permission:** `projects:projects.read` Returns a paginated list of time tracking entries for a specific project. Results are paginated with `limit` and `cursor` parameters.
Inputs
projectIdstringrequired- Project ID
cursorstring- Pagination cursor returned by the previous response. Omit to start from the first page.
employee_idstring- Filter by employee: only the entries logged by the employee's linked user are returned, and an employee with no linked user has none. Takes an employee id, not a user id (neither an entry's `user_id` nor an employee's `holded_user_id`). An id that is not an employee of the account returns 404.
endDatestring- Filter entries on or before this date (ISO 8601, YYYY-MM-DD)
limitinteger- Maximum number of items to returndefault
50 startDatestring- Filter entries on or after this date (ISO 8601, YYYY-MM-DD)
holdedmcp_list_projects**Required permission:** `projects:projects.read` Returns a paginated list of projects.Read-onlyList projects
**Required permission:** `projects:projects.read` Returns a paginated list of projects. Supports filtering by status to retrieve active (in-progress), completed, cancelled, waiting, or budgeted projects. Use `status=active` or `status=in_progress` to list only active projects. Results are paginated with `limit` and `cursor` parameters. Default page size is 50, configurable up to 200.
Inputs
cursorstring- Pagination cursor returned by the previous response. Omit to start from the first page.
limitinteger- Maximum number of items to returndefault
50 statusstring- Filter projects by status. Use "active" or "in_progress" to retrieve only active/in-progress projects.one of
activein_progresscompletedcancelledwaitingbudgeted textstring- Search on the project name, case and accents aside: every word (up to eight) must appear.
holdedmcp_list_purchase_attachments**Required permission:** `accounting:purchases.read` Returns the list of files attached to a purchase invoice.Read-onlyList purchase attachments
**Required permission:** `accounting:purchases.read` Returns the list of files attached to a purchase invoice. Each attachment includes its identifier, file name, and size.
Inputs
purchaseIdstringrequired- Purchase ID (24-char hex ObjectId)
holdedmcp_list_purchase_order_attachments**Required permission:** `inventory:purchase-orders.read` Returns the list of files attached to a purchase order.Read-onlyList purchase order attachments
**Required permission:** `inventory:purchase-orders.read` Returns the list of files attached to a purchase order. Each attachment includes its identifier, file name, and size.
Inputs
purchaseOrderIdstringrequired- Purchase Order ID (24-char hex ObjectId)
holdedmcp_list_purchase_orders**Required permission:** `inventory:purchase-orders.read` Returns a paginated list of purchase orders in your account.Read-onlyList purchase orders
**Required permission:** `inventory:purchase-orders.read` Returns a paginated list of purchase orders in your account. Results are cursor-paginated: the response includes a `cursor` value and a `has_more` boolean. Pass the `cursor` to the next request to fetch the following page.
Inputs
contact_idstring- Filter by contact identifier
cursorstring- Pagination cursor returned by the previous response. Omit to start from the first page.
end_datestring- Return only purchase orders issued on or before this date. Accepts ISO 8601 datetime or date only (YYYY-MM-DD). A date without a time (YYYY-MM-DD) includes that whole day; a value with a time is applied exactly as sent.
limitinteger- Maximum number of purchase orders to return per page. Defaults to 50, maximum 200.default
50 sortstring- Sort field and direction. Prefix with - for descending order.one of
date-datedueDate-dueDatetotal-total start_datestring- Return only purchase orders issued on or after this date. Accepts ISO 8601 datetime or date only (YYYY-MM-DD)
statusstring- Filter by payment statusone of
pendingcompletedpartialcancelledfailedoverdue
holdedmcp_list_purchase_refunds**Required permission:** `accounting:purchases.read` Returns a paginated list of purchase refunds in your account.Read-onlyList purchase refunds
**Required permission:** `accounting:purchases.read` Returns a paginated list of purchase refunds in your account. Results are cursor-paginated: the response includes a `cursor` value and a `has_more` boolean. Pass the `cursor` to the next request to fetch the following page. Results are ordered by creation time, newest first.
Inputs
contact_idstring- Filter by contact identifier
cursorstring- Pagination cursor returned by the previous response. Omit to start from the first page.
end_datestring- Return only purchase refunds issued on or before this date. Accepts ISO 8601 datetime or date only (YYYY-MM-DD). A date without a time (YYYY-MM-DD) includes that whole day; a value with a time is applied exactly as sent.
limitinteger- Maximum number of purchase refunds to return per page. Defaults to 50, maximum 200.default
50 start_datestring- Return only purchase refunds issued on or after this date. Accepts ISO 8601 datetime or date only (YYYY-MM-DD)
statusstring- Filter by payment status. "pending" matches purchase refunds with no payment recorded and "partial" those paid in part; both still owe a balance. "outstanding" returns the two together, "overdue" narrows that set to a due date already past, and "completed" returns the settled ones.one of
pendingcompletedpartialcancelledfailedoverdueoutstanding
holdedmcp_list_purchase_shipments**Required permission:** `inventory:purchase-shipments.read` Returns a paginated list of purchase shipments in your account.Read-onlyList purchase shipments
**Required permission:** `inventory:purchase-shipments.read` Returns a paginated list of purchase shipments in your account. Results are cursor-paginated: the response includes a `cursor` value and a `has_more` boolean. Pass the `cursor` to the next request to fetch the following page.
Inputs
contact_idstring- Filter by contact (supplier) identifier
cursorstring- Pagination cursor returned by the previous response. Omit to start from the first page.
end_datestring- Filter purchase shipments issued on or before this date. Accepts ISO 8601 datetime or date only (YYYY-MM-DD). A date without a time (YYYY-MM-DD) includes that whole day; a value with a time is applied exactly as sent.
limitinteger- Maximum number of purchase shipments to return per page. Defaults to 50, maximum 200.default
50 sortstring- Sort order for results. Prefix with - for descending.one of
date-datedueDate-dueDatetotal-total start_datestring- Filter purchase shipments issued on or after this date. Accepts ISO 8601 datetime or date only (YYYY-MM-DD)
statusstring- Filter by status. "pending" matches purchase shipments with no payment recorded and "partial" those paid in part; both still owe a balance. "outstanding" returns the two together, and "overdue" narrows that set to a due date already past.one of
pendingcompletedpartialcancelledfailedoverdueoutstanding
holdedmcp_list_purchases**Required permission:** `accounting:purchases.read` Returns a paginated list of purchase invoices in your account.Read-onlyList purchases
**Required permission:** `accounting:purchases.read` Returns a paginated list of purchase invoices in your account. Results are cursor-paginated: the response includes a `cursor` value and a `has_more` boolean. Pass the `cursor` to the next request to fetch the following page. Payment status: a purchase with no payment recorded is `pending`, one paid in part is `partial`, and both still owe a balance. `status=outstanding` returns the two together; `status=overdue` narrows that set to purchases whose due date has passed. Date parameters (`start_date`, `end_date`) filter by ISSUE date; `due_date_start`/`due_date_end` filter by DUE date; all are optional and unfiltered means the whole account. `status=overdue` is applied server-side across the whole account and matches pending and partially paid purchases whose due date has passed.
Inputs
approval_statusstring- Filter by approval status. Use "draft" for unapproved purchases, "approved" for approved ones.one of
draftapproved contact_idstring- Filter by contact identifier
cursorstring- Pagination cursor returned by the previous response. Omit to start from the first page.
due_date_endstring- Return only purchases whose DUE date is on or before this date. Combine with status=pending to list overdue purchases (set this to the cut-off date). Accepts ISO 8601 datetime or date only (YYYY-MM-DD). A date without a time (YYYY-MM-DD) includes that whole day; a value with a time is applied exactly as sent.
due_date_startstring- Return only purchases whose DUE date is on or after this date. Accepts ISO 8601 datetime or date only (YYYY-MM-DD).
end_datestring- Return only purchases issued on or before this date. Accepts ISO 8601 datetime or date only (YYYY-MM-DD). A date without a time (YYYY-MM-DD) includes that whole day; a value with a time is applied exactly as sent.
limitinteger- Maximum number of purchases to return per page. Defaults to 50, maximum 200.default
50 sortstring- Sort field and direction. Prefix with - for descending order.one of
date-datedueDate-dueDatetotal-total start_datestring- Return only purchases issued on or after this date. Accepts ISO 8601 datetime or date only (YYYY-MM-DD)
statusstring- Filter by payment status. "pending" matches purchases with no payment recorded and "partial" those paid in part; both still owe a balance. "outstanding" returns the two together, "overdue" narrows that set to a due date already past, and "completed" returns the settled ones.one of
pendingcompletedpartialcancelledfailedoverdueoutstanding
holdedmcp_list_receipt_note_attachments**Required permission:** `sales:invoices.read` Returns the list of files attached to a receipt note.Read-onlyList receipt note attachments
**Required permission:** `sales:invoices.read` Returns the list of files attached to a receipt note. Each attachment includes its identifier, file name, and size.
Inputs
receiptNoteIdstringrequired- Receipt Note ID (24-char hex ObjectId)
holdedmcp_list_receipt_notes**Required permission:** `sales:invoices.read` Returns a paginated list of receipt notes for the account.Read-onlyList receipt notes
**Required permission:** `sales:invoices.read` Returns a paginated list of receipt notes for the account. Use the `cursor` from the response to fetch the next page. Filter by contact, status, or date range.
Inputs
approval_statusstring- Filter by approval status. Use "draft" for unapproved receipt notes, "approved" for approved ones.one of
draftapproved contact_idstring- Filter receipt notes by contact identifier
cursorstring- Pagination cursor returned by the previous response. Omit to start from the first page.
end_datestring- Filter up to this date. Accepts ISO 8601 datetime (e.g. 2026-12-31T23:59:59+00:00) or date only (e.g. 2026-12-31). A date without a time (YYYY-MM-DD) includes that whole day; a value with a time is applied exactly as sent.
limitinteger- Maximum number of receipt notes to return per page. Defaults to 50, maximum 200.default
50 sortstring- Sort order for results. Prefix with - for descending.one of
date-datedueDate-dueDatetotal-total start_datestring- Filter from this date. Accepts ISO 8601 datetime (e.g. 2026-01-01T00:00:00+00:00) or date only (e.g. 2026-01-01)
statusstring- Filter receipt notes by status. "pending" matches receipt notes with no payment recorded and "partial" those paid in part; both still owe a balance. "outstanding" returns the two together, and "overdue" narrows that set to a due date already past.one of
pendingcompletedpartialcancelledfailedoverdueoutstanding
holdedmcp_list_remittances**Required permission:** `accounting:remittances.read` Returns a paginated list of bank remittances for the account, filterable by direction (`type`), processing `status`, date range, treasury bank account, creditor (SWIFT/IBAN/SEPA id) or issuer.Read-onlyList remittances
**Required permission:** `accounting:remittances.read` Returns a paginated list of bank remittances for the account, filterable by direction (`type`), processing `status`, date range, treasury bank account, creditor (SWIFT/IBAN/SEPA id) or issuer. Use when the user asks to list, view, or filter their remittances. This endpoint returns remittance batches only; for individual invoices use the invoices list, and for individual payments not grouped into a remittance use the payments list.
Inputs
bank_idstring- Filter by treasury bank account identifier
creditor_ibanstring- Filter by creditor IBAN
creditor_idstring- Filter by SEPA creditor identifier
creditor_swiftstring- Filter by creditor SWIFT/BIC code (8 or 11 alphanumeric characters)
cursorstring- Opaque cursor for pagination
end_datestring- Inclusive upper bound on the remittance date (ISO 8601 date, e.g. 2026-12-31)
issuer_idstring- Filter by issuer identifier
limitinteger- Maximum number of remittances to return per page. Defaults to 25, maximum 100.default
50 start_datestring- Inclusive lower bound on the remittance date (ISO 8601 date, e.g. 2026-01-01)
statusstring- Filter by processing statusone of
pendingcompletedprocessing typestring- Filter by remittance direction. `inbound` returns collection remittances received from customers. `outbound` returns payment remittances issued to suppliers.one of
inboundoutbound
holdedmcp_list_sales_channels**Required permission:** `sales:sales-channels.read` Returns the list of all sales channels in your account.Read-onlyList all sales channels
**Required permission:** `sales:sales-channels.read` Returns the list of all sales channels in your account. The response includes both active and archived sales channels. Use sales channel IDs when setting defaults on contacts or assigning revenue to document lines.
Inputs
This tool takes no inputs.
holdedmcp_list_sales_order_attachments**Required permission:** `inventory:sales-orders.read` Returns the list of files attached to a sales order.Read-onlyList sales order attachments
**Required permission:** `inventory:sales-orders.read` Returns the list of files attached to a sales order. Each attachment includes its identifier, file name, and size.
Inputs
salesOrderIdstringrequired- Sales Order ID (24-char hex ObjectId)
holdedmcp_list_sales_orders**Required permission:** `inventory:sales-orders.read` Returns a paginated list of sales orders in your account.Read-onlyList sales orders
**Required permission:** `inventory:sales-orders.read` Returns a paginated list of sales orders in your account. Results are cursor-paginated: the response includes a `cursor` value and a `has_more` boolean. Pass the `cursor` to the next request to fetch the following page.
Inputs
contact_idstring- Filter by contact identifier
cursorstring- Pagination cursor returned by the previous response. Omit to start from the first page.
end_datestring- Filter up to this date. Accepts ISO 8601 datetime (e.g. 2026-12-31T23:59:59+00:00) or date only (e.g. 2026-12-31). A date without a time (YYYY-MM-DD) includes that whole day; a value with a time is applied exactly as sent.
limitinteger- Maximum number of sales orders to return per page. Defaults to 50, maximum 200.default
50 sortstring- Sort field and directionone of
date-datedueDate-dueDatetotal-total start_datestring- Filter from this date. Accepts ISO 8601 datetime (e.g. 2026-01-01T00:00:00+00:00) or date only (e.g. 2026-01-01)
statusstring- Filter by sales order statusone of
pendingcompletedpartialcancelledfailedoverdue
holdedmcp_list_sales_receipt_attachments**Required permission:** `sales:receipts.read` Returns the list of files attached to a sales receipt.Read-onlyList sales receipt attachments
**Required permission:** `sales:receipts.read` Returns the list of files attached to a sales receipt. Each attachment includes its identifier, file name, and size.
Inputs
salesReceiptIdstringrequired- Sales Receipt ID (24-char hex ObjectId)
holdedmcp_list_sales_receipts**Required permission:** `sales:receipts.read` Returns a paginated list of sales receipts in your account.Read-onlyList sales receipts
**Required permission:** `sales:receipts.read` Returns a paginated list of sales receipts in your account. Results are cursor-paginated: the response includes a `cursor` value and a `has_more` boolean. Pass the `cursor` to the next request to fetch the following page.
Inputs
approval_statusstring- Filter by approval status. Use "draft" for unapproved sales receipts, "approved" for approved ones.one of
draftapproved contact_idstring- Filter by contact identifier
cursorstring- Pagination cursor returned by the previous response. Omit to start from the first page.
end_datestring- Filter up to this date. Accepts ISO 8601 datetime (e.g. 2026-12-31T23:59:59+00:00) or date only (e.g. 2026-12-31). A date without a time (YYYY-MM-DD) includes that whole day; a value with a time is applied exactly as sent.
limitinteger- Maximum number of sales receipts to return per page. Defaults to 50, maximum 200.default
50 sortstring- Sort field and directionone of
date-datedueDate-dueDatetotal-total start_datestring- Filter from this date. Accepts ISO 8601 datetime (e.g. 2026-01-01T00:00:00+00:00) or date only (e.g. 2026-01-01)
statusstring- Filter by sales receipt status. "pending" matches sales receipts with no payment recorded and "partial" those paid in part; both still owe a balance. "outstanding" returns the two together, and "overdue" narrows that set to a due date already past.one of
pendingcompletedpartialcancelledfailedoverdueoutstanding
holdedmcp_list_services**Required permission:** `sales:services.read` Returns a paginated list of services in your catalog.Read-onlyList services
**Required permission:** `sales:services.read` Returns a paginated list of services in your catalog. Results are cursor-paginated. Default page size is 25, configurable up to 100 with `limit`.
Inputs
cursorstring- Pagination cursor returned by the previous response. Omit to start from the first page.
include_archivedboolean- Whether to include archived services in the resultsdefault
false limitinteger- Maximum number of services to return per page. Defaults to 25, maximum 100.default
50
holdedmcp_list_tasks**Required permission:** `projects:projects.read` Returns a paginated list of tasks.Read-onlyList all tasks
**Required permission:** `projects:projects.read` Returns a paginated list of tasks. Use `project_id` for the tasks of one project and `text` to search the task name; both filter server-side across every page. Use `status=open` for the tasks still to do: not in a done status and not archived. Requests authenticated as a user also include the private projects that user is a member of; requests made with an API key list public projects only. Results are paginated with `limit` and `cursor` parameters. Default page size is 50, configurable up to 200.
Inputs
cursorstring- Pagination cursor returned by the previous response. Omit to start from the first page.
limitinteger- Maximum number of items to returndefault
50 project_idstring- Only the tasks of this project. A project the caller cannot see lists nothing.
statusstring- `open`: tasks not in a done status and not archived. `done`: tasks in a done status, archived ones included. Omit to list every task, archived ones included.one of
opendone textstring- Search on the task name: every word (up to eight) must appear, case and accents aside. Filters server-side across every page.
holdedmcp_list_taxes**Required permission:** `accounting:taxes.read` Returns the complete list of taxes configured in your account.Read-onlyList all taxes
**Required permission:** `accounting:taxes.read` Returns the complete list of taxes configured in your account. Taxes define the VAT, GST, or other rates applied to document line items. Use this endpoint to discover available tax IDs before creating documents. Each tax includes its percentage rate, type, and applicable region. A signed-in user who can write estimates reads them too, as the estimate editor shows them every tax. API keys still need the scope of this endpoint.
Inputs
This tool takes no inputs.
holdedmcp_list_warehouses**Required permission:** `inventory:warehouses.read` Returns the list of all warehouses in your account.Read-onlyList all warehouses
**Required permission:** `inventory:warehouses.read` Returns the list of all warehouses in your account. The response includes each warehouse's name, address, and default status. Unlike document endpoints, warehouses are not paginated — all warehouses are returned in a single response.
Inputs
This tool takes no inputs.
holdedmcp_list_waybill_attachments**Required permission:** `inventory:shipments.read` Returns the list of files attached to a waybill.Read-onlyList waybill attachments
**Required permission:** `inventory:shipments.read` Returns the list of files attached to a waybill. Each attachment includes its identifier, file name, and size.
Inputs
waybillIdstringrequired- Waybill ID (24-char hex ObjectId)
holdedmcp_list_waybills**Required permission:** `inventory:shipments.read` Returns a paginated list of waybills in your account.Read-onlyList waybills
**Required permission:** `inventory:shipments.read` Returns a paginated list of waybills in your account. Results are cursor-paginated: the response includes a `cursor` value and a `has_more` boolean. Pass the `cursor` to the next request to fetch the following page.
Inputs
contact_idstring- Filter by contact identifier
cursorstring- Pagination cursor returned by the previous response. Omit to start from the first page.
end_datestring- Filter waybills issued on or before this date. Accepts ISO 8601 datetime or date only (YYYY-MM-DD). A date without a time (YYYY-MM-DD) includes that whole day; a value with a time is applied exactly as sent.
limitinteger- Maximum number of waybills to return per page. Defaults to 50, maximum 200.default
50 sortstring- Sort order for results. Prefix with - for descending.one of
date-datedueDate-dueDatetotal-total start_datestring- Filter waybills issued on or after this date. Accepts ISO 8601 datetime or date only (YYYY-MM-DD)
statusstring- Filter by waybill statusone of
pendingcompletedpartialcancelledfailedoverdue
holdedmcp_list_webhooks**Required permission:** `developers:webhooks.read` Returns a paginated list of webhooks for the account.Read-onlyList webhooks
**Required permission:** `developers:webhooks.read` Returns a paginated list of webhooks for the account.
Inputs
cursorstring- Opaque cursor for pagination
limitinteger- Maximum number of webhooks to return per page. Defaults to 50, maximum 200.default
50
holdedmcp_preview_inbox_file**Required permission:** `inbox:inbox.read` Returns a PNG thumbnail of the file, resized to one of a closed set of platform widths.Read-onlyGet a processed thumbnail of a file from an inbox document
**Required permission:** `inbox:inbox.read` Returns a PNG thumbnail of the file, resized to one of a closed set of platform widths. Omitting both width and height returns the original image unresized.
Inputs
filenamestringrequired- Name of the file to retrieve
incomingDocumentIdstringrequired- Incoming document identifier
heightinteger- Target height in pixels. Optional: only allowed when equal to width and width is one of the platform square presets, to request an exact square crop instead of an auto height.one of
3240 widthinteger- Target width in pixels. Must be one of the allowed platform presets; any other value returns 404. Omit together with height to get the original image unresized.one of
324086248
holdedmcp_search_contacts**Required permission:** `contacts:contacts.read` Search for contacts by name.Read-onlySearch contacts by name
**Required permission:** `contacts:contacts.read` Search for contacts by name. Matches against the `name` field using prefix matching (autocomplete-style): `?name=Joh` matches `John Due`, `John Smith`, etc. Token-aware, case- and diacritic-insensitive. The response includes a `cursor` value and a `has_more` boolean. Pass the `cursor` to the next request to fetch the following page. The default page size is 25 contacts. You can increase it up to 100 using the `limit` parameter.
Inputs
namestringrequired- Search term matched against the contact `name` field (prefix matching, case- and diacritic-insensitive)
cursorstring- Opaque cursor for pagination. Use the value returned in the previous response to fetch the next page.
limitinteger- Maximum number of contacts to return per page. Defaults to 25, maximum 100.default
50
No tools match.