# What the assistant can read and do

> The tools of the FanConvert MCP server, domain by domain, and the key permission each one needs.

URL : https://docs.fanconvert.ai/en/api/outils-mcp

Your assistant **only sees the tools its key can call**: the list is recomputed on every request with the key's permissions. The names below are those the assistant displays; you do not need to remember them, just ask your question.

<Callout title="What no tool does">
Send a message to a fan, connect a platform account, turn a creator's agent on or off: no tool allows it.
</Callout>

## Read [#read]

| Domain (permission) | What you can ask | Tools |
|---|---|---|
| Creators and profiles (`creators:read`, `profile:read`) | the list of creators, their profile, the state of their agent | `creators_list`, `creator_get`, `creator_runtime_get`, `creator_profile_get` |
| MYM chats (`conversations:read`) | conversations, their messages, events and sales | `conversations_list`, `conversation_get`, `conversation_messages`, `conversation_events`, `conversation_sales`, `conversation_decisions` |
| Telegram chats (`telegram:read`) | conversations, messages, received media, offers, welcome message, bot | `telegram_conversations_list`, `telegram_conversation_get`, `telegram_conversation_messages`, `telegram_conversation_events`, `telegram_conversation_decisions`, `telegram_conversation_state`, `telegram_conversation_received_media`, `telegram_media_list`, `telegram_offers_list`, `telegram_welcome_get`, `telegram_bot_get`, `telegram_fan_filter_get`, `telegram_fan_filter_resolve` |
| Fans (`fans:read`) | the team note on a fan | `fan_note_get`, `telegram_fan_note_get` |
| AI pause (`chatting:read`) | who answers a fan, human takeovers, offered media, message ratings | `conversation_control_get`, `conversation_interventions_list`, `conversation_command_get`, `conversation_offered_media`, `conversation_fan_scripts`, `conversation_ratings_list`, `message_ratings_export`, `telegram_conversation_interventions`, `telegram_conversation_ratings_list` |
| Sales and statistics (`sales:read`, `statistics:read`) | a sale's funnel, Telegram sales, statistics per creator and per agent | `conversation_sale_tunnel`, `telegram_sales_list`, `statistics_summary`, `statistics_creators`, `statistics_agents`, `creator_media_stats_get`, `creator_script_stats_list` |
| Scripts and media (`scripts:read`, `media:read`) | sales scripts, a creator's review, the media library and packs | `scripts_list`, `script_get`, `creator_review_get`, `media_list`, `media_pack_get`, `media_files_list`, `media_file_get` |
| Agent settings (`settings:read`, `schedule:read`, `filters:read`) | chatting settings, schedule, fan filter, negotiation and its A/B tests | `creator_settings_get`, `creator_schedule_get`, `fan_filter_get`, `fan_filter_resolve`, `negotiation_get`, `negotiation_organization_get`, `negotiation_gifts_get`, `negotiation_journal`, `negotiation_stats`, `ab_tests_list`, `ab_tests_get`, `ab_tests_results` |
| AI Agent screen (`settings:read`, `profile:read`, `scripts:read`) | guidelines, style, voice, memory, pace, re-engagement, threshold, live, "Her life", script ending, priorities | `creator_behavior_guidance_get`, `creator_instructions_get`, `creator_style_get`, `creator_voice_get`, `creator_memory_guidance_get`, `creator_rythme_get`, `creator_reengagement_get`, `creator_initial_threshold_get`, `creator_fan_discovery_get`, `creator_live_get`, `creator_life_get`, `creator_script_ending_get`, `creator_script_priority_get` |
| Emergencies (`notifications:read`) | what is waiting for a human | `notifications_list`, `notification_get` |

## Act [#act]

| Domain (permission) | What the assistant can do | How |
|---|---|---|
| AI behavior (`ai:write`) | change a creator's guidelines, style, pace, follow-ups, memory | the assistant **prepares** the change; it only applies after **your approval** in FanConvert |
| Agent settings (`settings:write`) | change negotiation settings | prepared, then approved by you |
| Scripts and media (`media:write`) | import a file into a creator's media library (Beta) | in one call, within your agency's limits |
| Playground tests (`playground:run`) | open a test chat, play the fan, compare, replay | sandbox: **nothing is sent to a fan** |

Tracking of prepared actions (`command_get`, `commands_list`, `job_get`, `job_items_list`) comes with these permissions.

## Approve an action [#approve-an-action]

When the assistant prepares a change, it appears in **Réglages › API & MCP › Actions à approuver** (Actions to approve), if actions to approve are enabled for your agency. Select the action to see its preview, then decide. FanConvert asks for your password before approving.

| Message (in French on screen) | What it means |
|---|---|
| Approbation expirée. Demandez un nouvel aperçu. | The preview waited too long: ask the assistant to prepare it again. |
| Cet aperçu a expiré ou a changé… | The setting changed since the preview: nothing was applied. |
| Approbation utilisée. Consultez l'état de la commande. | This approval was already used. |
| Approuvée, exécution non confirmée. | Reload the action to see whether the change went through before trying again. |
| Cette action n'est plus accessible avec vos droits actuels. | Your permissions or the key's changed. |
| Changez votre mot de passe avant d'approuver une action. | Change your password, then come back. |