MCP tool reference: every tool, by screen
An agency token sees 103 tools on the LanaChat MCP server. This page lists each one, grouped by Console screen, with one line on what it does. Without Configure agency AI, the token gets only the setup, fans and sales tools. The other boxes are checked at each call: a tool outside them stays listed and answers with a clear refusal. The server sends the exact arguments of each tool: you never type them.
- Reads only read. Changes write something, always in your workspace only.
- Changes that matter (publish, replies on, imports, a new brain) work in two steps: a preview first, then
applywith the fresh hash or revision the preview returned. - No tool sends a message to a fan.
Start: permissions and formats #
Main permission: any permission.
| Tool | Type | What it does |
|---|---|---|
get_capabilities | Reads | What this token may do, the limits and the boundaries. |
get_workspace_setup | Reads | What the token may set up, and the safe way to upload files. |
get_workspace_connection_guide | Reads | The current setup workflow, the exact script format, upload limits and how to poll sales. |
get_workspace_content_schema | Reads | The fields you can edit on a creator, their price limits and permissions. |
get_schemas | Reads | The exact format of agents, phases, triggers and conditions of an AI Brain. |
Creators #
Main permission: Manage workspace setup.
| Tool | Type | What it does |
|---|---|---|
get_workspace_onboarding_status | Reads | The Get started checklist, per creator and for the agency: what blocks replies and the next step. Call it first. |
list_workspace_models | Reads | List the creators of the workspace, with their revision number. |
save_workspace_model | Changes | Create a creator or change some of her fields. Never publishes a brain. |
delete_workspace_model | Changes | Delete a creator that nothing uses any more. |
extract_creator_profile | Changes | Turn a description, a PDF or photos into proposed creator fields. Saves nothing. |
set_workspace_model_photo | Changes | Use one of her Vault images as her profile photo, or clear it. |
list_models | Reads | List creators with their linked AI Brain, AI mode and build status. |
Telegram Accounts #
Main permission: Manage workspace setup.
| Tool | Type | What it does |
|---|---|---|
list_workspace_telegram | Reads | List the bots and connected accounts. No secrets, no messages. |
register_workspace_telegram_bot | Changes | Check and save a BotFather bot for a creator, optionally with its waiting account. |
connect_workspace_telegram_bot | Changes | Register or repair the bot webhook. The account owner still links it in Telegram. |
resync_workspace_telegram_bot | Changes | Unblock a bot or account stuck on "Waiting for Telegram". |
get_workspace_telegram_status | Reads | Read the health of a bot webhook. |
get_workspace_telegram_rights | Reads | Read the Business rights an account gave at its last connection, and the reply rights missing. |
update_workspace_telegram_bot | Changes | Rename a bot or turn it on or off. |
update_workspace_telegram_account | Changes | Change an account name, on or off, reply language, market or traffic source. |
remove_workspace_telegram_account | Changes | Remove an account from LanaChat (it comes back with restore). |
restore_workspace_telegram_account | Changes | Bring a removed account back. |
list_workspace_stories | Reads | List the Telegram stories, newest first. |
get_workspace_pool_load | Reads | How hard each account sends against the hourly cap (last 60 minutes). |
Vault #
Main permission: Manage workspace setup.
| Tool | Type | What it does |
|---|---|---|
list_workspace_media_assets | Reads | List the media of a creator. |
get_workspace_media_asset | Reads | Read one media file and its details. |
begin_workspace_media_upload | Changes | Start or resume an upload of up to 2 GiB, sent in parts. |
get_workspace_media_upload | Reads | Read which parts of an upload arrived. |
complete_workspace_media_upload | Changes | Finish an upload and prepare the file in the Vault. |
abort_workspace_media_upload | Changes | Cancel an unfinished upload. |
list_workspace_media_metadata | Reads | Read names, descriptions, tags, folders and prices of the media. |
update_workspace_media_metadata | Changes | Change one media: name, description, tags, folder, free or paid, price in Stars. |
list_workspace_media_tags | Reads | List the tags in use and how often. |
update_workspace_media_tags | Changes | Add or remove tags, set or clear the folder of one media. |
prepare_workspace_media_analysis | Reads | Check whether a photo or video can be described automatically. |
analyze_workspace_media | Changes | Describe a photo or video from a few samples. |
preview_workspace_drive_import | Changes | Look inside a public Google Drive folder before importing. Copies nothing yet. |
start_workspace_drive_import | Changes | Import the previewed Drive folder into the creator's Vault. |
cancel_workspace_drive_import | Changes | Stop a Drive import; files already imported stay. |
list_workspace_drive_imports | Reads | List the last 20 Drive imports of a creator. |
get_workspace_drive_import | Reads | Follow one Drive import, file by file. |
AI Brain and scripts #
Main permission: Configure agency AI; publishing needs Publish agency AI.
| Tool | Type | What it does |
|---|---|---|
get_workspace_ai_templates | Reads | List the approved starting templates for a new brain. |
setup_workspace_ai | Changes | Give a creator a new AI Brain, replies off. Preview first, then apply. |
set_workspace_auto_reply | Changes | Preview, then turn the AI replies of a creator on or off. |
list_ai_profiles | Reads | List the saved drafts of a brain and their latest version. |
get_ai_profile | Reads | Read one draft version: persona, scripts, history. |
create_ai_profile | Changes | Create a new draft from the live brain or from a saved version. |
edit_ai_profile | Changes | Check or save a new draft version: persona, scripts, agents. Live replies do not change. |
compare_ai_profile_versions | Reads | Show what changed between two draft versions. |
restore_ai_profile_version | Changes | Bring back an earlier draft as a new version. |
archive_ai_profile | Changes | Hide an unused draft, or show it again. |
publish_ai_profile | Changes | Check, then publish an exact draft version to the live brain. |
get_configuration | Reads | Read the live sources of a brain and their current hash. |
configure_documents | Changes | Check or publish complete edited sources of a brain. |
configure_engine | Changes | Manage custom agents, phases and their rules. |
revision_history | Reads | List the last edits, with before and after. |
rollback_revision | Changes | Undo one edit, if nothing changed it since. |
Playground #
Main permission: Generate Playground replies; diagnostics need Read reply diagnostics.
| Tool | Type | What it does |
|---|---|---|
playground_reply | Changes | Get a real test reply from a draft or the live brain. Nothing goes to Telegram. |
list_playground_sessions | Reads | Find recent test conversations of a creator. |
get_playground_conversation | Reads | Read a test conversation and what the AI noted. |
explain_playground_turn | Reads | Explain why the AI answered as it did on one turn. |
Conversation styles and advanced replies #
Main permission: Configure agency AI; the advanced replies journal needs Read sales and Read reply diagnostics.
| Tool | Type | What it does |
|---|---|---|
get_conversation_variants | Reads | Read the three conversation styles and their settings. |
get_workspace_jev_usage | Reads | Read the usage journal of the advanced replies for one account. |
Fans and conversations #
Main permission: Read fans and conversations; import needs Import fan history.
| Tool | Type | What it does |
|---|---|---|
list_workspace_fans | Reads | List the fans of an account or a creator. |
list_workspace_conversations | Reads | List the conversations of an account or a creator. |
get_workspace_messages | Reads | Read the messages of one fan. |
get_workspace_control_history | Reads | Read when a conversation was paused or resumed. |
set_workspace_fan_paused | Changes | Pause or resume the AI for one fan. |
import_workspace_fan_history | Changes | Preview, then add past fans and messages. Sends nothing. |
get_workspace_fan_timeline_memory | Reads | Read what the AI remembers about a fan, day by day. |
get_workspace_fan_spending | Reads | Read what a fan really spent, and a 90-day estimate. |
set_workspace_fan_spend_consent | Changes | Record or withdraw a fan consent you already have. |
export_workspace_fan | Reads | Export everything the agency holds about one fan. |
delete_workspace_fan | Changes | Erase one fan data on request. |
list_workspace_safety_alerts | Reads | Read the safety alerts: a possible minor, a fan in distress. |
ack_workspace_safety_alert | Changes | Close a safety alert with a note of what your team did. |
Sales, tracking and events #
Main permission: Read sales.
| Tool | Type | What it does |
|---|---|---|
list_workspace_sales | Reads | Read the sales of an account, several accounts or a creator. |
list_workspace_events | Reads | Read the stream of sales and safety events. |
list_workspace_tracking_links | Reads | List the tracking links with clicks and results. Read only. |
list_workspace_payment_links | Reads | List the payment links. |
list_workspace_message_plus_campaigns | Reads | List the Message+ campaigns and their status. |
get_workspace_delivery_status | Reads | Read what may block replies on an account. |
set_workspace_delivery_mode | Changes | Put a creator and her accounts in Test or Live. |
list_workspace_webhooks | Reads | List the outgoing sales webhooks. |
create_workspace_webhook | Changes | Preview, then create a signed webhook. |
set_workspace_webhook_enabled | Changes | Turn a webhook on or off. |
list_workspace_webhook_deliveries | Reads | Read the last 100 deliveries of a webhook. |
test_workspace_webhook | Changes | Send a test event to a webhook. |
retry_workspace_webhook_delivery | Changes | Send a failed delivery again. |
FanGate #
Main permission: Manage workspace setup.
| Tool | Type | What it does |
|---|---|---|
get_workspace_fangate_connection | Reads | Read whether the creator is connected to FanGate, and its currency. |
list_workspace_fangate_jobs | Reads | List the FanGate items and packs and their state. |
prepare_workspace_fangate_media | Changes | Prepare one Vault media for FanGate, with a price. |
create_workspace_fangate_pack | Changes | Make one FanGate checkout from 1 to 10 ready media. |
update_workspace_fangate_job | Changes | Refresh, reprice or retry a FanGate item. |
Team #
Main permission: Manage workspace setup.
| Tool | Type | What it does |
|---|---|---|
list_workspace_employees | Reads | List the employees and the permissions they can get. |
save_workspace_employee | Changes | Create or change an employee. Takes effect at once. |
disable_workspace_employee | Changes | Turn an employee off, keeping the history. |
send_workspace_employee_invitation | Changes | Send the invitation e-mail to a saved employee. |
Billing and licences #
Main permission: Read sales; changes need Spend the balance on licences.
| Tool | Type | What it does |
|---|---|---|
get_workspace_balance | Reads | Read whether Lana can answer fans and how many licences the balance buys. Amounts need Read sales; Manage workspace setup alone sees no amount. |
list_workspace_ledger | Reads | Read Billing > Activity, newest first: top ups, fees, refunds, licence purchases. |
list_workspace_licences | Reads | Read the licences: stock, price, each account, renewals. |
assign_workspace_licence | Changes | Give one Telegram account a licence, paid from the balance. |
set_workspace_licence_auto_renew | Changes | Turn auto-renew on or off for one account. |
Note The list follows the server. When LanaChat adds a tool, your assistant sees it at its next connection, before this page is updated.