MCP-Tool-Katalog

Die 27 Tools, die der Ayrshare MCP Server bereitstellt – Beiträge, Verlauf, Analytics, Kommentare, Direktnachrichten, Profile, Medien, Generierung, Webhooks und Fehler – nach Domäne gruppiert, mit Scope und Zweck.

Der Ayrshare MCP Server stellt 27 Tools bereit, unten nach Domäne gruppiert. Jedes Tool wird in-process über die reale Ayrshare-API-Kette abgewickelt.

​

Scope

Jedes Tool hat entweder den Scope Profile oder Account:

• Profile – das Tool akzeptiert ein profileKey-Argument, um auf ein Sub-Profil abzuzielen.
• Account – das Tool nimmt keinen profileKey; es arbeitet auf Konto-Ebene.

Die sechs Tools, die keinen profileKey-Argument entgegennehmen, sind: create_profile, list_profiles, explain_error, validate_media, generate_post und recommend_hashtags. Alle anderen Tools akzeptieren einen profileKey; generate_jwt_social_linking_url erfordert einen. Hinweis: recommend_hashtags nimmt zwar kein profileKey-Argument entgegen, liest aber weiterhin den Profile-Key-Header der Verbindung, um zu bestimmen, auf welches verknüpfte TikTok-Konto zurückgegriffen wird – die Ergebnisse sind daher profilspezifisch.

Wenn sowohl ein pro Aufruf übergebenes profileKey-Argument als auch ein Profile-Key-Header vorhanden sind, hat das Argument Vorrang. Die Vorrangregeln finden Sie unter Verbinden & Einrichten.

​

Beiträge

Tool	Scope	Zweck
create_post	Profile	Veröffentlichung auf einer oder mehreren verknüpften Plattformen.
validate_post	Profile	Dry-Run-Validierung, dieselben Eingaben wie create_post.
get_post	Profile	Beitrag anhand der Ayrshare Post ID abrufen.
update_post	Profile	Einen geplanten oder auf Freigabe wartenden Beitrag aktualisieren.
retry_post	Profile	Einen fehlgeschlagenen Beitrag erneut senden.

​

Verlauf

Tool	Scope	Zweck
get_post_history	Profile	Über Ayrshare gesendete Beiträge.
get_platform_history	Profile	Beiträge und Analytics direkt vom Netzwerk, einschließlich Beiträgen, die nicht über Ayrshare erstellt wurden. Für einen X-/Twitter-userId-/userName-Lookup nur den Konto-API-Key verwenden; ein profileKey-Argument oder Profile-Key-Header liefert dort Fehler 400.

​

Analytics

Tool	Scope	Zweck
get_post_analytics	Profile	Kennzahlen pro Beitrag anhand der Ayrshare Post ID.
get_post_analytics_by_social_id	Profile	Kennzahlen pro Beitrag anhand der nativen Social Post ID.
get_social_network_analytics	Profile	Kontoweite Analytics und Demografie für ein verbundenes Social-Media-Konto. Für einen X-/Twitter-userId-/userName-Lookup nur den Konto-API-Key verwenden; ein profileKey-Argument oder Profile-Key-Header liefert dort Fehler 400.

​

Kommentare

Tool	Scope	Zweck
get_comments	Profile	Kommentare zu einem Beitrag lesen.
add_comment	Profile	Kommentar auf oberster Ebene.
reply_comment	Profile	Auf einen Kommentar antworten.

​

Nachrichten / DMs

Tool	Scope	Zweck
get_messages	Profile	DMs für eine Plattform abrufen.
send_message	Profile	Eine DM senden.
get_auto_response	Profile	Einstellungen für DM-Auto-Antworten lesen.
set_auto_response	Profile	DM-Auto-Antworten konfigurieren.

​

Profile

Tool	Scope	Zweck
list_profiles	Account	Sub-Profile auflisten.
create_profile	Account	Ein Sub-Profil erstellen.
generate_jwt_social_linking_url	Profile	Eine JWT-Social-Linking-URL erstellen (erfordert profileKey).

​

Medien

Tool	Scope	Zweck
validate_media	Account	Per HEAD-Prüfung feststellen, ob eine Medien-URL erreichbar ist; liefert contentType.

​

Generieren

Tool	Scope	Zweck
generate_post	Account	KI-Entwurf für Beitragstexte.
recommend_hashtags	Account	Hashtag-Vorschläge auf Basis von TikTok-View-Count-Daten. Verwendet das mit dem Profil verknüpfte TikTok-Konto, das im Profile-Key-Header angegeben ist; nimmt kein pro Aufruf übergebenes profileKey entgegen.

​

Webhooks

Tool	Scope	Zweck
register_webhook	Profile	Einen Webhook registrieren.
unregister_webhook	Profile	Einen Webhook abmelden.
list_webhooks	Profile	Registrierte Webhooks auflisten.

​

Fehler

Tool	Scope	Zweck
explain_error	Account	Einen Ayrshare-Fehlercode in Ursache, Klassifikation und Behebung dekodieren.

Dieser Katalog wird gegen das tools/list des Live-Servers abgeglichen. Weitere Tools sind geplant (z. B. Links-Tools). Fragen Sie im Zweifel tools/list ab, um den maßgeblichen Satz zu erhalten. Der Katalog wird vom MCP-Server-Team gepflegt.