Frequently Asked Questions about the MCP Server for UBOS

Q: What is the MCP Server?

A: The MCP Server is a component available on the UBOS Asset Marketplace that implements the Model Context Protocol (MCP). It acts as a bridge between Large Language Models (LLMs) and external data sources, specifically Telegram in this case, allowing AI agents to access and interact with Telegram messages and entities.

Q: What are the key features of the MCP Server?

A: The MCP Server provides functions for retrieving unread messages, getting specific messages or a count of messages from an entity (user, group, channel), getting all entities in the session, getting an entity by ID, and sending messages to an entity with optional markup and replies.

Q: What are some use cases for the MCP Server?

A: Some use cases include automated customer support on Telegram, real-time data analysis of Telegram channels, personalized recommendations based on Telegram activity, smart home automation via Telegram commands, and workflow automation triggered by Telegram messages.

Q: What is UBOS and how does it relate to the MCP Server?

A: UBOS is a full-stack AI Agent Development Platform. The MCP Server can be used in conjunction with UBOS to orchestrate AI Agents, connect them with enterprise data, build custom AI Agents with your own LLM models, and create Multi-Agent Systems.

Q: What are the requirements for using the MCP Server?

A: The requirements include Python, UV (a Python project manager), and the MCP Client. You will also need to obtain your Telegram API ID and hash from My Telegram and configure them in the .env file.

Q: How do I install the MCP Server?

A: First, install the dependencies. Then, configure your Telegram API credentials in the .env file. Next, start the HTTP server using uv run http-server/http-server.py. Finally, install the MCP Server using uv run mcp install mcp-server/mcp-server.py.

Q: I’m encountering issues running the MCP Server with Claude. What should I do?

A: Try installing UV with Brew using the command brew install uv.

Q: I can’t create a new app in Telegram. What could be the issue?

A: Disconnect your VPN and retry creating the app in Telegram.

Q: What license is the MCP Server released under?

A: The MCP Server is released under the MIT license.