export_shareholder_registry

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

Autenticazione

Richiede l’accesso e l’accesso da emittente alla società richiesta. Chiamare list_managed_companies per primo per ottenere un companyId valido.

Input

Campo	Tipo	Obbligatorio	Descrizione
`company`	integer	Sì	ID società di una società che l’utente connesso è autorizzato a gestire.
`date`	string	Sì	Data di snapshot in formato `YYYY-MM-DD`. Utilizzare la data odierna a meno che l’utente non chieda uno snapshot storico.
`format`	string	Sì	`XLSX` (predefinito per il lavoro sui dati) o `PDF` (per una copia stampabile / firmabile).

Output

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

Prompt di esempio

“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 dell’elenco completo degli azionisti comprese le email — inviami una copia scaricabile.”

Note per gli agenti

Il file non entra nella chat. È intenzionale — nomi, indirizzi e indirizzi email sono sensibili e la piattaforma Aktionariat li scrive nel file solo. Rendi il link restituito chiaramente visibile in modo che l’utente sappia di aprirlo in un browser.
Il link scade in 5 minuti ed è monouso. Se l’utente perde la finestra, chiama di nuovo questo strumento per generare un link fresco.
Un 403 significa che l’utente connesso non dispone di accesso da emittente per la company data. Riesegui list_managed_companies e riprova con un ID valido.
Se l’utente desidera solo un riepilogo (principali detentori, proprietà), preferisci shareholder_registry — restituisce una piccola tabella Markdown direttamente nella chat.