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

# Social-Media-MCP-Server für KI-Agenten

> Lass Claude, Cursor, Codex oder jeden MCP-Client über den Remote-MCP-Server von Social media studio Beiträge planen, Nachrichten beantworten und Analysen lesen.

## Was ist MCP?

Das [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) ist ein offener Standard, um KI-Tools mit externen Diensten zu verbinden. Mit dem MCP-Server von Social media studio können KI-Agenten Social-Media-Beiträge direkt erstellen, planen und verwalten.

## Verbindungsdetails

| Eigenschaft | Wert |
| - | - |
| **Vollständiger Endpunkt** (Cursor / benutzerdefiniert) | `https://api.so-me.studio/mcp` |
| **Directory-Endpunkt** (Marketplace, keine KI-Bild-/Video-Tools) | `https://api.so-me.studio/mcp/directory` |
| **Claude-Directory-Endpunkt** (Claude Connectors Directory) | `https://api.so-me.studio/mcp/claude` |
| **Transport** | Streamable HTTP (nur POST) |
| **Authentifizierung** | `X-API-Key`-Header **oder** OAuth 2.1 (PKCE) |
| **Modus** | Zustandslos (keine Sitzungen) |

> [!NOTE]
>
> Benutzerdefinierte Connectors (Cursor, benutzerdefinierter Claude-Connector mit eingefügtem Schlüssel) können weiterhin
> `X-API-Key` verwenden. Marketplace-Einträge nutzen OAuth: Der Eintrag im Claude Connectors Directory verwendet
> die URL des **Claude directory** (siehe unten), andere Marketplaces verwenden die **Directory**-URL,
> die KI-Bild-/Video-Tools ausschließt.

> [!NOTE]
>
> Die Directory-MCP-URL filtert KI-Tools zur Bild- und Videogenerierung heraus (Richtlinie des Claude Directory). KI-Tools für
> Bildunterschriften/Texte und Planungs-Tools bleiben verfügbar. Der vollständige Katalog bleibt unter
> `/mcp`.

## Claude directory connector

**Social media studio** (powered by So-me Studio) hat einen eigenen Endpunkt für Claude. Der Eintrag im Claude
Connectors Directory und das Social-media-studio-Plugin für Claude nutzen ihn, und du kannst
ihn schon heute als benutzerdefinierten Connector per URL hinzufügen (**Customize** > **Connectors** > **Add custom
connector**). Er gibt Claude dieselben 28 Posting-Tools wie die Plugins für ChatGPT und Grok.

| Eigenschaft | Wert |
| - | - |
| **URL** | `https://api.so-me.studio/mcp/claude` |
| **Anmeldung** | OAuth 2.1 mit PKCE. Claude öffnet die Anmeldeseite von Social media studio; ein API-Schlüssel ist nicht nötig. |
| **Workspace** | Der Workspace, den du auf der Zustimmungsseite bestätigst. Dein Tarif, deine Berechtigungen und Nutzungslimits gelten. |

Der Connector deckt ab:

* **Veröffentlichen und Planen** — Beiträge erstellen, aktualisieren, planen, Planung aufheben, erneut versuchen und löschen sowie den Kalender lesen
* **Entwürfe** — Entwürfe erstellen, bearbeiten, löschen und in Beiträge umwandeln
* **Mediathek und Upload** — Bilder und Videos durchsuchen, suchen und hochladen
* **Medienprüfungen** — Dateien vor der Veröffentlichung anhand der Medienregeln jeder Plattform prüfen
* **Beitragsoptionen** — Thread-Ketten, ein erster Kommentar sowie TikTok-Datenschutz- und Interaktionseinstellungen
* **Ziele** — verbundene Konten, Pinterest-Boards sowie Discord- und Slack-Kanäle

Nicht enthalten sind Analysen, der Posteingang, Abrechnung, Kontoverwaltung sowie die KI-Bild- und Videogenerierung.
Beiträge für Reddit und Google Business Profile werden in dieser Version nicht unterstützt.

> [!NOTE]
>
> Der Entwicklerweg ändert sich nicht: Nutze `https://api.so-me.studio/mcp` mit einem `X-API-Key`-Header
> für den vollständigen Tool-Katalog.

## OAuth (Directory-Clients)

Social media studio unterstützt MCP OAuth 2.1 mit PKCE (S256), Protected-Resource-Metadaten und
Dynamic Client Registration bzw. CIMD-kompatible Metadaten des Autorisierungsservers.

Die für Agenten lesbare [Auth.md-Anleitung](https://so-me.studio/auth.md) beschreibt den vollständigen PKCE-Ablauf für öffentliche Clients. Ihre URL und die unterstützte `user_authorization`-Methode werden auch im `agent_auth`-Block der OAuth-Metadaten veröffentlicht.

| Endpunkt | Zweck |
| - | - |
| `GET /.well-known/oauth-protected-resource/mcp/directory` | Protected-Resource-Metadaten für den Directory-MCP |
| `GET /.well-known/oauth-protected-resource/mcp/claude` | Protected-Resource-Metadaten für den Claude-Directory-MCP |
| `GET /.well-known/oauth-authorization-server` | Discovery des Autorisierungsservers (PKCE S256) |
| `GET /oauth/authorize` | Autorisierung + Zustimmung |
| `POST /oauth/token` | Token-Austausch / Erneuerung |
| `POST /oauth/register` | Dynamic Client Registration (Fallback) |

Schreibende Tools bleiben tarifabhängig (Standard-, Advanced- oder Lifetime-API-Zugriff), sowohl für API-Schlüssel- als auch für OAuth-Sitzungen.

## Verfügbare Tools

Nach der Verbindung kann dein KI-Agent **205 Tools** aufrufen, unten nach Bereich gruppiert. Jedes Tool verbraucht pro Aufruf eine kleine Zahl an MCP-Credits (1 = lesen, 2 = schreiben/ändern, 3 = Analysen, 5 = KI-Text, 8 = KI-Bild, 10 = zusammengesetzte KI-Aktionen). Mit `list_mcp_tools` rufst du die aktuelle Liste samt Credit-Kosten pro Tool ab, mit `get_mcp_usage` prüfst du deine verbleibenden MCP-Credits.

> **Beiträge (11 Tools)**
>
> | Tool | Beschreibung |
> | - | - |
> | `list_posts` | Geplante/veröffentlichte Beiträge auflisten, filterbar nach Status und Plattform |
> | `get_post` | Einen einzelnen Beitrag per ID abrufen |
> | `create_post` | Einen neuen Beitrag für eine beliebige verbundene Plattform erstellen |
> | `update_post` | Inhalt oder Planung eines bestehenden Beitrags aktualisieren |
> | `schedule_post` | Einen bestehenden Beitrag für eine spätere Veröffentlichung planen |
> | `unschedule_post` | Einen Beitrag aus der Planung nehmen (zurück auf ausstehend setzen) |
> | `delete_post` | Einen Beitrag löschen |
> | `retry_post` | Einen fehlgeschlagenen Beitrag erneut versuchen (setzt den Status von FAILED auf PENDING zurück) |
> | `resubmit_post` | Einen abgelehnten Beitrag erneut zur Freigabe einreichen |
> | `bulk_delete_posts` | Mehrere Beiträge auf einmal löschen |
> | `get_calendar_posts` | Beiträge für einen Zeitraum abrufen (Kalenderansicht) |

> **Beitragskommentare (5 Tools)**
>
> | Tool | Beschreibung |
> | - | - |
> | `list_post_comments` | Kommentare zu einem Beitrag auflisten |
> | `add_post_comment` | Einen Kommentar zu einem Beitrag hinzufügen |
> | `update_post_comment` | Einen bestehenden Beitragskommentar aktualisieren |
> | `delete_post_comment` | Einen Beitragskommentar löschen |
> | `mark_comments_as_read` | Alle Kommentare eines Beitrags als gelesen markieren |

> **Entwürfe (6 Tools)**
>
> | Tool | Beschreibung |
> | - | - |
> | `list_drafts` | Entwürfe in deinem Workspace auflisten |
> | `get_draft` | Einen einzelnen Entwurf per ID abrufen |
> | `create_draft` | Einen neuen Entwurf erstellen |
> | `update_draft` | Einen bestehenden Entwurf aktualisieren |
> | `delete_draft` | Einen Entwurf löschen |
> | `convert_draft` | Einen Entwurf in einen geplanten Beitrag umwandeln |

> **Konten (3 Tools)**
>
> | Tool | Beschreibung |
> | - | - |
> | `list_accounts` | Verbundene Social-Media-Konten auflisten |
> | `get_account` | Details eines verbundenen Social-Media-Kontos abrufen |
> | `disconnect_account` | Ein verbundenes Social-Media-Konto trennen (entfernen) |

> **Medien (13 Tools)**
>
> | Tool | Beschreibung |
> | - | - |
> | `list_media` | Mediendateien in deiner Mediathek auflisten |
> | `search_media` | Mediendateien nach Namen suchen |
> | `get_media_file` | Eine einzelne Mediendatei per ID abrufen |
> | `delete_media` | Eine Mediendatei aus der Mediathek löschen |
> | `bulk_delete_media` | Mehrere Mediendateien auf einmal löschen |
> | `list_media_folders` | Medienordner in der Mediathek auflisten |
> | `create_media_folder` | Einen neuen Medienordner erstellen |
> | `delete_media_folder` | Einen Medienordner (samt Inhalt) löschen |
> | `move_media_file` | Eine Mediendatei in einen anderen Ordner oder in die Wurzel verschieben |
> | `move_media_folder` | Einen Ordner in einen anderen übergeordneten Ordner oder in die Wurzel verschieben |
> | `rename_media_file` | Eine Mediendatei umbenennen |
> | `rename_media_folder` | Einen Medienordner umbenennen |
> | `presign_media_upload` | Vorsignierte S3-PUT-URLs erzeugen, um Dateien in die Mediathek hochzuladen |

> **Posteingang (18 Tools)**
>
> | Tool | Beschreibung |
> | - | - |
> | `list_conversations` | Posteingangs-Unterhaltungen über alle verbundenen Plattformen auflisten |
> | `get_messages` | Nachrichten eines Unterhaltungs-Threads abrufen |
> | `reply_to_conversation` | Eine Antwort in einen Unterhaltungs-Thread senden |
> | `update_conversation` | Den Status einer Unterhaltung aktualisieren (als gelesen/gesehen, erledigt usw. markieren) |
> | `delete_conversation` | Einen Unterhaltungs-Thread löschen |
> | `list_saved_replies` | Gespeicherte Antwortvorlagen auflisten |
> | `get_saved_reply` | Eine einzelne gespeicherte Antwort per ID abrufen |
> | `create_saved_reply` | Eine neue gespeicherte Antwortvorlage erstellen |
> | `update_saved_reply` | Eine bestehende gespeicherte Antwort aktualisieren |
> | `delete_saved_reply` | Eine gespeicherte Antwort löschen |
> | `subscribe_inbox` | Die Posteingangs-Synchronisierung für ein verbundenes Social-Media-Konto aktivieren |
> | `unsubscribe_inbox` | Die Posteingangs-Synchronisierung für ein verbundenes Social-Media-Konto deaktivieren |
> | `edit_inbox_message` | Einen Kommentar/eine Nachricht im Social-Posteingang bearbeiten (Facebook/Instagram) |
> | `delete_inbox_message` | Einen Kommentar/eine Nachricht im Social-Posteingang löschen (Facebook/Instagram) |
> | `hide_inbox_message` | Einen Kommentar im Social-Posteingang ausblenden oder wieder einblenden (Facebook/Instagram) |
> | `preview_bulk_reply` | Die Empfänger einer Massenantwort vor dem Senden in der Vorschau ansehen |
> | `create_bulk_reply` | Eine Antwort (mit optionaler `{{name}}`-Personalisierung) an viele DM-Unterhaltungen senden |
> | `get_bulk_reply_batch` | Status und Ergebnisse eines Massenantwort-Batches abrufen |

> **Freigaben (4 Tools)**
>
> | Tool | Beschreibung |
> | - | - |
> | `list_approvals` | Beiträge auflisten, die auf Freigabe warten |
> | `approve_post` | Einen Beitrag freigeben, der auf Freigabe wartet |
> | `reject_post` | Einen Beitrag ablehnen, der auf Freigabe wartet (Ablehnungskommentar erforderlich) |
> | `update_review_comment` | Den Prüf-/Ablehnungskommentar eines Beitrags im Freigabe-Workflow aktualisieren |

> **Teams (6 Tools)**
>
> | Tool | Beschreibung |
> | - | - |
> | `list_team_members` | Alle Teammitglieder deines Workspace auflisten |
> | `invite_team_member` | Ein neues Mitglied in den Workspace einladen |
> | `remove_team_member` | Ein Mitglied aus dem Workspace entfernen |
> | `update_member_role` | Die Rolle eines Teammitglieds aktualisieren |
> | `list_team_invitations` | Ausstehende Team-Einladungen auflisten |
> | `cancel_team_invitation` | Eine ausstehende Team-Einladung zurückziehen |

> **Biolinks (19 Tools)**
>
> | Tool | Beschreibung |
> | - | - |
> | `list_biolinks` | Alle Biolink-Seiten auflisten |
> | `get_biolink` | Details einer Biolink-Seite abrufen |
> | `create_biolink` | Eine neue Biolink-Seite erstellen |
> | `update_biolink` | Eine bestehende Biolink-Seite aktualisieren |
> | `delete_biolink` | Eine Biolink-Seite löschen |
> | `publish_biolink` | Den Veröffentlichungsstatus eines Biolinks umschalten |
> | `change_biolink_theme` | Einen Biolink auf ein voreingestelltes Design umstellen |
> | `set_biolink_custom_theme` | Eigene Designfarben auf einen Biolink anwenden |
> | `list_biolink_buttons` | Schaltflächen einer Biolink-Seite auflisten |
> | `create_biolink_button` | Einer Biolink-Seite eine Schaltfläche hinzufügen |
> | `update_biolink_button` | Eine Schaltfläche einer Biolink-Seite aktualisieren |
> | `delete_biolink_button` | Eine Schaltfläche von einer Biolink-Seite löschen |
> | `reorder_biolink_buttons` | Schaltflächen einer Biolink-Seite neu anordnen |
> | `list_biolink_posts` | Galerie-Beiträge einer Biolink-Seite auflisten |
> | `create_biolink_post` | Einem Biolink einen Galerie-Beitrag hinzufügen |
> | `update_biolink_post` | Einen Galerie-Beitrag eines Biolinks aktualisieren |
> | `delete_biolink_post` | Einen Galerie-Beitrag von einem Biolink löschen |
> | `reorder_biolink_posts` | Galerie-Beiträge eines Biolinks neu anordnen |
> | `get_biolink_analytics` | Analysen einer Biolink-Seite abrufen (Aufrufe, Klicks) |

> **KI-Inhalte (10 Tools)**
>
> | Tool | Beschreibung |
> | - | - |
> | `generate_caption` | Eine KI-Bildunterschrift für eine bestimmte Plattform und Tonalität generieren |
> | `generate_content` | KI-Text beliebiger Art generieren oder umschreiben (Beitrag, Bildunterschrift, Hashtag, Überschrift, Bio, Thread, E-Mail usw.) |
> | `generate_image` | Ein KI-Bild aus einem Text-Prompt generieren |
> | `generate_and_schedule` | KI-Inhalt generieren, einen Beitrag erstellen und ihn in einem Aufruf planen |
> | `get_ai_history` | Verlauf der KI-Prompt-Generierungen abrufen |
> | `get_ai_credits` | KI-Credit-Guthaben und -Limits (Text, Bild, UGC-Video) für den aktuellen Tarif abrufen |
> | `list_ai_image_providers` | Vom aktuellen Tarif erlaubte KI-Bildanbieter auflisten |
> | `list_generated_images` | KI-generierte Bilder mit Paginierung auflisten |
> | `get_generated_image` | Details eines einzelnen KI-generierten Bildes per ID abrufen |
> | `delete_generated_image` | Ein KI-generiertes Bild löschen |

> **KI-Video / UGC (9 Tools)**
>
> | Tool | Beschreibung |
> | - | - |
> | `generate_video` | Ein KI-UGC-Video aus Hook-Text + Avatar generieren |
> | `list_videos` | Generierte UGC-Videos auflisten |
> | `get_video` | Ein generiertes Video per ID abrufen (inkl. Generierungsstatus) |
> | `delete_video` | Ein generiertes Video löschen |
> | `list_avatars` | Verfügbare UGC-Avatare für die Videogenerierung auflisten |
> | `list_sounds` | Verfügbare Sounds/Musik für die Videogenerierung auflisten |
> | `get_sound_genres` | Verfügbare Hintergrundsound-Genres für UGC-Videos auflisten |
> | `generate_hook_suggestions` | KI-Hook-/Skript-Vorschläge für UGC-Videos generieren |
> | `list_ai_video_providers` | Vom aktuellen Tarif erlaubte KI-UGC-Videoanbieter auflisten |

> **Analysen (26 Tools)**
>
> | Tool | Beschreibung |
> | - | - |
> | `get_analytics_summary` | Workspace-Analysen abrufen: Beitragszahlen nach Status und Plattform |
> | `get_platform_analytics` | Detaillierte Analysen für ein bestimmtes verbundenes Social-Media-Konto abrufen |
> | `get_post_analytics` | Analysen für einen bestimmten Beitrag abrufen |
> | `get_facebook_analytics` | Analysen auf Facebook-Seitenebene abrufen |
> | `get_facebook_posts_analytics` | Analysen pro Beitrag der Facebook-Seite abrufen |
> | `get_facebook_videos_analytics` | Analysen pro Video der Facebook-Seite abrufen |
> | `get_instagram_analytics` | Analysen auf Instagram-Kontoebene abrufen |
> | `get_instagram_media_analytics` | Analysen pro Instagram-Beitrag abrufen |
> | `get_instagram_stories_analytics` | Analysen zu Instagram-Stories abrufen |
> | `get_linkedin_analytics` | Analysen auf LinkedIn-Seitenebene abrufen |
> | `get_linkedin_posts_analytics` | Analysen pro Beitrag der LinkedIn-Seite abrufen |
> | `get_youtube_analytics` | Analysen auf YouTube-Kanalebene abrufen |
> | `get_youtube_videos_analytics` | Analysen pro Video des YouTube-Kanals abrufen |
> | `get_twitter_analytics` | Analysen auf Twitter/X-Kontoebene abrufen |
> | `get_twitter_content_analytics` | Analysen auf Twitter/X-Inhaltsebene abrufen |
> | `get_tiktok_analytics` | TikTok-Kontoanalysen abrufen |
> | `get_whatsapp_analytics` | Analysen des WhatsApp-Business-Kontos abrufen |
> | `get_bluesky_analytics` | Bluesky-Kontoanalysen abrufen |
> | `get_mastodon_analytics` | Mastodon-Kontoanalysen abrufen |
> | `get_reddit_account_analytics` | Analysen auf Reddit-Kontoebene abrufen |
> | `get_reddit_submissions_analytics` | Analysen zu Reddit-Submissions (Beiträgen) abrufen |
> | `get_pinterest_analytics` | Pinterest-Kontoanalysen abrufen |
> | `get_pinterest_pins_analytics` | Analysen pro Pinterest-Pin abrufen |
> | `get_pinterest_top_pins_analytics` | Die erfolgreichsten Pinterest-Pins abrufen |
> | `get_pinterest_top_video_pins_analytics` | Die erfolgreichsten Pinterest-Video-Pins abrufen |
> | `get_gmb_analytics` | Analysen eines Standorts im Google Business Profile (GMB) abrufen |

> **Beste Veröffentlichungszeit (3 Tools)**
>
> | Tool | Beschreibung |
> | - | - |
> | `get_best_time_recommendations` | Empfehlungen zur besten Veröffentlichungszeit für alle verbundenen Konten im Workspace auflisten |
> | `get_best_time_recommendation` | Die Empfehlung zur besten Zeit (Heatmap + Top-Zeitfenster) für ein einzelnes Konto abrufen |
> | `recompute_best_time_recommendation` | Die Empfehlung zur besten Zeit für ein Konto anhand des jüngsten Interaktionsverlaufs neu berechnen |

> **Vorlagen (3 Tools)**
>
> | Tool | Beschreibung |
> | - | - |
> | `list_templates` | Verfügbare Inhaltsvorlagen nach Kategorie auflisten |
> | `get_template` | Eine einzelne Vorlage per ID abrufen |
> | `render_template` | Eine Vorlage mit den übergebenen Feldwerten rendern |

> **Wissen (RAG) (6 Tools)**
>
> | Tool | Beschreibung |
> | - | - |
> | `list_knowledge` | Wissensdokumente auflisten, die der KI-Assistent nutzt (RAG) |
> | `get_knowledge` | Ein einzelnes Wissensdokument mit extrahiertem Text und Metadaten abrufen |
> | `create_knowledge` | Ein Wissensdokument aus einer hochgeladenen Datei oder einer getippten Notiz erstellen |
> | `update_knowledge` | Metadaten oder Notiztext eines Wissensdokuments aktualisieren |
> | `reprocess_knowledge` | Die Extraktion für ein fehlgeschlagenes PDF-/Bild-/Text-Wissensdokument erneut versuchen |
> | `delete_knowledge` | Ein Wissensdokument löschen |

> **Canva (4 Tools)**
>
> | Tool | Beschreibung |
> | - | - |
> | `get_canva_status` | Prüfen, ob Canva für den authentifizierten Benutzer verbunden ist |
> | `list_canva_designs` | Die Canva-Designs des Benutzers auflisten (paginiert, durchsuchbar) |
> | `export_canva_design` | Ein Canva-Design als Bild exportieren (asynchron; gibt eine Export-Job-ID zurück) |
> | `get_canva_export_status` | Den Status eines Canva-Design-Export-Jobs abfragen |

> **Hilfe & Support (5 Tools)**
>
> | Tool | Beschreibung |
> | - | - |
> | `create_ticket` | Ein Support-Ticket erstellen |
> | `list_tickets` | Deine Support-Tickets auflisten |
> | `get_ticket` | Ein Support-Ticket mit Details abrufen |
> | `send_ticket_message` | Eine Nachricht in einem Support-Ticket senden |
> | `list_ticket_messages` | Alle Nachrichten eines Support-Tickets auflisten |

> **Benachrichtigungen (5 Tools)**
>
> | Tool | Beschreibung |
> | - | - |
> | `list_notifications` | In-App-Benachrichtigungen des authentifizierten Benutzers auflisten |
> | `get_unread_notification_count` | Anzahl ungelesener Benachrichtigungen abrufen, optional nach Kategorie |
> | `mark_notification_read` | Eine einzelne Benachrichtigung als gelesen markieren |
> | `mark_all_notifications_read` | Alle Benachrichtigungen (optional innerhalb einer Kategorie) als gelesen markieren |
> | `archive_notification` | Eine Benachrichtigung archivieren (ausblenden) |

> **Einstellungen & Konto (9 Tools)**
>
> | Tool | Beschreibung |
> | - | - |
> | `get_profile` | Dein Benutzerprofil abrufen |
> | `update_profile` | Das Profil des authentifizierten Benutzers aktualisieren (Name, Passwort, E-Mail) |
> | `get_organization` | Details zu Workspace/Organisation abrufen |
> | `update_organization` | Den aktuellen Workspace aktualisieren (Name, Beschreibung, Farbe, Zeitzone) |
> | `get_usage` | Nutzungsübersicht für den aktuellen Abrechnungszeitraum abrufen |
> | `get_user_preferences` | Die Einstellungen des authentifizierten Benutzers abrufen (Benachrichtigungen, Zeitzone, UI-Einstellungen) |
> | `update_user_preferences` | Die Einstellungen des authentifizierten Benutzers aktualisieren (zusammenführen) |
> | `get_current_tenant` | Details des aktuell aktiven Workspace (Tenant) abrufen |
> | `get_billing` | Abo- und Abrechnungsinformationen abrufen |

> **Tarife & Abrechnung (4 Tools)**
>
> | Tool | Beschreibung |
> | - | - |
> | `get_plans` | Den Tarifkatalog mit Preisen und Sichtbarkeit abrufen |
> | `get_plan_features` | Die Funktionsmatrix für einen bestimmten Tarif abrufen |
> | `get_subscription` | Aktuellen Abo-Status, Tarif und Limits des Workspace abrufen |
> | `list_invoices` | Rechnungen des aktuellen Abos auflisten |

> **API-Schlüssel (3 Tools)**
>
> | Tool | Beschreibung |
> | - | - |
> | `list_api_keys` | Aktive API-Schlüssel des aktuellen Workspace auflisten |
> | `create_api_key` | Einen neuen API-Schlüssel erstellen (der vollständige Schlüssel wird nur einmal zurückgegeben) |
> | `revoke_api_key` | Einen API-Schlüssel widerrufen |

> **Workspaces / Tenants (4 Tools)**
>
> | Tool | Beschreibung |
> | - | - |
> | `list_tenants` | Workspaces/Tenants auflisten, denen der authentifizierte Benutzer angehört |
> | `create_tenant` | Einen neuen Workspace erstellen, der dem authentifizierten Benutzer gehört |
> | `delete_tenant` | Einen Workspace löschen |
> | `leave_tenant` | Einen Workspace verlassen, dessen Mitglied der Benutzer ist |

> **Empfehlungen (2 Tools)**
>
> | Tool | Beschreibung |
> | - | - |
> | `get_referral_code` | Den Empfehlungscode des authentifizierten Benutzers abrufen |
> | `get_referral_stats` | Empfehlungscode, Anzahl der Empfehlungen, verdiente Credits und Share-URL abrufen |

> **MCP-Introspektion (2 Tools)**
>
> | Tool | Beschreibung |
> | - | - |
> | `get_mcp_usage` | MCP-Credit-Nutzung, Limits und Aufschlüsselung pro Tool dieses Workspace für den aktuellen Zeitraum abrufen |
> | `list_mcp_tools` | Alle verfügbaren MCP-Tools und ihre Credit-Kosten auflisten |

> **WhatsApp (6 Tools)**
>
> | Tool | Beschreibung |
> | - | - |
> | `list_whatsapp_templates` | WhatsApp-Business-Nachrichtenvorlagen auflisten |
> | `get_whatsapp_template` | Eine einzelne WhatsApp-Nachrichtenvorlage per Namen abrufen |
> | `create_whatsapp_template` | Eine WhatsApp-Nachrichtenvorlage erstellen (zur Freigabe bei Meta einreichen) |
> | `delete_whatsapp_template` | Eine WhatsApp-Nachrichtenvorlage löschen |
> | `send_whatsapp_template` | Eine WhatsApp-Vorlagennachricht an einen Empfänger senden |
> | `upload_whatsapp_template_media` | Header-Medien (Bild/Video/Dokument) für eine Vorlage hochladen |

> **Webhooks (10 Tools)**
>
> | Tool | Beschreibung |
> | - | - |
> | `list_webhook_subscriptions` | Webhook-Abonnements auflisten |
> | `get_webhook_subscription` | Ein einzelnes Webhook-Abonnement per ID abrufen |
> | `create_webhook_subscription` | Ein Webhook-Abonnement für Ereigniskategorien erstellen |
> | `update_webhook_subscription` | Ein Webhook-Abonnement aktualisieren (URL, Kategorien, Aktivstatus, Secret neu generieren) |
> | `delete_webhook_subscription` | Ein Webhook-Abonnement löschen |
> | `test_webhook_subscription` | Einen Test-Ping an ein Webhook-Abonnement senden |
> | `list_webhook_deliveries` | Webhook-Zustellprotokolle mit optionalen Filtern auflisten |
> | `get_webhook_delivery` | Ein einzelnes Webhook-Zustellprotokoll mit vollständigem Payload und Status abrufen |
> | `retry_webhook_delivery` | Eine fehlgeschlagene Webhook-Zustellung erneut versuchen |
> | `list_webhook_events` | Alle verfügbaren Webhook-Ereignistypen nach Kategorie auflisten |

> **Integrations-Helfer (9 Tools)**
>
> Diese Tools lösen plattformspezifische Veröffentlichungsziele (Boards, Subreddits, Kanäle, Standorte) auf, damit du vor dem Erstellen eines Beitrags ein Ziel auswählen kannst.
>
> | Tool | Beschreibung |
> | - | - |
> | `list_pinterest_boards` | Pinterest-Boards eines Kontos auflisten (vor dem Veröffentlichen ein Board auswählen) |
> | `create_pinterest_board` | Ein neues Pinterest-Board erstellen |
> | `list_reddit_subreddits` | Subreddits auflisten, in denen das verbundene Reddit-Konto Mitglied ist |
> | `list_reddit_flairs` | Verfügbare Beitrags-Flairs eines Subreddits auflisten |
> | `list_gmb_locations` | Standorte im Google Business Profile (GMB) eines Kontos auflisten |
> | `list_discord_channels` | Für ein Konto im Bot-Modus verfügbare Discord-Kanäle auflisten |
> | `list_slack_channels` | Slack-Kanäle eines verbundenen Workspace auflisten |
> | `list_telegram_chats` | Für ein Konto verfügbare Telegram-Chats/-Gruppen auflisten |
> | `get_tiktok_creator_info` | TikTok-Creator-/Kontoinformationen abrufen (Veröffentlichungsfunktionen prüfen) |

## Unterstützte Plattformen

Das Enum `socialMedia` / `platform`, das die Beitrags- und KI-Inhalts-Tools verwenden (`create_post`, `create_draft`, `generate_caption`, `generate_and_schedule`, `generate_hook_suggestions` usw.), akzeptiert diese Werte:

| Plattform | Enum-Wert |
| - | - |
| Twitter / X | `TWITTER` |
| Instagram | `INSTAGRAM` |
| LinkedIn | `LINKEDIN` |
| LinkedIn Page | `LINKEDIN_PAGE` |
| Facebook | `FACEBOOK` |
| TikTok | `TIKTOK` |
| YouTube | `YOUTUBE` |
| Threads | `THREADS` |
| WhatsApp | `WHATSAPP` |
| Dribbble | `DRIBBBLE` |
| Pinterest | `PINTEREST` |

> [!NOTE]
>
> Analyse- und Integrations-Helfer-Tools decken mehr Ziele ab als das obige Beitrags-Enum — darunter Bluesky, Mastodon, Reddit, Google Business Profile (GMB), Discord, Slack und Telegram. Nutze `list_accounts`, um jedes verbundene Konto und seine `accountId` zu ermitteln, und übergib diese ID dann an die plattformspezifischen Analyse- oder Integrations-Helfer-Tools.

## Beitragstypen

Der Parameter `postType` bei `create_post`, `update_post`, `create_draft` und `update_draft` akzeptiert: `TEXT`, `IMAGE`, `MULTIPLE_IMAGES`, `VIDEO`, `CAROUSEL`, `REEL`, `STORY` (Standard: `TEXT`).

## Beitragsstatus

Der Filter `status` bei `list_posts` akzeptiert: `POSTED`, `SCHEDULED`, `PENDING`, `FAILED`, `PENDING_APPROVAL`, `REJECTED`.

## Beispielanfragen

Der MCP-Server spricht JSON-RPC 2.0 über Streamable HTTP. Die meisten Agenten übernehmen das für dich, du kannst ihn aber auch direkt mit `curl` aufrufen.

```bash Tools auflisten theme={null}
curl -X POST https://api.so-me.studio/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "X-API-Key: sk_live_your_api_key" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list"
  }'
```

```bash Geplanten Beitrag erstellen theme={null}
curl -X POST https://api.so-me.studio/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "X-API-Key: sk_live_your_api_key" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "create_post",
      "arguments": {
        "text": "Big news coming Friday!",
        "socialMedia": "TWITTER",
        "postType": "TEXT",
        "scheduledAt": "2026-06-20T15:00:00.000Z"
      }
    }
  }'
```

```bash Generieren + planen in einem Aufruf theme={null}
curl -X POST https://api.so-me.studio/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "X-API-Key: sk_live_your_api_key" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "generate_and_schedule",
      "arguments": {
        "platform": "LINKEDIN",
        "socialMedia": "LINKEDIN",
        "topic": "Why async standups beat daily meetings",
        "tone": "professional",
        "scheduledAt": "2026-06-21T09:00:00.000Z"
      }
    }
  }'
```

## Einrichtungsanleitungen

Wähle deinen KI-Agenten, um loszulegen:

> **[Claude Code](/de/mcp/claude-code.md)**
>
> Das agentische Coding-Tool von Anthropic

> **[Claude Desktop](/de/mcp/claude-desktop.md)**
>
> Die Desktop-Anwendung von Anthropic

> **[Cursor](/de/mcp/cursor.md)**
>
> KI-first-Code-Editor

> **[OpenAI Codex](/de/mcp/codex.md)**
>
> Der Coding-Agent von OpenAI

> **[Windsurf](/de/mcp/windsurf.md)**
>
> KI-gestützte IDE von Codeium

> **[VS Code (Copilot)](/de/mcp/vscode.md)**
>
> GitHub Copilot im Agent-Modus

> **[Gemini CLI](/de/mcp/gemini-cli.md)**
>
> Der KI-Terminal-Agent von Google

## Fehlerbehebung

> **401 Unauthorized**
>
> Prüfe, ob dein API-Schlüssel korrekt und aktiv ist. Der Header muss genau `X-API-Key` lauten (Groß-/Kleinschreibung beachten). Erstelle bei Bedarf unter **Einstellungen → API** einen neuen Schlüssel.

> **405 Method Not Allowed bei GET/SSE**
>
> Der MCP-Server von Social media studio läuft zustandslos über Streamable HTTP. Es werden nur POST-Anfragen unterstützt. Stelle sicher, dass dein Agent mit HTTP-Transport konfiguriert ist, nicht mit SSE.

> **Rate limit exceeded**
>
> MCP-Tool-Aufrufe sind je nach Tarif pro Minute begrenzt. Prüfe deine Nutzung unter **Einstellungen → MCP / KI-Tools** und wechsle bei Bedarf auf einen höheren Tarif.

> **Credits exhausted**
>
> Jeder MCP-Tool-Aufruf verbraucht Credits. Prüfe die verbleibenden Credits unter **Einstellungen → MCP / KI-Tools**.

> **Verbindungs-Timeout**
>
> Erhöhe das Timeout in deiner MCP-Konfiguration. Empfohlen wird ein Wert von 30000 ms (30 Sekunden).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.