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.
