MCP Tool-Referenz

Implementierte Pressefeuer MCP-Tools

Diese Referenz listet nur Tools, die im aktuellen Pressefeuer-MCP registriert sind. Konzeptuelle oder geplante Tools werden nicht als verfügbar beschrieben.

Aufrufmuster

MCP-kompatible Clients lesen die verfuegbaren Tools aus und fuehren ausgewaehlte Aktionen mit strukturierten Argumenten aus. Die konkrete Verbindungskonfiguration kommt aus dem geschuetzten Dashboard.

Zugangsdaten und konkrete Verbindungsdetails gehoeren nicht in Prompts, Repositories oder oeffentliche Dokumente.

Wichtigste Grenzen

  • Es gibt keine öffentliche REST-v1-API für PMs.
  • publish_release ist kein Bypass für Freigabe, KI-Redaktion oder Payment-Gates.
  • generate_seo_metadata ist aktuell eine einfache Ableitung aus vorhandenem Inhalt.

Tools

Jede Karte nennt Pflichtfelder, optionale Felder, Rückgabe und die wichtigste Sicherheitsgrenze.

Mandanten

get_client_persona

Verfügbar

Ruft Mandanteninformationen und die erste hinterlegte Persona für konsistente Tonalität ab.

Pflichtfelder
client_id
Optionale Felder
Keine
Rückgabe
Mandant, Slug und Persona-Daten oder null, wenn keine Persona existiert.
Guardrail
Der Mandant muss zur authentifizierten Agentur gehören.

Entwürfe

create_draft

Verfügbar

Erstellt einen neuen Pressemitteilungs-Entwurf für einen Mandanten.

Pflichtfelder
client_id, title, content
Optionale Felder
persona_id, subtitle, tags, category
Rückgabe
draft_id, Status, Titel und Erstellzeitpunkt.
Guardrail
Der Entwurf wird als draft angelegt und nicht automatisch veröffentlicht. Eine persona_id wird nur akzeptiert, wenn sie zum Mandanten gehört.

Entwürfe

update_draft

Verfügbar

Aktualisiert Titel, Untertitel, Inhalt oder Tags eines bestehenden Entwurfs.

Pflichtfelder
draft_id
Optionale Felder
title, subtitle, content, tags
Rückgabe
success und draft_id.
Guardrail
Der Entwurf muss zur authentifizierten Agentur gehören und in einem bearbeitbaren Entwurfsstatus sein.

Entwürfe

list_drafts

Verfügbar

Listet Pressemitteilungen der Agentur, optional gefiltert nach Mandant oder Status.

Pflichtfelder
Keine
Optionale Felder
client_id, status, limit
Rückgabe
Liste mit ID, Titel, Status, Mandant und Erstellzeitpunkt.
Guardrail
Ein client_id-Filter wird gegen die Agentur-Mandanten geprüft.

Freigabe

send_approval_request

Verfügbar

Erstellt einen Magic-Link und sendet eine Freigabeanfrage per E-Mail.

Pflichtfelder
draft_id, recipient_email
Optionale Felder
recipient_name, message, expires_in_hours
Rückgabe
Magic-Link, Ablaufzeitpunkt, Status und E-Mail-Zustellungsergebnis.
Guardrail
Nur bearbeitbare Entwurfsstatus werden in den Freigabeprozess uebernommen; der Mailversand laeuft ueber die zentrale Versandlogik.

Freigabe

check_approval_status

Verfügbar

Prüft Status, Tokens und Activity Log einer Freigabeanfrage.

Pflichtfelder
draft_id
Optionale Felder
Keine
Rückgabe
press_release_status, approval_tokens und activity_log.
Guardrail
Nur PMs der authentifizierten Agentur sind abrufbar.

Veröffentlichung

publish_release

Verfügbar

Veröffentlicht eine freigegebene Pressemitteilung nur in eng definierten Fällen.

Pflichtfelder
press_release_id
Optionale Felder
Keine
Rückgabe
success und published_at.
Guardrail
Kein Freigabe-, KI-Review- oder Payment-Bypass. Normale PMs nutzen den regulaeren Publish-Workflow.

Abrechnung

get_agency_credits

Verfügbar

Ruft den aktuellen Credit-Stand der Agentur ab.

Pflichtfelder
Keine
Optionale Felder
Keine
Rückgabe
agency_id, agency_name und credit_balance.
Guardrail
Liefert nur Daten der authentifizierten Agentur.

Mandanten

list_clients

Verfügbar

Listet Mandanten der authentifizierten Agentur.

Pflichtfelder
Keine
Optionale Felder
limit
Rückgabe
Mandantenliste mit ID, Name und Slug.
Guardrail
Keine fremden Agenturmandanten.

SEO

generate_seo_metadata

Verfügbar

Leitet einfache SEO-Metadaten aus Titel, Inhalt und Tags einer PM ab.

Pflichtfelder
press_release_id
Optionale Felder
Keine
Rückgabe
Meta-Titel, Meta-Beschreibung, OG-Felder und Keywords.
Guardrail
Aktuell keine vollständige KI-SEO-Analyse; die Felder werden aus bestehendem PM-Inhalt abgeleitet.

Sicherheit und Authentifizierung

MCP-Zugriffe sind agenturgebunden. Lesen Sie die Security-Seite, bevor Sie einen Agenten mit Schreibrechten arbeiten lassen.