🚀 Telegram Member Adder — Grow Your Channel Automatically

Copy members from any Telegram group to your channel — safely, automatically, and with zero coding.
Pay only $0.01 per member successfully added. No monthly fees, no subscriptions.

---

🧠 Native MCP Server — AI Agent Ready

This Actor is now a native MCP (Model Context Protocol) server. AI agents like Claude, ChatGPT, Cursor, Copilot, and any MCP-compatible client can discover and invoke its tools directly over HTTP — no adapters needed.

Connect as an MCP client:

{
  "mcpServers": {
    "telegram-member-adder": {
      "url": "https://your-actor.apify.actor/mcp"
    }
  }
}

Available MCP Tools

Tool	What it does
fetch_members	Fetch member list from a Telegram source group/channel
add_members	Full pipeline: fetch → filter → add to target with flood protection
simulate_add	Dry-run simulation — preview who would be added (no real adds)
filter_members	Apply language/keyword/premium filters to an existing member list
check_account	Validate a Telegram session string format

Why a native MCP server? Other Telegram tools require external adapters or the hosted mcp.apify.com proxy. This Actor is an MCP server — deploy it, and AI agents talk to it directly. The first and only Telegram member adder with native MCP server support on Apify.

---

🏆 Why this is the best Telegram member adder on Apify

Feature	❌ Other adders	✅ This Actor
Input interface	Raw JSON — confusing for non-devs	✅ Beautiful form with emojis, sections, clear labels
Auth	QR code every run or external JSON file	✅ Session string — one-time setup, reusable forever
Multi-account	Single account only	✅ Multi-account rotation + per-account cooldown
Flood control	None — accounts get banned	✅ Smart delays + automatic cooldown when Telegram limits hit
Member filters	None	✅ Language, bio keywords, Premium filter
Output format	Visual log only	✅ Structured JSON dataset with 2 views (Summary + Technical)
MCP / AI ready	No	✅ Native MCP server — direct protocol support, no adapters needed
Pricing	$0.01 per start + $0.01 per result	✅ Only $0.01 per member added — runs with 0 adds cost $0
Safe mode	No — you add or nothing	✅ Safe mode — simulate first, see results before adding
Account safety	No protection	✅ Random delays, flood detection, cooldown system

🎯 Perfect for

• Community builders — grow your Telegram group or channel
• Course creators — invite relevant members from related communities
• Crypto/NFT projects — build your Telegram audience
• Marketing teams — targeted member acquisition
• AI agents — use MCP tools to automate Telegram member management
• Anyone who wants to grow their Telegram presence safely

🛡️ Safety first

We take Telegram safety seriously:

• Random delays between adds (you control min/max)
• Automatic flood detection & cooldown
• Multi-account rotation to distribute activity
• Safe mode — test with zero risk before going live

🎮 How it works

1. Connect your Telegram account (session string, no QR)
2. Pick a source group → we fetch members
3. Optional filters → we select only the right people
4. Pick your target channel → we add them safely
5. Get a clean dataset → see exactly what happened

Or use the MCP tools from any AI agent to do steps 2–5 programmatically.

📊 What you get

Each run produces a structured dataset with:

• ✅ Who was added successfully
• ⏭️ Who was already in the group
• 🔒 Who couldn't be added (privacy settings)
• ⏳ Who was skipped (flood protection)
• 🔍 All safe mode results

Perfect for AI agents, MCP workflows, and data analysis.

💰 Pricing

• Model: Pay Per Event
• Price: $0.01 per successfully added member
• Free tier: Apify free plan credits ($5/month) apply automatically
• Zero risk: A run with 0 successful adds costs $0
• MCP tool calls: $0.001–$0.01 per tool invocation (configured in pay_per_event.json)

🚀 Quick start

1. Get your Telegram API credentials at https://my.telegram.org
2. Set TELEGRAM_API_ID and TELEGRAM_API_HASH in Actor settings
3. Generate a session string (instructions below)
4. Run with Safe mode ON to test
5. Turn off safe mode when you're ready
6. Or connect via MCP — point your AI agent to the Actor's /mcp endpoint

How to get your session string

pip install telethon
python -c "
from telethon.sync import TelegramClient
from telethon.sessions import StringSession
API_ID = YOUR_API_ID
API_HASH = 'YOUR_API_HASH'
with TelegramClient(StringSession(), API_ID, API_HASH) as client:
    print(client.session.save())
"

🔧 Input fields

Field	What it does
Session strings	Your Telegram account key (one-time setup)
Source group	Where to take members from
Target channel	Where to add members
Safe mode	Simulation — see results without adding anyone
Max members	How many to process
Min/Max delay	Wait time between adds (seconds)
Language filter	Only add users with specific language
Bio keywords	Only add users whose bio mentions certain words
Premium only	Only Telegram Premium users

📋 Output fields

Field	Description
✅ Status emoji	Quick visual: added, skipped, error
First/Last name	Member's profile name
Username	@username (if public)
Result	Plain language: "Added successfully", etc.
Plan	⭐ Premium or Free
Status code	Technical code for developers

🧪 Verification

The MCP server implementation passes 10 automated tests:

• ✅ All 5 tools registered with FastMCP
• ✅ Every tool has a valid input schema
• ✅ No unexpected tools exposed
• ✅ Module imports cleanly
• ✅ MCP instructions contain tool descriptions
• ✅ Readiness probe (GET /) returns 200
• ✅ MCP tools/list returns all 5 tools over HTTP
• ✅ MCP check_account tool works (pure validation)
• ✅ MCP ping/pong works
• ✅ Tools/call with invalid args returns proper errors

Run tests: .venv/bin/python -m pytest test_mcp_server.py -v

📝 License

This Actor is provided for legitimate community building purposes.
Always respect Telegram Terms of Service and applicable privacy laws.
Use only on groups and channels you own or have explicit permission to manage.