Telegram Finder +0 searches last 7 days
Telegram Finder for agents
Install Telegram Finder in your development assistant or agent, approve access through OAuth, then run phone-to-Telegram lookups with your existing plan limits.
Client setup
Configure your agent
Choose Codex, Claude Code, Cursor, VS Code or Windsurf and get the exact install command.
Definitions
Focused tools for Telegram discovery
Each tool mirrors the REST API permissions and plan limits.
find_telegram_by_phone
Authenticated tool that searches up to 10 authorized phone numbers with the same plan limits as the REST API.
find_telegram_by_username
Resolves one username for authenticated users or up to 10 at once for premium accounts.
find_similar_telegram_channels
Returns Telegram recommendations for a public channel username or t.me link.
telegram-finder://docs/quickstart
Developer resource covering OAuth, the REST API, request formats and current limits.
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.