+0 searches last 7 days

Telegram Finder for AI agents

Connect Telegram Finder to your coding agent with one command and run authorized phone-to-Telegram lookups through MCP.

Connect your agent Read the MCP docs

TELEGRAM FINDER×

live

YOU · ChatGPT

Find the Telegram account for this authorized number: +33 6 12 34 56 78

TELEGRAM FINDER

find_telegram_by_phone

✓Match found

✓@valentin · Telegram user ID verified

✓Usage recorded against your existing plan

Works with Claude Code, Codex, Cursor, VS Code, Windsurf, Hermes Agent and OpenClaw

Agent workflows

Use Telegram Finder without leaving your agent

Connect once, then use natural-language requests for focused Telegram research tasks involving data you are permitted to process.

Research an existing contact
Ask your agent to check an authorized phone number and return any Telegram account information available to your plan.
Validate a public username
Resolve a known Telegram username without leaving the conversation or copying results between tools.
Discover related channels
Start from a public channel username or t.me link and ask Telegram for related public channel recommendations.

Controlled access

A safer connection than pasting an API key

The hosted MCP server keeps authentication and permissions attached to your Telegram Finder account.

Browser-based authorization
Approve the connection in your browser. Your Telegram Finder API key is never stored in the agent configuration.
Existing plan limits
Requests use the same permissions and lookup limits as your Telegram Finder account, so usage stays predictable.
Explicit, focused tools
The agent receives a small set of documented Telegram lookup actions instead of unrestricted access to your account.

Quick setup

Connect your agent

Choose an agent and run the generated command. Your existing MCP configuration is preserved.

Your agent

Configure Auto-detect my agents

Recommended if you use several agents. The CLI detects compatible MCP clients and lets you choose where to install Telegram Finder.

TERMINAL · ONE-TIME SETUP

$ npx telegram-finder setup

WRITES TOAll detected compatible clients

AUTHBrowser OAuth

SAFETYExisting config backed up

Step 1

Run the setup command

The CLI detects your agents, updates the selected MCP configuration and backs up existing files.

Step 2

Authenticate from your agent

Run telegram-finder auth to see each host-specific action. Add --run to explicitly launch supported native commands, then approve OAuth in your browser.

Step 3

Ask your first question

Return to your agent and run an authorized phone lookup. No API key needs to be copied into the config.

Using another MCP client?

Add the hosted endpoint to any client that supports remote HTTP MCP servers. Authentication still happens securely in your browser on first use.

View the MCP guide

MCP CONFIG · JSON

{
  "mcpServers": {
    "telegram-finder": {
      "url": "https://www.telegram-finder.io/mcp"
    }
  }
}

Need the technical details?

Review the MCP tools, authentication flow and integration guide.

Explore MCP Developer overview