Skip to main content
Glama
Telegram Gifts Analyst MCP Server

Telegram Gifts Analyst MCP Server

by GIFT-ASSET

🎁 Telegram Gifts Analyst | MCP Server

Python Docker MCP Platform

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.


πŸ› οΈ Exposed Tools (MCP Endpoints)

The server exposes the following tools, allowing AI agents to dynamically fetch and aggregate Telegram Gifts market data:

Tool

Description

Key Arguments

get_gift_info

Fetches high-resolution data for a specific gift instance.

slug (e.g., 'plushpepe-1')

get_market_actions

Tracks global market movements (buys, listings, state changes) across all supported marketplaces.

page, mode, action_type, gift, price filters

get_gifts_aggregator

Queries highly-filtered, unified market data combining multiple parameters.

page, name, model, symbol, backdrop, price filters

get_unique_last_sales

Retrieves the most recent unique sales for a specified collection.

collection_name, limit, model_name

get_all_collections_last_sale

Gathers the absolute last sale data across all providers for all collections.

None

get_gifts_update_stat

Provides daily statistical tracking of gift improvements and upgrades.

None

get_ton_price

Fetches the current exchange rate of TON (The Open Network) in USD.

None

get_gifts_price_list

Returns current floor prices for all collections across all marketplaces (GetGems, MRKT, Portals, Tonnel).

models, premarket

get_gifts_price_list_history

Returns historical price data (24h hourly, 7d daily) for gift collections.

collection_name

get_gift_by_name

Finds a specific gift by its exact name (e.g., 'EasterEgg-1').

name

get_gift_by_user

Scans and returns the detailed gift inventory of a specified Telegram user.

username, limit, offset

get_all_collections_by_user

Lists all collections owned by a user with filtering options.

username, telegram_id, include, exclude

get_user_profile_price

Calculates total profile valuation and lists top gifts with market data.

username, telegram_id, limit, offset

get_unique_gifts_price_list

Returns detailed information on collection gift prices.

collection_name

get_gifts_collections_emission

Tracks unique gifts issue inside collections.

None

get_gifts_collections_marketcap

Calculates the overall market-cap of gifts.

None

get_gifts_collections_health_index

Evaluates collection health (liquidity, mcap, whales).

None

get_gifts_collections_greed_index

Tracks greed index metrics (hidden, upgraded, owners).

None

get_providers_volumes

Provides aggregated sales volumes from all providers.

None


Related MCP server: Financial Modeling Prep MCP Server

πŸš€ Prerequisites

  • 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


πŸ”Œ Connecting to an AI Agent

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.

  1. 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"
      ]
    }
  }
}

🐍 Option 2: Using a Local Python Environment

If you prefer running it locally via Python, follow these steps:

  1. Setup the environment:

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r requirements.txt
  1. 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"
      }
    }
  }
}

πŸ’» Standalone Testing

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to fetch live crypto prices and market data, convert between crypto and fiat, track EVM gas fees, value portfolios, calculate profit/loss, and view historical charts and trending metrics with zero configuration required.
      10
      75 npm
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to access and analyze financial data, stock information, company fundamentals, and market insights through 250+ tools covering stocks, ETFs, crypto, forex, commodities, and economics.
      558 npm
      Apache 2.0
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to access and analyze financial data, stock information, company fundamentals, and market insights through 250+ tools covering stocks, ETFs, crypto, forex, commodities, and economics.
      558 npm
      Apache 2.0
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to access and analyze financial data, stock information, company fundamentals, and market insights through 250+ tools spanning stocks, ETFs, crypto, forex, commodities, economics, and more.
      558 npm
      Apache 2.0