What the assistant can read and do
The tools of the FanConvert MCP server, domain by domain, and the key permission each one needs.
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.
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.
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
| 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
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. |
Last updated on