Tool-Referenz - StickyPrompts Docs

Jedes Tool, das der MCP-Server von StickyPrompts für API-Schlüssel bereitstellt, nach Bereichen gruppiert, mit seinen Argumenten, der erforderlichen Berechtigung, der Angabe, ob es schreibt, und dem Aufbau seines Ergebnisses.

Dies ist die vollständige Liste der Tools, die ein API-Schlüssel sehen kann. Ihr Client sieht nur die Tools, für die Ihr Schlüssel die Berechtigung hat. Siehe MCP im Überblick. Jedes Tool liefert ein Text-Element mit einem JSON-Dokument. Den Aufbau des Ergebnisses finden Sie bei jedem Tool.

So lesen Sie diese Seite. Tools mit Lesen lesen nur. Tools mit Schreiben legen etwas an, ändern, löschen oder senden etwas. Tools mit Asynchron antworten, bevor die Arbeit erledigt ist, und Sie müssen ihren Status anschließend abfragen. Argumente vom Typ number werden als Ganzzahlen gelesen, sofern nicht anders angegeben. Paginierte Tools nehmen limit und offset entgegen und liefern total_count, limit und offset zurück.

Auf einen Blick

Bereich	Tools
Chat und Unterhaltungen	`send_message`, `get_conversation`, `list_conversations`, `delete_conversation`
Prompts und Ausführungen	`list_prompts`, `get_prompt`, `run_prompt`, `custom_run`, `list_ai_models`
Agenten und Workflows	`list_agents`, `get_agent`, `list_workflow_tasks`, `get_workflow_task`, `run_workflow_task`
Wissen und Dateien	`list_knowledge_bases`, `search_knowledge_base`, `list_files`, `get_file`
Projekte und Teams	`list_projects`, `get_project`, `create_project`, `delete_project`, `list_workspace_members`, `list_teams`, `list_team_members`
Mediengenerierung	`generate_image`, `edit_image`, `generate_video`, `get_video_generation_status`, `delete_video_generation`, `generate_speech`, `get_tts_generation_status`, `delete_tts_generation`, `generate_music`, `get_music_generation_status`, `delete_music_generation`
Transkription	`transcribe`, `get_transcription_status`, `delete_transcription`
Tabellen	`list_spreadsheet_processing_tasks`, `get_spreadsheet_processing_task`, `start_spreadsheet_processing`, `pause_spreadsheet_processing`, `resume_spreadsheet_processing`
Integrationen: E-Mail	`list_email_connections`, `send_email`
Integrationen: CRM	`list_crm_connections`, `search_crm_contacts`, `list_crm_contacts`, `add_crm_contact`, `edit_crm_contact`, `search_crm_deals`, `list_crm_deals`, `create_crm_deal`, `list_crm_lists`, `list_crm_tags`
Integrationen: Datenbanken	`list_database_connections`, `list_database_tables`, `describe_database_tables`, `run_database_query`
Integrationen: Speicher	`list_storage_connections`, `browse_storage_folder`, `search_storage_files`, `get_storage_entry`, `import_storage_files`, `export_file_to_storage`
Suche	`search`
Nur für Mitarbeiter	`get_usage_statistics`

Chat und Unterhaltungen

send_message

Sendet eine Nachricht an ein KI-Modell und liefert dessen Antwort, synchron. Lassen Sie conversation_id weg, um eine neue Unterhaltung zu beginnen, oder übergeben Sie eine ID, um eine bestehende fortzusetzen. Dabei entsteht oder ändert sich genau die Unterhaltung, die Sie auch in der StickyPrompts-App sehen.

Schreiben Berechtigung conversations_manage

Argumente

message string erforderlich: Die zu sendende Nachricht.
conversation_id number optional: Eine bestehende Unterhaltung, die Ihnen gehört. Weglassen, um eine neue zu beginnen.
ai_model_id number optional: Das Modell für eine neue Unterhaltung, aus list_ai_models. Wird beim Fortsetzen einer Unterhaltung ignoriert, denn diese behält ihr eigenes Modell. Bei einer neuen Unterhaltung immer übergeben: Ohne den Wert schlägt der Aufruf derzeit mit no AI model is selected, try reselecting model fehl.

Ergebnis: {"conversation_id": <id>, "text": "<assistant reply>"}. Erwähnt eine Nachricht einen Ihrer Agenten über dessen Tag (@mentions), wird sie wie in der App an diesen Agenten weitergeleitet. Fehler: Tool-Fehler conversation not found. Fehler beim Modell und beim Anbieter sind JSON-RPC-Fehler.

get_conversation

Liefert eine Unterhaltung, die Ihnen gehört, einschließlich ihres Nachrichtenverlaufs.

Lesen Berechtigung conversations_get

Argumente

conversation_id number erforderlich: Die zu lesende Unterhaltung.

Ergebnis: {"id", "name", "messages": [{"is_user": bool, "text": "..."}]}. Fehler: Tool-Fehler conversation not found.

list_conversations

Listet Ihre eigenen interaktiven Unterhaltungen seitenweise auf, die zuletzt aktualisierten zuerst. Unterhaltungen, die im Team geteilt sind oder zu Agenten gehören, sind nicht enthalten.

Lesen Berechtigung conversations_get

Argumente

search string optional: Wird mit dem Nachrichtentext abgeglichen.
limit number optional Standard 20: Seitengröße.
offset number optional Standard 0: Anzahl der zu überspringenden Einträge.

Ergebnis: {"conversations": [{"id", "name"}], "total_count", "limit", "offset"}.

delete_conversation

Löscht eine Unterhaltung, die Ihnen gehört.

Schreiben Destruktiv Berechtigung conversations_delete

Argumente

conversation_id number erforderlich: Die zu löschende Unterhaltung.

Ergebnis: {"deleted": true}. Fehler: Tool-Fehler conversation not found.

Prompts und Ausführungen

list_prompts

Listet Ihre eigenen Prompts seitenweise auf, ohne projektgebundene Prompts und ohne Prompts, die mit Ihnen geteilt wurden. Rufen Sie danach get_prompt auf, um die Variablen eines Prompts zu sehen, bevor Sie run_prompt aufrufen.

Lesen Berechtigung prompts_get

Argumente

search string optional: Wird mit Name und Beschreibung abgeglichen.
limit number optional Standard 20: Seitengröße.
offset number optional Standard 0: Anzahl der zu überspringenden Einträge.

Ergebnis: {"prompts": [{"id", "name", "slug", "description", "is_favorite"}], "total_count", "limit", "offset"}.

get_prompt

Liefert einen Prompt, der Ihnen gehört, einschließlich des Inhalts seiner aktuellen Version und der Variablen, die er akzeptiert.

Lesen Berechtigung prompts_get

Argumente

id string erforderlich: Numerische ID oder Slug.

Ergebnis: {"id", "name", "slug", "description", "content", "variables": [{"slug", "name", "description", "required", "default_value"}]}. Fehler: Tool-Fehler prompt not found, auch bei Prompts, die mit Ihnen geteilt wurden, Ihnen aber nicht gehören.

run_prompt

Füllt die Variablen eines Prompts aus, führt ihn mit einem Modell aus und liefert den Antworttext. Läuft als einzelner, losgelöster Aufruf und legt in der App keine interaktive Unterhaltung an.

Schreiben Berechtigung run_prompt

Argumente

id string erforderlich: Numerische ID oder Slug eines Prompts, der Ihnen gehört.
ai_model_id number erforderlich: Aus list_ai_models. Einen Wert "auto" gibt es nicht.
variables object optional: Zuordnung von Variablen-Slug zu einem String-Wert, zum Beispiel {"customer": "Bluebird Market"}. Weggelassene Variablen erhalten ihren Standardwert, unbekannte Schlüssel werden ignoriert.

Ergebnis: {"text": "<model response>"}. Fehler: die Tool-Fehler prompt not found, prompt has no current version, variable "<slug>" must be a string, missing a value for a required variable oder die Meldung zu sensiblen Daten, wenn ein Guardrail den ausgefüllten Prompt blockiert. Fehler beim Modell und beim Anbieter sind JSON-RPC-Fehler.

custom_run

Führt reinen Prompt-Text mit einem Modell aus und liefert den Antworttext, ohne gespeicherten Prompt. Läuft als einzelner, losgelöster Aufruf und legt keine Unterhaltung an.

Schreiben Berechtigung custom_run

Argumente

prompt string erforderlich: Der zu sendende Text.
ai_model_id number erforderlich: Aus list_ai_models.

Ergebnis: {"text": "<model response>"}.

list_ai_models

Listet die Modelle auf, mit denen Sie Ausführungen starten können. Ausgenommen sind Modelle, die Ihr Workspace sperrt (einschließlich der Regeln zur Datenresidenz), und standardmäßig veraltete Modelle.

Lesen Berechtigung ai_models_get

Argumente

search string optional: Wird mit dem Modellnamen abgeglichen.
include_deprecated boolean optional Standard false: Veraltete Modelle einschließen.

Ergebnis: {"models": [{"id", "name", "powered_by", "description", "premium"}]}, in der Sortierreihenfolge der Plattform.

Agenten und Workflows

list_agents

Listet Ihre eigenen Agenten auf, ohne Agenten, die ein Team oder der Workspace mit Ihnen geteilt hat. Nicht paginiert.

Lesen Berechtigung agents_get

Argumente

search string optional: Wird mit dem Namen des Agenten abgeglichen.

Ergebnis: {"agents": [{"id", "name", "slug", "tag"}]}. Den tag verwenden Sie für eine @mention in send_message.

get_agent

Liefert einen Agenten, auf den Sie Zugriff haben, einschließlich seines System-Prompts und des konfigurierten Modells.

Lesen Berechtigung agents_get

Argumente

id string erforderlich: Numerische ID oder Slug.

Ergebnis: {"id", "name", "slug", "description", "system_prompt", "ai_model_id", "ai_model_name"}. Fehler: die Tool-Fehler agent not found und you don't have access to this agent.

list_workflow_tasks

Listet Ihre eigenen geplanten Workflow-Aufgaben seitenweise auf.

Lesen Berechtigung workflow_tasks_get

Argumente

search string optional: Abgleich mit dem Namen, ohne Unterscheidung von Groß- und Kleinschreibung.
limit number optional Standard 20: Seitengröße.
offset number optional Standard 0: Anzahl der zu überspringenden Einträge.

Ergebnis: {"workflow_tasks": [{"id", "name", "slug", "enabled"}], "total_count", "limit", "offset"}.

get_workflow_task

Liefert eine Workflow-Aufgabe, die Sie verwalten, einschließlich ihrer Anweisungen und ihrer Erfolgsquote.

Lesen Berechtigung workflow_tasks_get

Argumente

id string erforderlich: Numerische ID oder Slug.

Ergebnis: {"id", "name", "slug", "description", "instructions", "enabled", "total_run_count", "success_rate"}. Fehler: Tool-Fehler workflow task not found or access denied.

run_workflow_task

Startet sofort eine Ausführung einer Workflow-Aufgabe, außerhalb ihres Zeitplans. Antwortet direkt mit ID und Status der neuen Ausführung und wartet nicht, bis sie abgeschlossen ist.

Schreiben Asynchron Berechtigung workflow_tasks_manage

Argumente

id string erforderlich: Numerische ID oder Slug.

Ergebnis: {"execution_id": <id>, "status": "running"}. Ein MCP-Tool, das das Ergebnis einer Ausführung liest, gibt es nicht. Sobald sie abgeschlossen ist, spiegeln total_run_count und success_rate von get_workflow_task sie wider. Ist das Kontingent des Inhabers erschöpft, schlägt die Ausführung mit quota exceeded fehl. Fehler: Tool-Fehler workflow task not found or access denied.

Wissen und Dateien

list_knowledge_bases

Listet die Wissensdatenbanken auf, die Ihnen gehören oder auf die Sie Zugriff erhalten haben.

Lesen Berechtigung knowledge_bases_get

Keine Argumente. Ergebnis: {"knowledge_bases": [{"id", "name", "description"}]}.

search_knowledge_base

Durchsucht eine Wissensdatenbank nach Passagen, die zu einer Suchanfrage passen, und liefert die Passagen samt den Dateien, aus denen sie stammen. Das ist dieselbe semantische Suche, die auch eine Unterhaltung verwendet. Ein REST-Gegenstück gibt es nicht.

Lesen Berechtigung knowledge_bases_get

Argumente

knowledge_base_id number erforderlich: Aus list_knowledge_bases.
query string erforderlich: Wonach gesucht werden soll.

Ergebnis: {"context": "<retrieved passages as text>", "files": [{"id", "name"}]}. Wird als Nutzung der Wissensdatenbank erfasst. Fehler: Tool-Fehler knowledge base not found or access denied oder die Fehlermeldung der Suche.

list_files

Listet Ihre eigenen hochgeladenen und generierten Dateien seitenweise auf, die neuesten zuerst. Ein MCP-Tool zum Hochladen von Dateien gibt es nicht.

Lesen Berechtigung files_get

Argumente

limit number optional Standard 20: Seitengröße.
offset number optional Standard 0: Anzahl der zu überspringenden Einträge.

Ergebnis: {"files": [{"id", "name", "file_type"}], "total_count", "limit", "offset"}.

get_file

Liefert die Metadaten einer Datei, die Ihnen gehört, zum Beispiel um ihre ID an edit_image zu übergeben.

Lesen Berechtigung files_get

Argumente

id number erforderlich: Die Datei-ID.

Ergebnis: {"id", "name", "file_type"}, ohne URL und ohne Inhalt. Fehler: Tool-Fehler file not found or access denied.

Projekte und Teams

list_projects

Listet die Projekte seitenweise auf, die Ihnen gehören oder mit Ihnen geteilt wurden.

Lesen Berechtigung projects_get

Argumente

search string optional: Abgleich mit Name und Beschreibung, ohne Unterscheidung von Groß- und Kleinschreibung.
limit number optional Standard 20: Seitengröße.
offset number optional Standard 0: Anzahl der zu überspringenden Einträge.

Ergebnis: {"projects": [{"id", "name", "slug", "description"}], "total_count", "limit", "offset"}.

get_project

Liefert ein Projekt, auf das Sie Zugriff haben.

Lesen Berechtigung projects_get

Argumente

id string erforderlich: Numerische ID oder Slug.

Ergebnis: {"id", "name", "slug", "description", "instructions"}. Fehler: die Tool-Fehler project not found und you don't have access to this project.

create_project

Legt ein neues Projekt an, das Ihnen gehört.

Schreiben Berechtigung projects_manage

Argumente

name string erforderlich: Projektname.
description string optional: Kurze Beschreibung.

Ergebnis: {"id", "slug", "name"}.

delete_project

Löscht ein Projekt, das Ihnen gehört. Nur der Inhaber kann löschen.

Schreiben Destruktiv Berechtigung projects_delete

Argumente

id string erforderlich: Numerische ID oder Slug.

Ergebnis: {"deleted": true}. Fehler: die Tool-Fehler project not found und you don't have access to this project.

list_workspace_members

Listet die Mitglieder Ihres Workspace seitenweise auf.

Lesen Berechtigung organization_get

Argumente

search string optional: Wird mit Name und E-Mail-Adresse abgeglichen.
limit number optional Standard 20: Seitengröße.
offset number optional Standard 0: Anzahl der zu überspringenden Einträge.

Ergebnis: {"members": [{"id", "email", "first_name", "last_name", "is_owner", "permissions": [...]}], "total_count", "limit", "offset"}. Der Inhaber des Workspace erscheint immer mit permissions: ["admin"].

list_teams

Listet alle Teams in Ihrem Workspace auf. Nicht paginiert.

Lesen Berechtigung teams_get

Argumente

search string optional: Wird mit Teamname und Beschreibung abgeglichen.

Ergebnis: {"teams": [{"id", "name", "description", "color", "member_count"}]}.

list_team_members

Listet die Mitglieder eines Teams seitenweise auf. Sie müssen Workspace-Admin oder Mitglied des Teams sein.

Lesen Berechtigung teams_get

Argumente

team_id number erforderlich: Aus list_teams.
search string optional: Wird mit Name und E-Mail-Adresse des Mitglieds abgeglichen.
limit number optional Standard 20: Seitengröße.
offset number optional Standard 0: Anzahl der zu überspringenden Einträge.

Ergebnis: {"members": [{"id", "email", "first_name", "last_name", "role"}], "total_count", "limit", "offset"}. Fehler: die JSON-RPC-Fehler team not found und not authorized to view the members of this team.

Mediengenerierung

Die Medien-Tools nehmen kein Modellargument entgegen: StickyPrompts verwendet für jedes Medium das konfigurierte Modell. Ergebnisse enthalten path, die direkte URL der gespeicherten Datei (kein signierter oder ablaufender Link), und _attachments, eine Liste von Einträgen der Form {"type": "file", "id": <file id>}, deren IDs Sie an andere Tools übergeben können.

generate_image

Generiert ein Bild aus einem Prompt.

Schreiben Berechtigung image_generation_manage

Argumente

prompt string erforderlich: Der Bild-Prompt. Im veröffentlichten Schema nicht als Pflichtfeld markiert, ohne ihn schlägt der Aufruf aber fehl.

Ergebnis (synchron): {"path": "<storage URL>", "_attachments": [{"type": "file", "id": <file id>}]}.

edit_image

Bearbeitet ein vorhandenes Bild anhand von Anweisungen. Liefert eine neue Datei.

Schreiben Berechtigung image_generation_manage

Argumente

prompt string erforderlich: Die Bearbeitungsanweisungen. Im veröffentlichten Schema nicht als Pflichtfeld markiert, ohne sie schlägt der Aufruf aber fehl.
file_id number erforderlich: Die zu bearbeitende Bilddatei. Sie muss Ihnen gehören. Im veröffentlichten Schema nicht als Pflichtfeld markiert, ohne sie schlägt der Aufruf aber fehl.

Ergebnis: derselbe Aufbau wie bei generate_image, mit einer neuen Datei-ID. Fehler: JSON-RPC-Fehler file not found or access denied.

generate_video

Startet die Generierung eines Videos aus einem Prompt und animiert optional ein Startbild. Antwortet sofort mit ID und Status der Generierung. Fragen Sie get_video_generation_status ab, bis done oder error gemeldet wird. Die Generierung kann mehrere Minuten dauern.

Schreiben Asynchron Berechtigung video_generation_manage

Argumente

prompt string erforderlich: Der Video-Prompt.
starting_image_file_id number optional: Eine Bilddatei, die als erstes Bild animiert wird.
last_frame_file_id number optional: Eine Bilddatei für das letzte Bild. Erfordert starting_image_file_id und lässt sich nicht mit reference_image_ids kombinieren.
reference_image_ids array of integer optional: Bilddateien, die als Referenz dienen. Lässt sich nicht mit starting_image_file_id oder last_frame_file_id kombinieren.
aspect_ratio string optional Standard 16:9: Zum Beispiel "16:9". Muss ein Seitenverhältnis sein, das das Modell unterstützt.
resolution string optional: Zum Beispiel "1080p". Standard ist die erste vom Modell unterstützte Auflösung.
duration_seconds number optional: Standard ist das Maximum des Modells. Muss im Bereich liegen, den das Modell für die gewählte Auflösung zulässt.

Ergebnis: {"id": <video generation id>, "status": "queued"}. Fehler: JSON-RPC-Fehler bei einem nicht unterstützten Seitenverhältnis, einer nicht unterstützten Auflösung oder Dauer, einer ungültigen Bildkombination oder einem Modell, das Ihr Workspace nicht verwenden darf.

get_video_generation_status

Prüft eine mit generate_video gestartete Videogenerierung. Der Status ist queued, processing, done oder error. Solange er queued oder processing lautet, warten Sie (zum Beispiel 15-60 Sekunden) und fragen erneut ab.

Lesen Berechtigung video_generation_get

Argumente

video_generation_id number erforderlich: Die von generate_video gelieferte ID.

Ergebnis: {"id", "status"}, dazu error, wenn der Status error ist, oder path und _attachments, wenn er done ist. Fehler: „nicht gefunden“ ist ein JSON-RPC-Fehler.

delete_video_generation

Löscht eine Videogenerierung, die Ihnen gehört.

Schreiben Destruktiv Berechtigung video_generation_delete

Argumente

video_generation_id number erforderlich: Die ID der Videogenerierung.

Ergebnis: {"deleted": true}.

generate_speech

Wandelt Text in gesprochene Sprache um. Antwortet, sobald das Audio fertig ist.

Schreiben Berechtigung tts_generation_manage

Argumente

text string erforderlich: Der zu sprechende Text.
voice string optional: Kennung der Stimme. Standard ist die Standardstimme des Modells.
language string optional: Standardmäßig wird die Sprache aus dem Text erkannt. Wird abgelehnt, wenn das Modell unterstützte Sprachen angibt und dieser Wert nicht dazugehört.

Ergebnis (synchron): {"path": "<storage URL>", "_attachments": [{"type": "file", "id": <file id>}]}. Eine Generierungs-ID wird nicht zurückgegeben.

get_tts_generation_status

Prüft eine frühere Sprachausgabe (Text-to-Speech). Der Status ist queued, processing, done oder error. Da generate_speech keine Generierungs-ID zurückgibt, verwenden Sie eine ID aus der App oder der REST-API.

Lesen Berechtigung tts_generation_get

Argumente

tts_generation_id number erforderlich: Die ID der Sprachgenerierung.

Ergebnis: {"id", "status"}, dazu error oder, wenn fertig, path und _attachments. Fehler: Tool-Fehler tts generation not found.

delete_tts_generation

Löscht eine Sprachausgabe (Text-to-Speech), die Ihnen gehört.

Schreiben Destruktiv Berechtigung tts_generation_delete

Argumente

tts_generation_id number erforderlich: Die ID der Sprachgenerierung.

Ergebnis: {"deleted": true}.

generate_music

Generiert ein Musikstück aus einem Text-Prompt. Antwortet, sobald das Audio fertig ist.

Schreiben Berechtigung music_generation_manage

Argumente

prompt string erforderlich: Der Musik-Prompt.
duration_seconds number optional: Standard ist das Maximum des Modells.
output_format string optional: Zum Beispiel "mp3" oder "wav". Standard ist das Standardformat des Modells.
instrumental boolean optional Standard false: Nur instrumental, ohne Gesang und ohne Songtext.

Ergebnis (synchron): {"path", "duration_seconds", "_attachments"}, dazu lyrics, wenn das Modell einen Songtext erzeugt hat. Eine Generierungs-ID wird nicht zurückgegeben.

get_music_generation_status

Prüft eine frühere Musikgenerierung. Der Status ist queued, processing, done oder error. Da generate_music keine Generierungs-ID zurückgibt, verwenden Sie eine ID aus der App oder der REST-API.

Lesen Berechtigung music_generation_get

Argumente

music_generation_id number erforderlich: Die ID der Musikgenerierung.

Ergebnis: {"id", "status"}, dazu error oder, wenn fertig, path, duration_seconds und _attachments (sowie lyrics, falls vorhanden). Fehler: Tool-Fehler music generation not found.

delete_music_generation

Löscht eine Musikgenerierung, die Ihnen gehört.

Schreiben Destruktiv Berechtigung music_generation_delete

Argumente

music_generation_id number erforderlich: Die ID der Musikgenerierung.

Ergebnis: {"deleted": true}.

Transkription

transcribe

Transkribiert Audio oder Video von einer öffentlichen URL in Text. Antwortet, sobald das Transkript fertig ist. Geben Sie Ihrem Client für lange Medien daher ein großzügiges Timeout.

Schreiben Berechtigung transcription_manage

Argumente

url string erforderlich: Öffentliche URL einer Audio- oder Videodatei.

Ergebnis (synchron): {"text": "<transcript>", "_attachments": [{"type": "transcription", "id": <transcription id>}]}. Die ID der Transkription steht nur in _attachments.

get_transcription_status

Prüft eine frühere Transkription. Der Status ist queued, fetching, preparing, processing, done oder error.

Lesen Berechtigung transcription_get

Argumente

transcription_id number erforderlich: Die ID der Transkription.

Ergebnis: {"id", "status"}, dazu error oder, wenn fertig, text und _attachments. Fehler: Tool-Fehler transcription not found.

delete_transcription

Löscht eine Transkription, die Ihnen gehört.

Schreiben Destruktiv Berechtigung transcription_delete

Argumente

transcription_id number erforderlich: Die ID der Transkription.

Ergebnis: {"deleted": true}.

Tabellen

Die Tabellenverarbeitung führt eine Prompt-Vorlage für jede Zeile eines xlsx-Tabellenblatts aus und schreibt die Antwort in eine Ausgabespalte. Alle fünf Tools liefern ein Aufgabenobjekt: {"task_id", "status", "processed_rows", "total_rows", "original_file_id", "created_at", "credit_cost"}, dazu error, result_preview, eta und generated_file_id, sofern vorhanden. Mögliche Statuswerte: queued, initializing, processing, paused, done, error.

list_spreadsheet_processing_tasks

Listet Ihre eigenen Aufgaben zur Tabellenverarbeitung seitenweise auf.

Lesen Berechtigung spreadsheet_processing_get

Argumente

limit number optional Standard 20: Seitengröße.
offset number optional Standard 0: Anzahl der zu überspringenden Einträge.

Ergebnis: {"tasks": [task], "total_count", "limit", "offset"}.

get_spreadsheet_processing_task

Liefert Status und Fortschritt einer Aufgabe, die Ihnen gehört.

Lesen Berechtigung spreadsheet_processing_get

Argumente

task_id string erforderlich: Die von start_spreadsheet_processing gelieferte ID.

Ergebnis: ein Aufgabenobjekt. Fehler: Tool-Fehler task not found. Eine Abfrage direkt nach dem Start kann diesen Fehler kurzzeitig melden, solange die Aufgabe noch angelegt wird.

start_spreadsheet_processing

Startet die Verarbeitung einer xlsx-Datei, die bereits in StickyPrompts liegt. Läuft im Hintergrund und liefert sofort eine task_id. Fragen Sie get_spreadsheet_processing_task ab, bis der Status done oder error lautet.

Schreiben Asynchron Berechtigung spreadsheet_processing_manage

Argumente

file_id number erforderlich: Eine xlsx-Datei, die Ihnen gehört. Laden Sie sie in der App oder über die REST-API hoch oder holen Sie sie mit import_storage_files.
prompt_template string erforderlich: Der Prompt, der für jede Zeile ausgeführt wird.
output_column string erforderlich: Spaltenbuchstabe für die Ergebnisse, zum Beispiel "D".
ai_model_id number erforderlich: Aus list_ai_models.
sheet_index number optional Standard 0: Index des Tabellenblatts, beginnend bei null.
skip_non_empty_cells boolean optional Standard false: Zeilen auslassen, deren Ausgabezelle bereits einen Wert enthält.

Ergebnis: {"task_id": "<32-character id>"}. Fehler: Tool-Fehler file not found.

pause_spreadsheet_processing

Pausiert eine laufende Aufgabe, die Ihnen gehört. Nur Aufgaben mit dem Status queued, initializing oder processing lassen sich pausieren.

Schreiben Berechtigung spreadsheet_processing_manage

Argumente

task_id string erforderlich: Die zu pausierende Aufgabe.

Ergebnis: das Aufgabenobjekt. Fehler: die Tool-Fehler task not found, file processing cannot be paused currently, file processing is already paused, file processing is already finished und file processing is not running.

resume_spreadsheet_processing

Setzt eine pausierte Aufgabe fort, die Ihnen gehört. Sie wird erneut in die Warteschlange gestellt, und eine bereits teilweise erzeugte Ausgabedatei wird verworfen und neu erstellt.

Schreiben Asynchron Berechtigung spreadsheet_processing_manage

Argumente

task_id string erforderlich: Die fortzusetzende Aufgabe.

Ergebnis: das Aufgabenobjekt mit status: "queued". Fehler: die Tool-Fehler task not found, file processing is already running, file processing is already finished und file processing is not paused.

Integrationen: E-Mail

Funktioniert mit dem E-Mail-Konto, das in StickyPrompts verbunden ist (Postmark, Resend, SendGrid oder SMTP). Verbindungen richten Sie in der App ein. Siehe E-Mail-Versand.

list_email_connections

Listet die E-Mail-Konten auf, die Sie verbunden haben, persönliche wie mit Ihrem Workspace geteilte. Liefert eine leere Liste, wenn keines verbunden ist.

Lesen Berechtigung integration_email_get

Keine Argumente. Ergebnis: {"connections": [{"connection_id", "provider", "name", "description", "sends_from"}]}.

send_email

Sendet eine E-Mail über eines Ihrer verbundenen E-Mail-Konten. Die Mail wird tatsächlich zugestellt, und das lässt sich nicht rückgängig machen. Prüfen Sie Empfänger und Inhalt daher vor dem Aufruf. Entweder html_body oder text_body ist erforderlich.

Schreiben Berechtigung integration_email_manage

Argumente

connection_id number erforderlich: Aus list_email_connections.
to array of string erforderlich: E-Mail-Adressen der Empfänger.
subject string erforderlich: Betreffzeile.
html_body string optional: HTML-Body. Senden Sie diesen, text_body oder beides.
text_body string optional: Body als reiner Text.
cc array of string optional: Empfänger in Kopie (CC).
bcc array of string optional: Empfänger in Blindkopie (BCC).
reply_to array of string optional: Antwortadressen.
from_email string optional: Überschreibt den Standardabsender der Verbindung. Ihr E-Mail-Anbieter lehnt Adressen ab, die er nicht verifiziert hat.
from_name string optional: Name des Absenders, zusammen mit from_email verwendet.
attachment_file_ids array of number optional: Anzuhängende Dateien. Mit einem API-Schlüssel schlägt das derzeit mit you do not have permission to use this file fehl, weil Anhänge über eine Unterhaltung in der App aufgelöst werden. Senden Sie ohne Anhänge.

Ergebnis: {"message_id": "...", "provider": "..."}.

Integrationen: CRM

Funktioniert mit ActiveCampaign, Brevo oder Pipedrive, sofern in StickyPrompts verbunden. Siehe CRM. Die schreibenden Tools (add_crm_contact, edit_crm_contact, create_crm_deal) setzen außerdem voraus, dass die Verbindung selbst Schreibzugriff erlaubt. Standardmäßig sind Verbindungen schreibgeschützt.

list_crm_connections

Listet die CRM-Konten auf, die Sie verbunden haben, persönliche wie mit Ihrem Workspace geteilte. Liefert eine leere Liste, wenn keines verbunden ist.

Lesen Berechtigung integration_crm_get

Keine Argumente. Ergebnis: {"connections": [{"connection_id", "provider", "name", "description"}]}.

search_crm_contacts

Durchsucht die Kontakte in einem verbundenen CRM. Verwenden Sie das Tool vor edit_crm_contact, um den Kontakt zu finden, oder vor add_crm_contact, um Dubletten zu vermeiden.

Lesen Berechtigung integration_crm_get

Argumente

connection_id number erforderlich: Aus list_crm_connections.
query string erforderlich: Ein Name, eine E-Mail-Adresse oder ein Unternehmen, wenn der Anbieter Freitextsuche unterstützt, andernfalls eine exakte E-Mail-Adresse oder ID.
filters object optional: String-Werte, zum Beispiel list_id, tag_id oder status bei ActiveCampaign, organization_id bei Pipedrive.

Ergebnis: {"contacts": [{"remote_id", "provider", "contact"}]}.

list_crm_contacts

Blättert seitenweise durch die Kontakte, in der Reihenfolge des Anbieters und ohne Suchanfrage.

Lesen Berechtigung integration_crm_get

Argumente

connection_id number erforderlich: Aus list_crm_connections.
limit number optional: Seitengröße, je nach Anbieter begrenzt.
offset number optional: Anzahl der zu überspringenden Einträge. Wird von Pipedrive ignoriert.
cursor string optional: Nur Pipedrive: der next_cursor der vorherigen Seite.
filters object optional: Anbieterspezifische Filter, zum Beispiel filter_id bei Pipedrive.

Ergebnis: {"contacts": [...], "has_more": bool, "next_cursor": "..."} (next_cursor entfällt, wenn leer).

add_crm_contact

Legt einen neuen Kontakt an. Erstellt immer einen neuen Kontakt und aktualisiert nie einen bestehenden.

Schreiben Berechtigung integration_crm_manage

Argumente

connection_id number erforderlich: Aus list_crm_connections.
email string erforderlich: Die E-Mail-Adresse des Kontakts.
first_name string optional: Vorname.
last_name string optional: Nachname.
phone string optional: Telefonnummer.
company string optional: Unternehmen.
custom_fields object optional: Anbieterspezifische Felder mit String-Werten. Unbekannte Schlüssel werden ignoriert.
list_ids array of string optional: Nur Brevo und ActiveCampaign. Fügt den Kontakt diesen Listen hinzu.
tag_ids array of string optional: Nur ActiveCampaign. Fügt diese Tags hinzu.

Ergebnis: {"remote_id", "provider", "contact": {...}}.

edit_crm_contact

Bearbeitet einen bestehenden Kontakt, der über seine E-Mail-Adresse gefunden wird. Schlägt fehl, wenn es keinen Kontakt mit dieser Adresse gibt. Das Tool legt nie einen neuen an.

Schreiben Berechtigung integration_crm_manage

Argumente

connection_id number erforderlich: Aus list_crm_connections.
email string erforderlich: Der Suchschlüssel, kein neuer Wert.
first_name string optional: Neuer Vorname.
last_name string optional: Neuer Nachname.
phone string optional: Neue Telefonnummer.
company string optional: Neues Unternehmen.
custom_fields object optional: Anbieterspezifische Felder mit String-Werten.
list_ids array of string optional: Nur Brevo und ActiveCampaign. Fügt nur hinzu, entfernt nichts.
tag_ids array of string optional: Nur ActiveCampaign. Fügt nur hinzu, entfernt nichts.

Weggelassene Felder bleiben unverändert. Ein ausdrücklich gesendeter leerer String leert das Feld. Ergebnis: {"remote_id", "provider", "contact": {...}}.

search_crm_deals

Sucht Deals nach Titel oder nach der E-Mail-Adresse des verknüpften Kontakts. Verwenden Sie das Tool vor create_crm_deal, um zu prüfen, ob es den Deal schon gibt.

Lesen Berechtigung integration_crm_get

Argumente

connection_id number erforderlich: Aus list_crm_connections.
query string erforderlich: Ein Deal-Titel oder die E-Mail-Adresse eines Kontakts.
filters object optional: Zum Beispiel status, stage_id oder owner_id bei ActiveCampaign und Pipedrive, contact_ids oder company_ids bei Brevo.

Ergebnis: {"deals": [{"remote_id", "provider", "deal"}]}.

list_crm_deals

Blättert seitenweise durch die Deals, in der Reihenfolge des Anbieters. Nicht jeder CRM-Anbieter verwaltet Deals. Prüfen Sie daher zuerst den Anbieter der Verbindung.

Lesen Berechtigung integration_crm_get

Argumente

connection_id number erforderlich: Aus list_crm_connections.
limit number optional: Seitengröße, je nach Anbieter begrenzt.
offset number optional: Anzahl der zu überspringenden Einträge. Wird von Pipedrive ignoriert.
cursor string optional: Nur Pipedrive: der next_cursor der vorherigen Seite.
filters object optional: Anbieterspezifische Filter.

Ergebnis: {"deals": [...], "has_more", "next_cursor"}.

create_crm_deal

Legt einen Deal an, der mit einem bestehenden Kontakt verknüpft ist. Nicht jeder CRM-Anbieter verwaltet Deals. Prüfen Sie daher zuerst den Anbieter der Verbindung.

Schreiben Berechtigung integration_crm_manage

Argumente

connection_id number erforderlich: Aus list_crm_connections.
title string erforderlich: Titel des Deals.
contact_email string erforderlich: E-Mail-Adresse eines bestehenden Kontakts.
value number optional: Wert des Deals (eine Dezimalzahl).
currency string optional: Zum Beispiel USD.

Ergebnis: {"remote_id", "provider", "deal": {"title", "value", "currency", "contact_email", "stage"}}.

list_crm_lists

Listet die Kontaktlisten oder Segmente in einem verbundenen CRM auf (nur Brevo und ActiveCampaign, nicht Pipedrive). Verwenden Sie die IDs als Filter list_id oder in list_ids.

Lesen Berechtigung integration_crm_get

Argumente

connection_id number erforderlich: Aus list_crm_connections.

Ergebnis: {"lists": [{"id", "name"}]}.

list_crm_tags

Listet die Kontakt-Tags in einem verbundenen CRM auf (nur ActiveCampaign). Verwenden Sie die IDs als Filter tag_id oder in tag_ids.

Lesen Berechtigung integration_crm_get

Argumente

connection_id number erforderlich: Aus list_crm_connections.

Ergebnis: {"tags": [{"id", "name"}]}.

Integrationen: Datenbanken

Funktioniert mit MySQL-, MariaDB-, PostgreSQL- und SQL-Server-Datenbanken, die in StickyPrompts verbunden sind. Siehe Datenbanken. Jede Verbindung hat ihre eigene Berechtigungsstufe, und sie ist der eigentliche Schutz dafür, was eine Abfrage tun darf: read_only akzeptiert nur eine einzelne SELECT- oder WITH-Anweisung, create_update erlaubt zusätzlich eine einzelne INSERT- oder UPDATE-Anweisung, und full_access filtert gar nicht.

list_database_connections

Listet die Datenbanken auf, die Sie verbunden haben, persönliche wie mit Ihrem Workspace geteilte, jeweils mit der database_permission der Verbindung. Liefert eine leere Liste, wenn keine verbunden ist.

Lesen Berechtigung integration_database_get

Keine Argumente. Ergebnis: {"connections": [{"connection_id", "provider", "name", "description", "database_permission"}]}.

list_database_tables

Listet die Tabellen und Views in einer verbundenen Datenbank auf, ohne Details zu den Spalten.

Lesen Berechtigung integration_database_get

Argumente

connection_id number erforderlich: Aus list_database_connections.

Ergebnis: {"tables": ["schema.name", ...]}.

describe_database_tables

Liefert Spaltendetails (Name, Datentyp, Nullbarkeit) für bestimmte Tabellen.

Lesen Berechtigung integration_database_get

Argumente

connection_id number erforderlich: Aus list_database_connections.
tables array of string erforderlich: Jeweils in der Form "schema.name", wie von list_database_tables geliefert.

Ergebnis: {"tables": [{"schema", "name", "columns": [{"name", "data_type", "nullable"}]}]}. Fehler: JSON-RPC-Fehler bei einer Tabellenangabe ohne Punkt.

run_database_query

Führt eine einzelne Anweisung auf einer verbundenen Datenbank aus, im Rahmen der Berechtigungsstufe der Verbindung. Zeilenzahl und Timeout werden serverseitig begrenzt.

Schreiben Destruktiv Berechtigung integration_database_manage

Argumente

connection_id number erforderlich: Aus list_database_connections.
query string erforderlich: Eine einzelne Anweisung, die die Berechtigungsstufe der Verbindung zulässt.
row_limit number optional Standard 100: Maximale Anzahl zurückgegebener Zeilen, höchstens 1000.
timeout_seconds number optional Standard 10: Timeout der Abfrage, höchstens 30.

Ergebnis: {"columns": [...], "rows": [[...]], "row_count": n, "truncated": bool}. Die Berechtigung des API-Schlüssels entscheidet nur darüber, ob das Tool aufgerufen werden kann. Verbinden Sie die Datenbank mit Read only, wenn ein Schlüssel niemals Daten ändern soll.

Integrationen: Speicher

Funktioniert mit Google Drive. Das Argument provider akzeptiert bei jedem Speicher-Tool nur den Wert google_drive. Speicherverbindungen sind persönlich und werden nicht mit dem Workspace geteilt.

Mehrere Tools liefern ein RemoteEntry-Objekt: {"id", "name", "kind", "mime_type", "size", "modified_at", "icon_url", "web_url", "parent_id", "shared", "owned_by_me", "can_add_children", "importable", "import_name"}.

list_storage_connections

Listet die Cloud-Speicher auf, die Sie persönlich verbunden haben. Liefert eine leere Liste, wenn keiner verbunden ist.

Lesen Berechtigung integration_storage_get

Keine Argumente. Ergebnis: {"connections": [{"provider", "name", "description", "account_name"}]}.

browse_storage_folder

Listet die Ordner und Dateien auf, die direkt in einem Ordner liegen. Lassen Sie folder_id weg, um die oberste Ebene zu durchsuchen.

Lesen Berechtigung integration_storage_get

Argumente

provider string erforderlich: google_drive.
folder_id string optional: Der aufzulistende Ordner. Weglassen für die oberste Ebene.
page_token string optional: Der next_page_token der vorherigen Seite.
page_size number optional: 1-200, wird begrenzt. Ohne Angabe gilt der Standard des Anbieters.
kind string optional: folder oder file.

Ergebnis: {"entries": [RemoteEntry], "next_page_token", "breadcrumbs": [RemoteEntry]}. Die Breadcrumbs beginnen bei der obersten Ebene, sofern der Anbieter sie auflösen kann.

search_storage_files

Durchsucht einen verbundenen Cloud-Speicher nach Name oder Inhalt, optional innerhalb eines Ordners.

Lesen Berechtigung integration_storage_get

Argumente

provider string erforderlich: google_drive.
query string erforderlich: Wonach gesucht werden soll.
folder_id string optional: Beschränkt die Suche auf diesen Ordner.
page_token string optional: Der next_page_token der vorherigen Seite.
page_size number optional: 1-200, wird begrenzt.
kind string optional: folder oder file.

Ergebnis: {"entries": [...], "next_page_token", "breadcrumbs": null}.

get_storage_entry

Liefert die Metadaten einer einzelnen Datei oder eines Ordners anhand der ID aus einem Browse- oder Suchergebnis.

Lesen Berechtigung integration_storage_get

Argumente

provider string erforderlich: google_drive.
entry_id string erforderlich: Die ID des Eintrags.

Ergebnis: ein einzelnes RemoteEntry-Objekt.

import_storage_files

Lädt Dateien aus einem verbundenen Cloud-Speicher herunter und speichert sie als StickyPrompts-Dateien. Google Docs, Sheets und Slides werden in PDF, XLSX und PPTX umgewandelt. Google Forms, Sites und Apps-Script-Projekte lassen sich nicht importieren. Jeder Eintrag gelingt oder scheitert für sich. Über MCP ist dies der einzige Weg, eine neue Datei in StickyPrompts zu bringen.

Schreiben Berechtigung integration_storage_manage

Argumente

provider string erforderlich: google_drive.
entry_ids array of string erforderlich: Bis zu 20 Einträge. Mehr führt zu einem Fehler.
project_id number optional: Hängt die importierten Dateien an dieses Projekt an.

Ergebnis: {"files": [{"id", "name", "file_type"}], "failed": [{"entry_id", "error"}], "_attachments": [...]}. Prüfen Sie failed auch dann, wenn einige Dateien erfolgreich importiert wurden. Die Datei-IDs funktionieren mit edit_image, generate_video und start_spreadsheet_processing.

export_file_to_storage

Lädt eine Ihrer StickyPrompts-Dateien in einen Ordner eines verbundenen Cloud-Speichers hoch. Der Ordner muss bereits existieren, und das verbundene Konto muss darin schreiben dürfen.

Schreiben Berechtigung integration_storage_manage

Argumente

provider string erforderlich: google_drive.
file_id number erforderlich: Eine Datei, die Ihnen gehört, aus list_files, einem Medienergebnis oder einem Import.
folder_id string erforderlich: Zielordner, aus browse_storage_folder oder search_storage_files.
name string optional: Überschreibt den Dateinamen im Ziel.

Ergebnis: {"entry": RemoteEntry} für die hochgeladene Datei.

Suche

search

Durchsucht Ihre eigenen Prompts und Unterhaltungen nach Name und Text. Anders als die Suche in der App umfasst sie weder Prompts, die mit Ihnen geteilt wurden, noch den öffentlichen Prompt-Katalog.

Lesen Berechtigung search

Argumente

query string erforderlich: Wonach gesucht werden soll.

Ergebnis: {"prompts": [{"id", "name", "description"}], "conversations": [{"id", "name", "relevant_message": {"id", "text"}}]}, jeweils höchstens 5. Der gefundene Text wird auf etwa 50 Zeichen rund um den ersten Treffer gekürzt, und der Treffer wird in <span class="search-highlight">...</span> eingeschlossen.

Nur für Mitarbeiter

get_usage_statistics

Liefert den Credit-Verbrauch und die Anzahl der Ausführungen des Aufrufers über einen Zeitraum, nach Kategorien aufgeschlüsselt. Das Tool braucht statistics_get, eine Berechtigung, die StickyPrompts-Mitarbeitern vorbehalten ist und die Kunden keinem Schlüssel zuweisen können. Deshalb erscheint dieses Tool bei Kundenschlüsseln nie. Workspace-Admins sehen die Nutzung in der App unter Nutzung, Credits und Abrechnung.

Lesen Berechtigung statistics_get (nur für Mitarbeiter)

Argumente

from_date string erforderlich: YYYY-MM-DD.
to_date string erforderlich: YYYY-MM-DD, einschließlich des ganzen Tages.

Ergebnis: {"from_date", "to_date", "total_credits", "total_runs", "by_category": [{"category", "credits", "runs"}]}.