> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fyvel.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Companies & scoping

> How `list_companies` works and when `companyUuid` is required.

# 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](/en/mcp/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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.