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 Kontaktdetails — wird in die Datei geschrieben. Der Dateiinhalt wird nicht in den Chat-Kontext gezogen; das Tool gibt stattdessen einen kurzlebigen Link zum einmaligen Download 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, es sei denn, der Benutzer fordert einen historischen Stichtag an.
format	string	Ja	XLSX (Standard für Datenarbeit) oder PDF (für eine druckbare / signierbare Kopie).

Ausgabe

Ein anklickbarer Ressourcen-Link sowie eine kurze Markdown-Zeile zur Bestätigung des Exports. Der Link verweist auf https://mcp.ai.aktionariat.com/download/<token> und ist 5 Minuten lang gültig und kann nur einmal verwendet werden — beim Anklicken ruft der Aktionariat MCP Worker die Datei vom Backend ab und streamt sie an den Browser.

Beispiel-Prompts

• “Exportiere mein Aktionärsregister heute als XLSX.”
• “Gib mir eine PDF des Aktionärsregisters meines Unternehmens vom 31.12.2025.”
• “Ich brauche die vollständige Aktionärsliste inklusive E-Mail-Adressen — sende mir eine herunterladbare Kopie.”

Anmerkungen für Agenten

• Die Datei wird nicht in den Chat eingegeben. Das ist beabsichtigt — Namen, Adressen und E-Mail-Adressen sind vertraulich und die Aktionariat-Plattform schreibt sie nur in die Datei. Zeigen Sie den zurückgegebenen Link deutlich an, damit der Benutzer weiß, dass er ihn im Browser öffnen soll.
• Der Link verfällt in 5 Minuten und kann nur einmal verwendet werden. Wenn der Benutzer das Zeitfenster 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 (Topaktionäre, Eigentumsanteile), bevorzugen Sie shareholder_registry — es gibt eine kleine Markdown-Tabelle direkt im Chat zurück.