Skip to main content
Glama
barkoszloy

tg-id-mcp

by barkoszloy
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

tg-id-mcp

MCP server for Telegram user/chat lookup with datacenter detection and account age estimation.

Works with Claude Code, Claude Desktop, and any MCP-compatible client.

Features

Tool

Description

user_info

Look up any user, group, or channel by @username or numeric ID

dc_detect

Detect which Telegram datacenter (DC1-DC5) hosts an account

estimate_age

Estimate when an account was created based on its ID

send_message

Send a message via your Telegram bot

check_membership

Check if a user is a member/admin/banned in a chat

get_me

Verify bot connection and capabilities

dc_map

Get the full datacenter location map

Datacenter Detection

Telegram assigns each account to one of 5 datacenters at registration. This server extracts the DC from the user's profile photo file_id — a technique not available through the standard Bot API.

DC

Location

Typical regions

DC1

Miami, USA

Early accounts, Americas

DC2

Amsterdam, NL

Europe, CIS

DC3

Miami, USA

Americas (expansion)

DC4

Amsterdam, NL

Europe (expansion)

DC5

Singapore, SG

Asia-Pacific

Account Age Estimation

Telegram IDs are assigned roughly sequentially. Using known reference points (2013–2025), this server estimates when an account was created with ±2-3 month accuracy, and assigns a badge:

  • Veteran — 10+ years (2013–2015)

  • Experienced — 5-10 years (2016–2020)

  • Seasoned — 2-5 years (2021–2023)

  • Regular — 1-2 years

  • Newcomer — < 1 year

Related MCP server: io.github.daedalus/mcp-telegram-bot

Quick Start

Claude Code

claude mcp add tg-id-mcp -e TELEGRAM_BOT_TOKEN=YOUR_TOKEN -- uvx tg-id-mcp

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "tg-id-mcp": {
      "command": "uvx",
      "args": ["tg-id-mcp"],
      "env": {
        "TELEGRAM_BOT_TOKEN": "YOUR_BOT_TOKEN"
      }
    }
  }
}

From source (development)

git clone https://github.com/barkoszloy/tg-id-mcp.git
cd tg-id-mcp
uv run tg-id-mcp

Getting a Bot Token

  1. Open @BotFather in Telegram

  2. Send /newbot and follow the prompts

  3. Copy the token (looks like 123456789:ABCdefGHIjklMNO...)

Usage Examples

Once connected, ask Claude:

  • "Look up @durov on Telegram"

  • "What datacenter is user 123456789 on?"

  • "How old is Telegram account 777000?"

  • "Send 'Hello!' to chat -1001234567890"

  • "Is user 123456789 a member of @mychannel?"

How It Works

Datacenter detection decodes the base64 file_id from a user's profile photo. Byte 4 in the decoded structure contains the DC number (1-5). This works because Telegram stores files on the same DC as the account.

Age estimation uses a lookup table of 41 known ID→date reference points, collected from public research and early account screenshots. The table maps ID ranges to approximate registration months from August 2013 to December 2024.

Related

  • @usergtidbot — Telegram bot with the same features + visual ID cards, QR codes, username history, inline mode

  • GitHub

License

MIT

This server cannot be installed

A
license - permissive license
-
quality - not tested
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • mcp-telegram

    Prgebish
    A
    license
    -
    quality
    D
    maintenance
    MCP server that connects AI assistants to your real Telegram account via User API (MTProto). Features default-deny ACL with per-chat permissions, message search, file sending, forwarding, media downloads, and rate limiting.
    Last updated
    2
    MIT

  • telegram-user-mcp

    22syn
    A
    license
    -
    quality
    B
    maintenance
    An MCP server that connects to Telegram as your real user account and exposes read-only tools to read and search messages, list chats and folders, inspect group info, and download media.
    Last updated
    20
    MIT

  • telegram-notes-mcp

    RaspizDIYs
    A
    license
    A
    quality
    C
    maintenance
    A local MCP server that enables full-text and semantic search over your own Telegram chats using your personal MTProto login, with everything running locally.
    Last updated
    7
    MIT

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/barkoszloy/tg-id-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server