Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Telegram Gifts Analyst MCP Server Get the floor price for the PlushPepe collection."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Supercharge your AI agents with the Telegram Gifts Analyst MCP Server.
Built on the Model Context Protocol (MCP), this server acts as a bridge to the api.giftasset.dev API. It equips AI agents (like Claude or custom LLM bots) with a comprehensive suite of tools to fetch real-time market data, analyze user inventories, and track deep analytics for the Telegram Gifts market.
The server exposes the following tools, allowing AI agents to dynamically fetch and aggregate Telegram Gifts market data:
Tool | Description | Key Arguments |
| Fetches high-resolution data for a specific gift instance. |
|
| Tracks global market movements (buys, listings, state changes) across all supported marketplaces. |
|
| Queries highly-filtered, unified market data combining multiple parameters. |
|
| Retrieves the most recent unique sales for a specified collection. |
|
| Gathers the absolute last sale data across all providers for all collections. | None |
| Provides daily statistical tracking of gift improvements and upgrades. | None |
| Fetches the current exchange rate of TON (The Open Network) in USD. | None |
| Returns current floor prices for all collections across all marketplaces (GetGems, MRKT, Portals, Tonnel). |
|
| Returns historical price data (24h hourly, 7d daily) for gift collections. |
|
| Finds a specific gift by its exact name (e.g., 'EasterEgg-1'). |
|
| Scans and returns the detailed gift inventory of a specified Telegram user. |
|
| Lists all collections owned by a user with filtering options. |
|
| Calculates total profile valuation and lists top gifts with market data. |
|
| Returns detailed information on collection gift prices. |
|
| Tracks unique gifts issue inside collections. | None |
| Calculates the overall market-cap of gifts. | None |
| Evaluates collection health (liquidity, mcap, whales). | None |
| Tracks greed index metrics (hidden, upgraded, owners). | None |
| Provides aggregated sales volumes from all providers. | None |
Related MCP server: agent-telegram-mcp
Python: Version 3.11 or higher (or Docker installed).
API Key: You need a valid GIFTASSET_API_KEY to connect to the GiftAsset API.
🔑 Get your key here: @giftassetmcp_bot
You can connect this server to any MCP-compatible client (such as Claude Desktop or Cursor). The API key must be passed via the GIFTASSET_API_KEY environment variable.
Docker provides the cleanest integration without polluting your local Python environment.
Build the image:
docker-compose build
2. **Configure your MCP Client** (e.g., add to `claude_desktop_config.json`):
```json
{
"mcpServers": {
"telegram-gifts": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GIFTASSET_API_KEY=your_api_key_here",
"telegram-gifts-mcp"
]
}
}
}
If you prefer running it locally via Python, follow these steps:
Setup the environment:
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
pip install -r requirements.txt
Configure your MCP Client (e.g., add to claude_desktop_config.json):
Note: You must use absolute paths for both the Python binary and the project directory.
{
"mcpServers": {
"telegram-gifts": {
"command": "/absolute/path/to/your/venv/bin/python",
"args": [
"-m",
"src.server"
],
"env": {
"PYTHONPATH": "/absolute/path/to/giftasset_mcp",
"GIFTASSET_API_KEY": "your_api_key_here"
}
}
}
}
Want to test the server directly via standard I/O before hooking it up to an agent?
export GIFTASSET_API_KEY="your_api_key_here"
python -m src.server
(Note: The server will start in MCP stdio mode, expecting JSON-RPC commands via stdin/stdout).
This server cannot be deployed
Open API Marketplace for AI Agents. Crypto data tools with USDC payments on Base.
Blockchain analytics API for AI agents. Smart Money signals, wallet profiling, token analytics.
Blockchain analytics API for AI agents. Smart Money signals, wallet profiling, token analytics.
Telegram channel analytics and statistics for AI agents, pay-per-call in USDC via x402.