Telegram Finder +0 searches last 7 days
Find and verify people on Telegram
Use the Telegram MCP server for Telegram username lookup, available profile information and authorized phone lookup. Approve access through OAuth and ask your agent to check a known identifier.
Client setup
Configure your agent
Choose Codex, Claude Code, Cursor, VS Code or Windsurf and get the exact install command.
Example requests
Find and verify people on Telegram.
Supply a known username or authorized phone number for account lookup, or a public channel for related-channel discovery. Telegram Finder does not search private conversations, send messages or download chats. A profile match helps with research but does not prove a person's identity.
- Find the Telegram account for @durov
- Check whether @durov exists on Telegram
- Find Telegram information for this contact using their authorized phone number +12025550123
- Verify these Telegram usernames: @durov and @sample_user
- Find public channels similar to https://t.me/telegram
Definitions
Focused tools for Telegram discovery
Each tool mirrors the REST API permissions and plan limits.
find_telegram_by_phone
Find available Telegram profiles for up to 10 supplied phone numbers you are permitted to process. A missing match does not prove the contact has no account.
find_telegram_by_username
Find a user account, check whether a known username resolves and retrieve available profile information. One username for free accounts, up to 10 for premium. Does not check registration availability or search messages.
find_similar_telegram_channels
Discover public channels similar to a supplied public channel username or t.me link. Requires a seed channel; does not search topics, posts or people.
telegram-finder://docs/quickstart
Developer resource covering OAuth, the REST API, request formats and current limits.
lookup_telegram_account
Reusable prompt to find and check a supplied Telegram username and explain the available profile result.
integrate_telegram_finder
Prompt for planning an integration for an application, workflow or agent.
Connection flow
Remote MCP with browser-based OAuth
Use the hosted endpoint from a compatible client. Telegram Finder handles authorization centrally, so credentials do not need to be copied into project files.
- Connect the hosted endpointConfigure your MCP client with https://www.telegram-finder.io/mcp or use the Telegram Finder CLI to update a supported client.
- Approve access with OAuthYour client opens a browser authorization flow. Sign in to Telegram Finder and approve the requested connection.
- Call a focused toolThe client discovers the available tools and can run an authorized lookup within your existing account limits.
Implementation notes
What to know before connecting a client
These details apply to the hosted Telegram Finder MCP server and its current lookup tools.
No. The hosted server uses browser-based OAuth authorization. Your client stores its authorized connection instead of a Telegram Finder API key.
Telegram Finder provides guided setup for Codex, Claude Code, Cursor, VS Code and Windsurf. Other clients can connect when they support remote HTTP MCP servers and browser authorization.
MCP tools use the permissions and lookup limits attached to the connected Telegram Finder account. The MCP connection does not bypass plan or request limits.
A missing result does not prove that a person has no Telegram account. Availability depends on the submitted identifier, accessible data and Telegram privacy settings.
Build with Telegram Finder
Use MCP for agents and development assistants, or integrate the REST API directly.