Model Context Protocol (MCP) Server Integration

What is the Botlify MCP Server?

The Botlify Model Context Protocol (MCP) Server (located at https://botlify.cloud/mcp/v1) is a standardized, production-grade JSON-RPC 2.0 server implementing the open Model Context Protocol (spec 2024-11-05). It allows autonomous AI agents and modern AI IDEs (such as Cursor, Claude Desktop, Windsurf, Google Antigravity, and custom LLM workflows) to directly build, deploy, query, and monitor Telegram bots inside their isolated cloud sandboxes.

Key Server Specifications
• Endpoint URL: https://botlify.cloud/mcp/v1
• Protocol Version: 2024-11-05 (JSON-RPC 2.0)
• Authentication: API Key via X-API-KEY header, Authorization: Bearer <key>, or ?token=<key>
• Capabilities: tools (41 tools), resources (live schemas/logs), prompts (guided audits)

Connecting Your AI IDE to Botlify Cloud

JSON — Cursor Configuration (.cursor/mcp.json)

{
  "mcpServers": {
    "botlify": {
      "url": "https://botlify.cloud/mcp/v1",
      "headers": {
        "X-API-KEY": "YOUR_BOTLIFY_API_KEY"
      }
    }
  }
}

JSON — Claude Desktop Configuration (claude_desktop_config.json)

{
  "mcpServers": {
    "botlify-cloud": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://botlify.cloud/mcp/v1?token=YOUR_BOTLIFY_API_KEY"
      ]
    }
  }
}

Supported MCP Primitives

MCP Primitive	Protocol Method	Description & Available Resources
Tools	`tools/list`, `tools/call`	41 executable functions covering bot creation, deployment, file editing, SQLite queries, crons, broadcasts, and webhook tests.
Resources	`resources/list`, `resources/read`	Direct read access to real-time bot metadata, database schemas, and guides: `fbh://docs/botmaking` — Complete Bot Making Guide `fbh://bots/{id}/info` — Bot runtime metadata `fbh://bots/{id}/schema` — Live SQLite tables & columns `fbh://bots/{id}/env` — Active environment variables
Prompts	`prompts/list`, `prompts/get`	Pre-configured AI assistant workflows: `bot_health_check` — Automated diagnostic suite `code_audit_and_enhance` — Security & WAL optimization audit `create_styled_keyboard_bot` — Scaffolds Telegram 8.0 styled bots `send_rich_broadcast` — Universal broadcast composer

Server Health & Diagnostic Metadata Endpoint

Sending a standard HTTP GET request to mcp/v1 returns connectivity status and verified user authentication metadata:

JSON — GET https://botlify.cloud/mcp/v1 Response

{
  "server": "Botlify MCP Server",
  "protocolVersion": "2024-11-05",
  "status": "online",
  "authenticated_user": {
    "chat_id": "123456789",
    "username": "johndoe",
    "first_name": "John"
  },
  "capabilities": ["tools", "resources", "prompts"],
  "docs": "https://docs.botlify.cloud/?page=mcp-overview"
}