list_managed_companies

List the companies the signed-in user is authorized to manage as an issuer. This is the entry point for every other issuer tool — its returned companyId values are what shareholder_registry, export_shareholder_registry, list_proposals, and sign_proposal expect as input.

Authentication

Requires sign-in. Call sign_in first if the session is anonymous. The signed-in user must have at least one issuer authorization on the Aktionariat backend.

Inputs

None.

Output

A summary array. Each row contains the fields needed to call the downstream issuer tools:

Field	Type	Description
companyId	integer	Numeric id of the managed company.
companyName	string	Full company name.
tokenName	string	Name of the tokenized share class.
registerTicker	string	Ticker of the registered share class.
tradedTicker	string	Ticker of the tradeable share class.
chain	string	Blockchain (mainnet, optimism).

The user’s wallet address and internal id from GET /authorizations are intentionally excluded from the response — they are not useful to the agent.

Example Prompts

• “Which companies can I manage on Aktionariat?”
• “What is the company id of my managed company?”
• “Show me the chain and tickers for the companies I manage.”

Notes for Agents

• Always call this tool before any other issuer tool. Do not guess companyId values — shareholder_registry, export_shareholder_registry, list_proposals, and sign_proposal will reject ids the user is not authorized for.
• If the response is empty, the signed-in user has no issuer access — tell them and do not call the downstream issuer tools.