Complete MCP Tool Catalog (All 41 Tools)

Raw MD
Detailed reference for every MCP tool (41 tools) exposed by Botlify Cloud for autonomous AI agents and code assistants.
14 min read Botlify Cloud Updated October 2026

Master Catalog: 41 MCP Tools

The Botlify MCP Server exposes 41 high-level tools allowing AI models to perform end-to-end bot construction, SQLite operations, file manipulation, and automated testing.

1. Botlify Knowledge Base & Documentation Engine (FIRST - Primary AI Entrypoints)

These 4 foundational tools appear at the very beginning of the MCP catalog so any connected AI assistant instantly gains platform awareness, architectural context, and full Telegram API documentation access:

Tool Name Required Arguments Optional Arguments Behavior & Output
about_botlify None (~86 tokens) None Returns comprehensive A-to-Z platform overview: serverless PHP 8.2+ runtime, embedded SQLite WAL mode, security sandbox, and mandatory developer rules.
get_full_docs None (~146 tokens) offset, limit Retrieves complete 1.08 MB master developer documentation (docs.md) spanning 14 chapters and full Telegram API. Supports chunking via byte offset & limit.
list_docs None (~59 tokens) None Lists all 638 documentation topics, guides, and Telegram Bot API methods/types with read times, categories, and direct markdown URLs.
search_docs query (~133 tokens) max_results (default: 10) Fast keyword and phrase search across all Botlify docs and Telegram API references. Returns relevance scores and snippet previews.

2. Bot Lifecycle & Management Tools

Tool Name Required Arguments Optional Arguments Behavior & Output
list_bots None status ("active" | "deleted" | "all") Returns an array of bots with ID, username, webhook status, storage usage, and created date.
get_bot_info bot_id None Detailed bot info including database size, file count, and crons. Accepts numeric ID or @username.
create_bot token admin_chat_id Provisions a new bot sandbox, locks credentials in .env, registers live webhook, and creates SQLite database.db.
delete_bot bot_id permanent (bool) Soft deletes to recycle bin by default; pass permanent=true to purge files and free the slot immediately.
restore_bot bot_id None Recovers a bot from the recycle bin back to active status and resets webhook.
restart_bot bot_id None Refreshes Telegram webhook registration, clears error flags, and re-syncs Telegram connection.
update_bot bot_id token, admin_chat_id Updates BotFather token or owner chat ID in database and synchronizes .env.

2. File System & Code Editor Tools

Tool Name Required Arguments Optional Arguments Behavior & Output
list_files bot_id path Lists all files and directories in bot root or subfolder with size, permissions, and modified timestamp.
read_file bot_id file (default: index.php) Reads file contents. Protected files (e.g. .env) are safely masked.
write_file bot_id, content file (default: index.php) Writes code to specified file inside the isolated bot workspace.
create_file bot_id, name path, content Creates a new file in root or specified subfolder.
upload_file bot_id, name, content path, is_base64 (bool) Uploads binary or text files (supports base64 encoding for images, SQLite backups, and assets).
create_folder bot_id, name path Creates a new sub-directory inside the bot workspace.
delete_file bot_id, file None Deletes a file. System files (.env, database.db) are protected against accidental deletion.

3. Environment Variables (.env) Tools

Tool Name Arguments Behavior
get_env_variables bot_id Returns parsed key-value array and raw text of the bot's .env file.
set_env_variables bot_id, variables (array or string) Bulk overwrites or updates custom environment variables while protecting locked system vars.
set_env_variable bot_id, key, value Sets or updates a single environment variable key-value pair.
delete_env_variable bot_id, key Removes a custom environment variable. Locked system vars (BOT_TOKEN, ADMIN_CHAT_ID, BOT_USERNAME) cannot be deleted.

4. Automated Cron Scheduler Tools

Tool Name Arguments Behavior
list_cron_jobs bot_id Lists all scheduled workers, intervals (e.g. * * * * *), active status, and last execution logs.
create_cron_job bot_id, name, schedule, command Registers a new recurring background worker down to 1-minute intervals.
run_cron_job bot_id, cron_id Manually triggers an immediate execution of the cron worker and returns execution stdout/stderr.

5. SQLite Database Explorer Tools

Tool Name Arguments Behavior
get_database_schema bot_id Returns table list, column names, data types, indexes, and total database size on disk.
query_database bot_id, query Executes SQL query on the bot's local database.db and returns formatted rows.

6. Universal Broadcast Studio Tools

Tool Name Arguments Behavior
get_broadcast_stats bot_id Returns total subscribers in database.db, active users, and delivery telemetry.
send_broadcast bot_id, message, options Initiates a rate-limited mass broadcast to all bot users with customizable call-to-action buttons.

7. User Profile & Account Tools

Tool Name Arguments Behavior
get_profile None Returns user Telegram ID, username, plan tier, bot quota limit, and account stats.

8. Bot Code Transfer System Tools

Tool Name Arguments Behavior
create_bot_transfer bot_id, target_recipient Generates a cryptographic 6-digit transfer code to securely hand off bot ownership.
list_bot_transfers None Lists all pending incoming and outgoing transfers with expiration countdowns.
get_transfer_info transfer_code Inspects transfer details, bot name, and target recipient before claiming.
accept_bot_transfer transfer_code, token, admin_chat_id Claims transferred bot into recipient's account with new BotFather credentials.
reject_bot_transfer transfer_id Cancels or rejects an active transfer request.

9. Bot Building, Validation & Webhook Simulation Tools

Tool Name Arguments Behavior
get_bot_making_guide section (optional) Fetches official Botlify architectural instructions and best practice patterns.
scaffold_bot_code type, bot_name Generates boilerplate starter templates (e.g. styled_keyboard, store_bot, fsm_form).
install_bot_scaffold bot_id, type Directly writes a verified starter template into the bot's index.php.
validate_bot_code code Dual-engine PHP syntax parser and linter. Guarantees 0 syntax errors before file writes.
test_bot_webhook bot_id, update (optional) Simulates an incoming Telegram update (default: /start) and captures output/errors without sending live Telegram messages.
build_and_deploy_bot bot_id, code The Ultimate All-in-One Deployment Tool: Validates PHP syntax, writes to index.php, simulates webhook execution, and returns production status.