# Complete MCP Tool Catalog (All 41 Tools)

> Detailed reference for every MCP tool (41 tools) exposed by Botlify Cloud for autonomous AI agents and code assistants.

**Category:** AI Agent & MCP Integration  
**URL:** https://docs.botlify.cloud/mcp-tools  
**Platform:** Botlify Cloud (https://botlify.cloud)  

---

## 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. |