Releases

Clearer Telegram lookup for AI agents

Improved

• MCP tools now explain when to use username lookup, authorized phone lookup or related public channel discovery.
• Tool descriptions distinguish account research from unsupported message search, private conversations, sending messages and topic searches.
• Updated MCP guide and AI agent page with account lookup examples and clearer result interpretation.
• New reusable username lookup prompt. A missing match does not prove someone has no Telegram account, and a profile match does not establish real-world identity.

Administration

• Execution events record duration, input and match counts, batch errors and available OAuth client/session IDs. Existing free-tier quota accounting is preserved.

ChatGPT publication remains subject to tool review. These changes do not mean the app has been approved for the directory.

Telegram Finder for AI Agents

New

• Hosted MCP server for finding Telegram accounts by authorized phone number or username, and discovering similar public channels.
• OAuth 2.1 authorization with a dedicated consent screen, so agents connect without copying API keys into their configuration.
• Telegram Finder CLI v0.0.1 for detecting compatible agents, installing the MCP connection, starting authentication, and checking connection health.
• New AI Agents setup experience with guided and manual configuration paths.
• New Developer Hub with dedicated guides for the MCP server and REST API.

Install

Run npx telegram-finder setup, or connect a compatible MCP client directly to https://www.telegram-finder.io/mcp.

Improved

• Shared Telegram lookup services now power both the REST API and MCP tools for more consistent validation, limits, and results.
• Updated navigation, metadata, and machine-readable developer documentation for easier integration discovery.

Similar Channels & Better Discovery

New

• Similar Telegram Channels finds public channels recommended by Telegram from a username or t.me link.
• Channel results include descriptions, subscriber counts, verification status, and direct Telegram links.

Improved

• Reworked navigation, footer links, and related resources to make tools and lookup options easier to discover.
• Channel searches require an account and include request limits to protect reliability.

Account Health & Username Reliability

New

• Telegram Account Health (beta) to review account activity and surface practical health signals.
• Refined search history access with clearer Premium upgrade guidance.

Improved

• Username checks reliability improvements.

Premium Batch Username API & 30-Day Lookup Pass

New

• Premium batch username API endpoint for checking multiple usernames, with paced requests to reduce rate-limit errors.
• 30-Day Lookup Pass: 10 successful lookups for €9.90. It ends automatically after 30 days with no renewal.
• Improve Legal & Privacy compliance pages.

Telegram Growth Foundation

New

• Docs moved to /docs (/swagger if you prefer API specs)
• New Contacts Management
• Step-by-step enrichment to identify Telegram accounts
• Centralized Contact Book (app contacts + Telegram contacts)
• Import: CSV / Excel / JSON
• Email / LinkedIn → Phone enrichment (1 credit only if a phone is found)
• API access (Premium only)

Limits

• Premium: 100 phone → Telegram searches / hour
• Free: 2 searches / day

Why this matters

This release lays the groundwork for a more structured and scalable way to find Telegram profiles from real-world identifiers.

Account Warm-up & OSINT Enhancements

New

• Telegram account warm-up tool (beta)
• Username availability checker
• OSINT improvements and reliability tweaks

Premium Features & User Accounts

New

• Premium search options: LinkedIn profile + email lookup
• User accounts + search history
• Ability to link a Telegram account for better accuracy
• Premium plans with higher limits

Initial Release

New

• Phone number search (Telegram API)
• Free tier: 3 searches / day
• Basic user info results