Référence des outils

Voici la liste complète des outils qu’une clé API peut voir. Votre client ne voit que les outils dont votre clé possède l’autorisation (voir Vue d’ensemble de MCP). Chaque outil renvoie un élément texte contenant un document JSON ; la forme du résultat est indiquée pour chaque outil.

Comment lire cette page. Les outils Lecture ne font que lire. Les outils Écriture créent, modifient, suppriment ou envoient quelque chose. Les outils Asynchrone répondent avant la fin du travail et doivent être interrogés ensuite. Les arguments de type number sont lus comme des entiers, sauf mention contraire. Les outils paginés acceptent limit et offset et renvoient total_count, limit et offset.

En bref

Domaine	Outils
Chat et conversations	send_message, get_conversation, list_conversations, delete_conversation
Prompts et exécutions	list_prompts, get_prompt, run_prompt, custom_run, list_ai_models
Agents et workflows	list_agents, get_agent, list_workflow_tasks, get_workflow_task, run_workflow_task
Connaissances et fichiers	list_knowledge_bases, search_knowledge_base, list_files, get_file
Projets et équipes	list_projects, get_project, create_project, delete_project, list_workspace_members, list_teams, list_team_members
Génération de médias	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
Transcription	transcribe, get_transcription_status, delete_transcription
Feuilles de calcul	list_spreadsheet_processing_tasks, get_spreadsheet_processing_task, start_spreadsheet_processing, pause_spreadsheet_processing, resume_spreadsheet_processing
Intégrations : e-mail	list_email_connections, send_email
Intégrations : 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
Intégrations : bases de données	list_database_connections, list_database_tables, describe_database_tables, run_database_query
Intégrations : stockage	list_storage_connections, browse_storage_folder, search_storage_files, get_storage_entry, import_storage_files, export_file_to_storage
Recherche	search
Réservé à l’équipe StickyPrompts	get_usage_statistics

Chat et conversations

send_message

Envoie un message à un modèle d’IA et renvoie sa réponse, de manière synchrone. Omettez conversation_id pour démarrer une nouvelle conversation ; indiquez-en un pour la poursuivre. L’outil crée ou met à jour la même conversation que celle que vous voyez dans l’application StickyPrompts.

Écriture Autorisation conversations_manage

Résultat : {"conversation_id": <id>, "text": "<assistant reply>"}. Un message qui mentionne l’un de vos agents par son tag (@mentions) est transmis à cet agent, comme dans l’application. Erreurs : erreur d’outil conversation not found ; les défaillances du modèle et du fournisseur sont des erreurs JSON-RPC.

get_conversation

Renvoie une conversation qui vous appartient, avec la transcription de ses messages.

Lecture Autorisation conversations_get

Résultat : {"id", "name", "messages": [{"is_user": bool, "text": "..."}]}. Erreurs : erreur d’outil conversation not found.

list_conversations

Liste vos propres conversations interactives (ni celles partagées en équipe, ni celles des agents), page par page, des plus récemment mises à jour aux plus anciennes.

Lecture Autorisation conversations_get

Résultat : {"conversations": [{"id", "name"}], "total_count", "limit", "offset"}.

delete_conversation

Supprime une conversation qui vous appartient.

Écriture Destructif Autorisation conversations_delete

Résultat : {"deleted": true}. Erreurs : erreur d’outil conversation not found.

Prompts et exécutions

list_prompts

Liste vos propres prompts (ni ceux rattachés à un projet, ni ceux partagés avec vous), page par page. Utilisez ensuite get_prompt pour voir les variables d’un prompt avant d’appeler run_prompt.

Lecture Autorisation prompts_get

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

get_prompt

Renvoie un prompt qui vous appartient, avec le contenu de sa version actuelle et les variables qu’il accepte.

Lecture Autorisation prompts_get

Résultat : {"id", "name", "slug", "description", "content", "variables": [{"slug", "name", "description", "required", "default_value"}]}. Erreurs : erreur d’outil prompt not found, y compris pour les prompts partagés avec vous dont vous n’êtes pas propriétaire.

run_prompt

Remplit les variables d’un prompt, l’exécute sur un modèle et renvoie le texte de la réponse. L’exécution se fait en un seul appel isolé ; elle ne crée pas de conversation interactive dans l’application.

Écriture Autorisation run_prompt

Résultat : {"text": "<model response>"}. Erreurs : erreurs d’outil prompt not found, prompt has no current version, variable "<slug>" must be a string, missing a value for a required variable, ou le message relatif aux données sensibles si un garde-fou bloque le prompt rempli. Les défaillances du modèle et du fournisseur sont des erreurs JSON-RPC.

custom_run

Exécute un texte de prompt brut sur un modèle et renvoie le texte de la réponse, sans prompt enregistré. L’exécution se fait en un seul appel isolé ; elle ne crée pas de conversation.

Écriture Autorisation custom_run

Résultat : {"text": "<model response>"}.

list_ai_models

Liste les modèles sur lesquels vous pouvez exécuter des requêtes, à l’exclusion des modèles restreints par votre espace de travail (règles de résidence des données comprises) et, par défaut, des modèles obsolètes.

Lecture Autorisation ai_models_get

Résultat : {"models": [{"id", "name", "powered_by", "description", "premium"}]}, dans l’ordre de tri de la plateforme.

Agents et workflows

list_agents

Liste vos propres agents (pas ceux partagés avec vous par une équipe ou par l’espace de travail). Sans pagination.

Lecture Autorisation agents_get

Résultat : {"agents": [{"id", "name", "slug", "tag"}]}. Le tag est le nom à utiliser dans une @mention au sein de send_message.

get_agent

Renvoie un agent auquel vous avez accès, avec son prompt système et le modèle configuré.

Lecture Autorisation agents_get

Résultat : {"id", "name", "slug", "description", "system_prompt", "ai_model_id", "ai_model_name"}. Erreurs : erreurs d’outil agent not found, you don't have access to this agent.

list_workflow_tasks

Liste vos propres tâches de workflow planifiées, page par page.

Lecture Autorisation workflow_tasks_get

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

get_workflow_task

Renvoie une tâche de workflow que vous gérez, avec ses instructions et son taux de réussite.

Lecture Autorisation workflow_tasks_get

Résultat : {"id", "name", "slug", "description", "instructions", "enabled", "total_run_count", "success_rate"}. Erreurs : erreur d’outil workflow task not found or access denied.

run_workflow_task

Lance immédiatement une exécution d’une tâche de workflow, en dehors de sa planification. Répond tout de suite avec l’identifiant et le statut de la nouvelle exécution, sans attendre qu’elle se termine.

Écriture Asynchrone Autorisation workflow_tasks_manage

Résultat : {"execution_id": <id>, "status": "running"}. Aucun outil MCP ne permet de lire le résultat d’une exécution : une fois celle-ci terminée, total_run_count et success_rate dans get_workflow_task en tiennent compte. Si le propriétaire a épuisé son quota, l’exécution échoue avec quota exceeded. Erreurs : erreur d’outil workflow task not found or access denied.

Connaissances et fichiers

list_knowledge_bases

Liste les bases de connaissances qui vous appartiennent ou auxquelles vous avez reçu l’accès.

Lecture Autorisation knowledge_bases_get

Aucun argument. Résultat : {"knowledge_bases": [{"id", "name", "description"}]}.

search_knowledge_base

Recherche dans une base de connaissances les passages pertinents pour une requête, et renvoie ces passages ainsi que les fichiers dont ils proviennent. Il s’agit de la même recherche sémantique que celle utilisée par une conversation ; elle n’a pas d’équivalent REST.

Lecture Autorisation knowledge_bases_get

Résultat : {"context": "<retrieved passages as text>", "files": [{"id", "name"}]}. Comptabilisé comme une utilisation de base de connaissances. Erreurs : erreur d’outil knowledge base not found or access denied, ou le message d’erreur de la recherche.

list_files

Liste vos propres fichiers téléversés et générés, du plus récent au plus ancien, page par page. Il n’existe aucun outil MCP pour téléverser des fichiers.

Lecture Autorisation files_get

Résultat : {"files": [{"id", "name", "file_type"}], "total_count", "limit", "offset"}.

get_file

Renvoie les métadonnées d’un fichier qui vous appartient, par exemple pour transmettre son identifiant à edit_image.

Lecture Autorisation files_get

Résultat : {"id", "name", "file_type"}, sans URL ni contenu. Erreurs : erreur d’outil file not found or access denied.

Projets et équipes

list_projects

Liste les projets qui vous appartiennent ou qui sont partagés avec vous, page par page.

Lecture Autorisation projects_get

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

get_project

Renvoie un projet auquel vous avez accès.

Lecture Autorisation projects_get

Résultat : {"id", "name", "slug", "description", "instructions"}. Erreurs : erreurs d’outil project not found, you don't have access to this project.

create_project

Crée un nouveau projet dont vous êtes propriétaire.

Écriture Autorisation projects_manage

Résultat : {"id", "slug", "name"}.

delete_project

Supprime un projet qui vous appartient. Seul le propriétaire peut le supprimer.

Écriture Destructif Autorisation projects_delete

Résultat : {"deleted": true}. Erreurs : erreurs d’outil project not found, you don't have access to this project.

list_workspace_members

Liste les membres de votre espace de travail, page par page.

Lecture Autorisation organization_get

Résultat : {"members": [{"id", "email", "first_name", "last_name", "is_owner", "permissions": [...]}], "total_count", "limit", "offset"}. Le propriétaire de l’espace de travail apparaît toujours avec permissions: ["admin"].

list_teams

Liste toutes les équipes de votre espace de travail. Sans pagination.

Lecture Autorisation teams_get

Résultat : {"teams": [{"id", "name", "description", "color", "member_count"}]}.

list_team_members

Liste les membres d’une équipe, page par page. Vous devez être administrateur de l’espace de travail ou membre de l’équipe.

Lecture Autorisation teams_get

Résultat : {"members": [{"id", "email", "first_name", "last_name", "role"}], "total_count", "limit", "offset"}. Erreurs : erreurs JSON-RPC team not found, not authorized to view the members of this team.

Génération de médias

Les outils de médias ne prennent aucun argument de modèle : StickyPrompts utilise le modèle configuré pour chaque type de média. Les résultats comportent path, l’URL directe du fichier stocké (pas un lien signé ni un lien qui expire), et _attachments, une liste d’éléments {"type": "file", "id": <file id>} dont vous pouvez transmettre les identifiants à d’autres outils.

generate_image

Génère une image à partir d’un prompt.

Écriture Autorisation image_generation_manage

Résultat (synchrone) : {"path": "<storage URL>", "_attachments": [{"type": "file", "id": <file id>}]}.

edit_image

Modifie une image existante selon des instructions. Renvoie un nouveau fichier.

Écriture Autorisation image_generation_manage

Résultat : même forme que pour generate_image, avec un nouvel identifiant de fichier. Erreurs : erreur JSON-RPC file not found or access denied.

generate_video

Lance la génération d’une vidéo à partir d’un prompt, éventuellement en animant une image de départ. Répond immédiatement avec l’identifiant et le statut de la génération ; interrogez get_video_generation_status jusqu’à ce qu’il indique done ou error. La génération peut prendre plusieurs minutes.

Écriture Asynchrone Autorisation video_generation_manage

Résultat : {"id": <video generation id>, "status": "queued"}. Erreurs : erreurs JSON-RPC en cas de format d’image, de résolution ou de durée non pris en charge, de combinaison d’images invalide, ou de modèle que votre espace de travail n’autorise pas.

get_video_generation_status

Vérifie une génération de vidéo lancée par generate_video. Le statut vaut queued, processing, done ou error. Tant qu’il vaut queued ou processing, patientez (par exemple 15 à 60 secondes) et rappelez l’outil.

Lecture Autorisation video_generation_get

Résultat : {"id", "status"}, plus error lorsque le statut est error, ou path et _attachments lorsqu’il est done. Erreurs : une génération introuvable donne une erreur JSON-RPC.

delete_video_generation

Supprime une génération de vidéo qui vous appartient.

Écriture Destructif Autorisation video_generation_delete

Résultat : {"deleted": true}.

generate_speech

Convertit un texte en audio parlé. Répond une fois l’audio prêt.

Écriture Autorisation tts_generation_manage

Résultat (synchrone) : {"path": "<storage URL>", "_attachments": [{"type": "file", "id": <file id>}]}. Aucun identifiant de génération n’est renvoyé.

get_tts_generation_status

Vérifie une génération de synthèse vocale passée. Le statut vaut queued, processing, done ou error. Comme generate_speech ne renvoie pas d’identifiant de génération, vous utiliserez un identifiant provenant de l’application ou de l’API REST.

Lecture Autorisation tts_generation_get

Résultat : {"id", "status"}, plus error, ou path et _attachments une fois terminé. Erreurs : erreur d’outil tts generation not found.

delete_tts_generation

Supprime une génération de synthèse vocale qui vous appartient.

Écriture Destructif Autorisation tts_generation_delete

Résultat : {"deleted": true}.

generate_music

Génère un morceau de musique à partir d’un prompt texte. Répond une fois l’audio prêt.

Écriture Autorisation music_generation_manage

Résultat (synchrone) : {"path", "duration_seconds", "_attachments"}, plus lyrics lorsque le modèle a produit des paroles. Aucun identifiant de génération n’est renvoyé.

get_music_generation_status

Vérifie une génération musicale passée. Le statut vaut queued, processing, done ou error. Comme generate_music ne renvoie pas d’identifiant de génération, vous utiliserez un identifiant provenant de l’application ou de l’API REST.

Lecture Autorisation music_generation_get

Résultat : {"id", "status"}, plus error, ou path, duration_seconds, _attachments (et lyrics le cas échéant) une fois terminé. Erreurs : erreur d’outil music generation not found.

delete_music_generation

Supprime une génération musicale qui vous appartient.

Écriture Destructif Autorisation music_generation_delete

Résultat : {"deleted": true}.

Transcription

transcribe

Transcrit en texte un fichier audio ou vidéo à partir d’une URL publique. Répond une fois la transcription prête : prévoyez donc dans votre client un délai d’expiration généreux pour les médias longs.

Écriture Autorisation transcription_manage

Résultat (synchrone) : {"text": "<transcript>", "_attachments": [{"type": "transcription", "id": <transcription id>}]}. L’identifiant de la transcription ne figure que dans _attachments.

get_transcription_status

Vérifie une transcription passée. Le statut vaut queued, fetching, preparing, processing, done ou error.

Lecture Autorisation transcription_get

Résultat : {"id", "status"}, plus error, ou text et _attachments une fois terminé. Erreurs : erreur d’outil transcription not found.

delete_transcription

Supprime une transcription qui vous appartient.

Écriture Destructif Autorisation transcription_delete

Résultat : {"deleted": true}.

Feuilles de calcul

Le traitement de feuilles de calcul exécute un modèle de prompt sur chaque ligne d’une feuille xlsx et écrit la réponse dans une colonne de sortie. Les cinq outils renvoient tous un objet tâche : {"task_id", "status", "processed_rows", "total_rows", "original_file_id", "created_at", "credit_cost"}, plus error, result_preview, eta et generated_file_id lorsqu’ils sont présents. Valeurs de statut : queued, initializing, processing, paused, done, error.

list_spreadsheet_processing_tasks

Liste vos propres tâches de traitement de feuilles de calcul, page par page.

Lecture Autorisation spreadsheet_processing_get

Résultat : {"tasks": [task], "total_count", "limit", "offset"}.

get_spreadsheet_processing_task

Renvoie le statut et la progression d’une tâche qui vous appartient.

Lecture Autorisation spreadsheet_processing_get

Résultat : un objet tâche. Erreurs : erreur d’outil task not found. Une interrogation lancée juste après le démarrage peut brièvement renvoyer cette erreur, le temps que la tâche soit créée.

start_spreadsheet_processing

Lance le traitement d’un fichier xlsx déjà présent dans StickyPrompts. Le traitement s’exécute en arrière-plan et l’outil renvoie aussitôt un task_id ; interrogez get_spreadsheet_processing_task jusqu’à ce que le statut soit done ou error.

Écriture Asynchrone Autorisation spreadsheet_processing_manage

Résultat : {"task_id": "<32-character id>"}. Erreurs : erreur d’outil file not found.

pause_spreadsheet_processing

Met en pause une tâche en cours qui vous appartient. Seules les tâches à l’état queued, initializing ou processing peuvent être mises en pause.

Écriture Autorisation spreadsheet_processing_manage

Résultat : l’objet tâche. Erreurs : erreurs d’outil task not found, file processing cannot be paused currently, file processing is already paused, file processing is already finished, file processing is not running.

resume_spreadsheet_processing

Reprend une tâche en pause qui vous appartient. Elle est remise en file d’attente, et tout fichier de sortie partiel est supprimé puis régénéré.

Écriture Asynchrone Autorisation spreadsheet_processing_manage

Résultat : l’objet tâche avec status: "queued". Erreurs : erreurs d’outil task not found, file processing is already running, file processing is already finished, file processing is not paused.

Intégrations : e-mail

Fonctionne avec le compte e-mail connecté dans StickyPrompts (Postmark, Resend, SendGrid ou SMTP). Les connexions se configurent dans l’application ; voir Envoi d’e-mails.

list_email_connections

Liste les comptes e-mail que vous avez connectés, personnels ou partagés avec votre espace de travail. Renvoie une liste vide si aucun n’est connecté.

Lecture Autorisation integration_email_get

Aucun argument. Résultat : {"connections": [{"connection_id", "provider", "name", "description", "sends_from"}]}.

send_email

Envoie un e-mail via l’un de vos comptes e-mail connectés. L’e-mail part réellement et l’envoi est irréversible : vérifiez les destinataires et le contenu avant d’appeler l’outil. html_body ou text_body est obligatoire.

Écriture Autorisation integration_email_manage

Résultat : {"message_id": "...", "provider": "..."}.

Intégrations : CRM

Fonctionne avec ActiveCampaign, Brevo ou Pipedrive connecté dans StickyPrompts ; voir CRM. Les outils d’écriture (add_crm_contact, edit_crm_contact, create_crm_deal) exigent aussi que la connexion elle-même autorise l’accès en écriture. Les connexions sont en lecture seule par défaut.

list_crm_connections

Liste les comptes CRM que vous avez connectés, personnels ou partagés avec votre espace de travail. Renvoie une liste vide si aucun n’est connecté.

Lecture Autorisation integration_crm_get

Aucun argument. Résultat : {"connections": [{"connection_id", "provider", "name", "description"}]}.

search_crm_contacts

Recherche des contacts dans un CRM connecté. Utilisez cet outil avant edit_crm_contact pour trouver le contact, ou avant add_crm_contact pour éviter les doublons.

Lecture Autorisation integration_crm_get

Résultat : {"contacts": [{"remote_id", "provider", "contact"}]}.

list_crm_contacts

Parcourt les contacts page par page, dans l’ordre propre au fournisseur, sans requête.

Lecture Autorisation integration_crm_get

Résultat : {"contacts": [...], "has_more": bool, "next_cursor": "..."} (next_cursor est omis lorsqu’il est vide).

add_crm_contact

Ajoute un nouveau contact. Crée toujours un nouveau contact, sans jamais mettre à jour un contact existant.

Écriture Autorisation integration_crm_manage

Résultat : {"remote_id", "provider", "contact": {...}}.

edit_crm_contact

Modifie un contact existant, retrouvé par son adresse e-mail. Échoue si aucun contact ne correspond à cette adresse ; l’outil n’en crée jamais.

Écriture Autorisation integration_crm_manage

Les champs omis restent inchangés ; une chaîne vide envoyée explicitement efface le champ. Résultat : {"remote_id", "provider", "contact": {...}}.

search_crm_deals

Recherche des affaires par titre ou par l’adresse e-mail du contact associé. Utilisez cet outil avant create_crm_deal pour vérifier qu’une affaire n’existe pas déjà.

Lecture Autorisation integration_crm_get

Résultat : {"deals": [{"remote_id", "provider", "deal"}]}.

list_crm_deals

Parcourt les affaires page par page, dans l’ordre propre au fournisseur. Tous les CRM ne gèrent pas les affaires : vérifiez d’abord le fournisseur de la connexion.

Lecture Autorisation integration_crm_get

Résultat : {"deals": [...], "has_more", "next_cursor"}.

create_crm_deal

Crée une affaire liée à un contact existant. Tous les CRM ne gèrent pas les affaires : vérifiez d’abord le fournisseur de la connexion.

Écriture Autorisation integration_crm_manage

Résultat : {"remote_id", "provider", "deal": {"title", "value", "currency", "contact_email", "stage"}}.

list_crm_lists

Liste les listes de contacts ou les segments d’un CRM connecté (Brevo et ActiveCampaign uniquement, pas Pipedrive). Utilisez les identifiants comme filtre list_id ou dans list_ids.

Lecture Autorisation integration_crm_get

Résultat : {"lists": [{"id", "name"}]}.

list_crm_tags

Liste les tags de contacts d’un CRM connecté (ActiveCampaign uniquement). Utilisez les identifiants comme filtre tag_id ou dans tag_ids.

Lecture Autorisation integration_crm_get

Résultat : {"tags": [{"id", "name"}]}.

Intégrations : bases de données

Fonctionne avec les bases de données MySQL, MariaDB, PostgreSQL et SQL Server connectées dans StickyPrompts ; voir Bases de données. Chaque connexion possède son propre niveau d’autorisation, qui est le véritable garde-fou sur ce qu’une requête peut faire : read_only n’accepte qu’une seule instruction SELECT ou WITH, create_update autorise en plus une seule instruction INSERT ou UPDATE, et full_access n’applique aucun filtrage.

list_database_connections

Liste les bases de données que vous avez connectées, personnelles ou partagées avec votre espace de travail, avec le database_permission de chaque connexion. Renvoie une liste vide si aucune n’est connectée.

Lecture Autorisation integration_database_get

Aucun argument. Résultat : {"connections": [{"connection_id", "provider", "name", "description", "database_permission"}]}.

list_database_tables

Liste les tables et les vues d’une base de données connectée, sans le détail des colonnes.

Lecture Autorisation integration_database_get

Résultat : {"tables": ["schema.name", ...]}.

describe_database_tables

Renvoie le détail des colonnes (nom, type de données, nullabilité) de tables précises.

Lecture Autorisation integration_database_get

Résultat : {"tables": [{"schema", "name", "columns": [{"name", "data_type", "nullable"}]}]}. Erreurs : erreur JSON-RPC pour une référence de table sans point.

run_database_query

Exécute une seule instruction sur une base de données connectée, dans la limite du niveau d’autorisation de la connexion. Le nombre de lignes et le délai d’expiration sont plafonnés côté serveur.

Écriture Destructif Autorisation integration_database_manage

Résultat : {"columns": [...], "rows": [[...]], "row_count": n, "truncated": bool}. L’autorisation de la clé API détermine seulement si l’outil peut être appelé ; connectez la base de données en Read only si une clé ne doit jamais modifier de données.

Intégrations : stockage

Fonctionne avec Google Drive. L’argument provider de chaque outil de stockage accepte une seule valeur, google_drive. Les connexions de stockage sont personnelles et ne sont pas partagées avec l’espace de travail.

Plusieurs outils renvoient un objet RemoteEntry : {"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

Liste les stockages cloud que vous avez connectés à titre personnel. Renvoie une liste vide si aucun n’est connecté.

Lecture Autorisation integration_storage_get

Aucun argument. Résultat : {"connections": [{"provider", "name", "description", "account_name"}]}.

browse_storage_folder

Liste les dossiers et les fichiers situés directement dans un dossier. Omettez folder_id pour parcourir la racine.

Lecture Autorisation integration_storage_get

Résultat : {"entries": [RemoteEntry], "next_page_token", "breadcrumbs": [RemoteEntry]}. Le fil d’Ariane (breadcrumbs) commence par la racine lorsque le fournisseur peut le reconstituer.

search_storage_files

Recherche dans un stockage connecté par nom ou par contenu, éventuellement dans un seul dossier.

Lecture Autorisation integration_storage_get

Résultat : {"entries": [...], "next_page_token", "breadcrumbs": null}.

get_storage_entry

Renvoie les métadonnées d’un fichier ou d’un dossier, à partir de l’identifiant obtenu en parcourant ou en recherchant.

Lecture Autorisation integration_storage_get

Résultat : un seul objet RemoteEntry.

import_storage_files

Télécharge des fichiers depuis un stockage connecté et les enregistre comme fichiers StickyPrompts. Les Google Docs, Sheets et Slides sont convertis en PDF, XLSX et PPTX ; les Google Forms, Sites et projets Apps Script ne peuvent pas être importés. Chaque élément réussit ou échoue indépendamment des autres. C’est le seul moyen d’ajouter un nouveau fichier dans StickyPrompts via MCP.

Écriture Autorisation integration_storage_manage

Résultat : {"files": [{"id", "name", "file_type"}], "failed": [{"entry_id", "error"}], "_attachments": [...]}. Vérifiez failed même lorsque certains fichiers ont été importés. Les identifiants de fichiers fonctionnent avec edit_image, generate_video et start_spreadsheet_processing.

export_file_to_storage

Téléverse l’un de vos fichiers StickyPrompts dans un dossier d’un stockage connecté. Le dossier doit déjà exister et être accessible en écriture au compte connecté.

Écriture Autorisation integration_storage_manage

Résultat : {"entry": RemoteEntry} pour le fichier téléversé.

Recherche

search

Recherche dans vos propres prompts et conversations, par nom et par texte. Contrairement à la recherche de l’application, elle n’inclut ni les prompts partagés avec vous, ni le catalogue public de prompts.

Lecture Autorisation search

Résultat : {"prompts": [{"id", "name", "description"}], "conversations": [{"id", "name", "relevant_message": {"id", "text"}}]}, avec au maximum 5 éléments de chaque type. Le texte correspondant est réduit à environ 50 caractères autour de la première occurrence, celle-ci étant entourée de <span class="search-highlight">...</span>.

Réservé à l’équipe StickyPrompts

get_usage_statistics

Renvoie la consommation de crédits et le nombre d’exécutions de l’appelant sur une période donnée, par catégorie. L’outil nécessite statistics_get, une autorisation réservée à l’équipe StickyPrompts que les clients ne peuvent pas attribuer à une clé : cet outil n’apparaît donc jamais pour les clés des clients. Les administrateurs de l’espace de travail consultent l’utilisation dans l’application, sous Utilisation, crédits et facturation.

Lecture Autorisation statistics_get (réservée à l’équipe StickyPrompts)

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