Skip to main content

​
Companies & scoping

Many MCP tools work with the data of a specific company. list_companies is therefore usually the first call in a new client flow.

​
Tool

  • list_companies — lists the companies of the organisation from the bearer token

​
What you need list_companies for

The call returns the companyUuid values that many other tools need, for example:
  • list_accounts
  • create_account
  • update_account
  • list_account_transactions
  • list_categories
  • bulk_create_categories
  • change_category
  • delete_category
  • list_mapping_transactions
  • set_booking_category
  • list_manual_uploads
  • create_manual_upload
  • list_manual_transactions
  • append_manual_transactions
  • patch_manual_transactions
  • remove_manual_transactions
  • list_open_items
  • get_open_item
  • list_open_item_lines
  • list_open_item_statuses

​
What the tool returns

The tool returns the legal entities of the organisation. For most flows, name, company_uuid, currency, and onboarding status matter. mappingIgnoreEnabled shows whether ignore_bookings is allowed for this company. If the MCP user is allowed to see open items, each company also includes:
  • openItemsReceivablesEnabled / openItemsPayablesEnabled — modules enabled
  • openItemsConnectAvailable — DATEV Connect usable for open items
  • openItemsEligible — Connect and at least one module enabled
Without permission these fields are null. Details on the open-items tools: Open items.

​
Typical flow

  1. Call list_companies
  2. Choose the matching company
  3. Use companyUuid in the following company-specific calls

​
Note

The organisation is not passed as a parameter. It is already set by the MCP bearer token.