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

  • Die öffentliche REST-v1-API ist auf Reporting im Agency-Plan beschränkt; Entwurf und Veröffentlichung laufen weiterhin über MCP und geschützte Produktworkflows.
  • 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.

Reporting

get_article_performance

Verfügbar

Ruft den aktuellen Performance-Datensatz einer veröffentlichten Pressemitteilung ab.

Pflichtfelder
press_release_id
Optionale Felder
days
Rückgabe
Messwerte, Zeitreihen, Traffic-Klassen, Interaktionen, Datenqualität und externe Beobachtungen.
Guardrail
Nur im Agency-Plan; die Pressemitteilung muss zur authentifizierten Agentur gehören und days liegt zwischen 1 und 365.

Reporting

create_publication_report

Verfügbar

Erstellt einen unveränderlichen Performance-Bericht für eine Pressemitteilung.

Pflichtfelder
press_release_id
Optionale Felder
days
Rückgabe
Berichts-ID, Snapshot, Methodik und Erstellungszeitpunkt.
Guardrail
Erstellt nur agentureigene Berichte; ein gespeicherter Snapshot wird durch spätere Analytics-Daten nicht verändert.

Reporting

get_publication_report

Verfügbar

Ruft einen unveränderlichen Publication Report anhand seiner UUID ab.

Pflichtfelder
report_id
Optionale Felder
Keine
Rückgabe
Gespeicherter Bericht mit Snapshot und Branding.
Guardrail
Die Berichts-ID muss zur authentifizierten Agentur gehören; fremde Berichte bleiben unsichtbar.

Reporting

list_publication_reports

Verfügbar

Listet die zuletzt erstellten Publication Reports der Agentur.

Pflichtfelder
Keine
Optionale Felder
press_release_id, limit
Rückgabe
Bis zu 100 Berichte, optional auf eine Pressemitteilung eingeschränkt.
Guardrail
Die Liste bleibt auf die authentifizierte Agentur beschränkt; ein Artikel-Filter wird ebenfalls geprüft.

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.