Skip to main content
Glama
telegram-osint-mcp

telegram-osint-mcp

by willowswt
README.md
[![Glama MCP Server](https://glama.ai/mcp/servers/willowswt/telegram-osint-mcp/badges/score.svg)](https://glama.ai/mcp/servers/willowswt/telegram-osint-mcp) [![Apify Store](https://img.shields.io/badge/Apify_Store-telegram_scraper-00C853?logo=apify&logoColor=white)](https://apify.com/church_of_loujess/telegram-scraper) [![MCP Protocol](https://img.shields.io/badge/MCP-2025--06--18_Streamable_HTTP_%26_stdio-blue)](https://modelcontextprotocol.io) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

# Telegram Public Channel, Messages & OSINT Scraper MCP Server

MCP server for extracting public Telegram channel profiles, paginated message history, outbound URLs, emails, crypto addresses, and LLM-ready Markdown via Apify.

> **Hosted Apify MCP Gateway URL:** `https://mcp.apify.com/?actors=church_of_loujess/telegram-scraper`  
> **Get Your Free API Token (`$5.00/mo` Free Credit Included):** [Apify Console -> Settings -> Integrations](https://console.apify.com/settings/integrations)  
> **Primary Apify Store Actor:** [https://apify.com/church_of_loujess/telegram-scraper](https://apify.com/church_of_loujess/telegram-scraper)

## Included MCP Tools

| Tool Name | Backing Apify Actor | Description |
| :--- | :--- | :--- |
| `scrape_telegram_channel_messages` | `telegram-scraper` | Extract public Telegram channel messages, views, forwards, outbound links, emails, crypto wallet/contract addresses, and RAG-ready Markdown. |
| `get_telegram_channel_profile` | `telegram-scraper` | Retrieve public Telegram channel metadata (subscriber count, description, verified status, avatar, links) in profile-only mode. |

## Quick Start (Claude Desktop, Cursor, Windsurf, VS Code)

### Option 1: Local `stdio` via `npx`
```json
{
  "mcpServers": {
    "telegram-osint-mcp": {
      "command": "npx",
      "args": ["-y", "github:willowswt/telegram-osint-mcp"],
      "env": {
        "APIFY_API_TOKEN": "<YOUR_APIFY_API_TOKEN>"
      }
    }
  }
}
```

### Option 2: Remote Hosted Apify MCP Gateway (Zero Install)
```json
{
  "mcpServers": {
    "telegram-osint-mcp": {
      "url": "https://mcp.apify.com/?actors=church_of_loujess/telegram-scraper",
      "headers": {
        "Authorization": "Bearer <YOUR_APIFY_API_TOKEN>"
      }
    }
  }
}
```

## Free Trial vs. Paid Apify Plan

- **Apify Free Tier (`$5.00/mo` included credit):** Returns up to `5` items per run (`items 1-2` 100% unmasked, `items 3-5` preview-masked) so you can verify live email/data quality risk-free.
- **Apify Starter (`$29/mo`) & Higher:** Unlocks unlimited batch sizes (`1,000+` items), `100%` unmasked emails and payloads, and up to `76%` lower per-item rates. Upgrade anytime at [https://console.apify.com/billing/subscription](https://console.apify.com/billing/subscription).