> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/additional/mcp-action-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**:

<ul class="custom-bullets">
  <li>**Profile** – das Tool akzeptiert ein `profileKey`-Argument, um auf ein Sub-Profil abzuzielen.</li>
  <li>**Account** – das Tool nimmt **keinen** `profileKey`; es arbeitet auf Konto-Ebene.</li>
</ul>

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](/additional/mcp-action-connect#precedence-argument-wins-over-header).

## 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. |

<Info>
  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.
</Info>