export_shareholder_registry

Für Emittenten: Generieren Sie einen herunterladbaren Export des Aktionärsregisters eines verwalteten Unternehmens zu einem Stichtag. Unterstützte Formate sind XLSX (Tabellenkalkulation) und PDF (druckbar / signierbar). Das vollständige Register — einschließlich E-Mail-Adressen und anderer Kontaktdaten — wird in die Datei geschrieben. Der Dateiinhalt wird nicht in den Chat-Kontext eingezogen; das Tool gibt stattdessen einen kurzlebigen, einmalig verwendbaren Download-Link zurück.

Authentifizierung

Erfordert Anmeldung und Emittentenzugriff auf das angeforderte Unternehmen. Rufen Sie zuerst list_managed_companies auf, um eine gültige companyId zu erhalten.

Eingaben

Feld	Typ	Erforderlich	Beschreibung
company	integer	Ja	Unternehmens-ID eines Unternehmens, das der angemeldete Benutzer verwalten darf.
date	string	Ja	Stichtag im Format YYYY-MM-DD. Verwenden Sie das heutige Datum, sofern der Benutzer keinen historischen Stichtag anfordert.
format	string	Ja	XLSX (Standard für Datenarbeit) oder PDF (für eine druckbare / signierbare Kopie).

Ausgabe

Ein anklickbarer Ressourcen-Link plus eine kurze Markdown-Zeile, die den Export bestätigt. Der Link verweist auf https://mcp.ai.aktionariat.com/download/<token> und ist 5 Minuten lang gültig und einmalig verwendbar — beim Anklicken ruft der Aktionariat MCP Worker die Datei vom Backend ab und streamt sie an den Browser.

Beispiel-Anfragen

• “Exportiere mein Aktionärsregister als XLSX ab heute.”
• “Gib mir eine PDF des Aktionärsregisters für mein Unternehmen am 2025-12-31.”
• “Ich brauche die komplette Aktionärsliste mit E-Mail-Adressen — sende mir eine herunterladbare Kopie.”

Notizen für Agenten

• Die Datei betritt den Chat nicht. Dies ist beabsichtigt — Namen, Adressen und E-Mail-Adressen sind sensibel und die Aktionariat-Plattform schreibt sie nur in die Datei. Rendern Sie den zurückgegebenen Link deutlich, damit der Benutzer weiß, dass er ihn in einem Browser öffnen muss.
• Der Link verfällt in 5 Minuten und ist einmalig verwendbar. Wenn der Benutzer dieses Fenster verpasst, rufen Sie dieses Tool erneut auf, um einen neuen Link zu generieren.
• Ein 403 bedeutet, dass der angemeldete Benutzer keinen Emittentenzugriff für das gegebene company hat. Führen Sie list_managed_companies erneut aus und versuchen Sie es mit einer gültigen ID.
• Wenn der Benutzer nur eine Zusammenfassung möchte (Top-Aktionäre, Eigentumsquoten), bevorzugen Sie shareholder_registry — es gibt direkt im Chat eine kleine Markdown-Tabelle zurück.