export_shareholder_registry

Per gli emittenti: genera un’esportazione scaricabile del registro azionisti di una società gestita a una data specifica. I formati supportati sono XLSX (foglio di calcolo) e PDF (stampabile / firmabile). L’intero registro — inclusi gli indirizzi email e altri dettagli di contatto — viene scritto nel file. Il contenuto del file non viene inserito nel contesto della chat; lo strumento restituisce invece un collegamento di download di breve durata e monouso.

Autenticazione

Richiede l’accesso e l’accesso come emittente alla società richiesta. Chiama prima list_managed_companies per ottenere un companyId valido.

Input

Campo	Tipo	Obbligatorio	Descrizione
`company`	integer	Sì	ID della società di una società che l’utente che ha effettuato l’accesso è autorizzato a gestire.
`date`	string	Sì	Data snapshot nel formato `YYYY-MM-DD`. Utilizza la data odierna a meno che l’utente non richieda uno snapshot storico.
`format`	string	Sì	`XLSX` (predefinito per lavori su dati) o `PDF` (per una copia stampabile / firmabile).

Output

Un collegamento a una risorsa cliccabile più una breve riga Markdown che conferma l’esportazione. Il collegamento punta a https://mcp.ai.aktionariat.com/download/<token> ed è valido per 5 minuti e monouso — al clic, il worker MCP Aktionariat recupera il file dal backend e lo trasmette al browser.

Esempi di Prompt

“Esporta il mio registro azionisti come XLSX a partire da oggi.”
“Dammi un PDF del registro azionisti della mia società al 2025-12-31.”
“Ho bisogno della lista completa degli azionisti incluse le email — mandami una copia scaricabile.”

Note per gli Agenti

Il file non entra nella chat. Questo è intenzionale — nomi, indirizzi e indirizzi email sono sensibili e la piattaforma Aktionariat li scrive nel file soltanto. Rendi il collegamento restituito chiaramente visibile in modo che l’utente sappia di aprirlo in un browser.
Il collegamento scade in 5 minuti ed è monouso. Se l’utente perde la finestra temporale, chiama di nuovo questo strumento per creare un nuovo collegamento.
Un 403 significa che l’utente che ha effettuato l’accesso non ha accesso come emittente per la company data. Esegui di nuovo list_managed_companies e riprova con un id valido.
Se l’utente vuole solo un riepilogo (principali detentori, proprietà), preferisci shareholder_registry — restituisce direttamente una piccola tabella Markdown nella chat.