🚀 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, $0 if nothing is added.

💡 Why pay-per-result wins: most Telegram adders charge $20/month rental whether they work or not. This one charges only for members actually added — and a run that adds nobody is free.

---

🧠 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 bio-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	✅ Real bio-keyword matching + Telegram 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	$20/month rental — pay even if it fails	✅ 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 — no monthly fee, no rental, no subscription.

• Main price: $0.01 per member successfully added. A run that adds nobody costs $0.

• Free tier: Apify free plan credits ($5/month) apply automatically.

• AI / MCP tool calls (only when used by an AI agent over MCP):

  Tool call	Price	Notes
  member-added	$0.01 / member	Only members actually added
  fetch_members	$0.004 / call	Read-only member listing
  simulate_add	$0.004 / call	Free-preview dry run
  filter_members	$0.001 / call	Pure computation
  check_account	$0.001 / call	Session format check

  The full add_members pipeline has no flat fee — you only pay per member added.

🚀 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

Your session string is your Telegram account key — generate it once and reuse it. Treat it like a password.

pip install telethon
export TELEGRAM_API_ID=123456            # from https://my.telegram.org
export TELEGRAM_API_HASH=your_api_hash
python gen_session.py                    # prints your session string

Copy the printed string into the Your Telegram account field. You can paste several strings to rotate accounts.

🔧 Input fields

Field	What it does
Session strings	Your Telegram account key (one-time setup)
Source group	Where to take members from
More source groups	Optional — pull from several groups at once (merged & de-duplicated)
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)
Bio keywords	Only add users whose real bio or name 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

🔗 Multiple source groups & duplicates

• Multiple sources: fill More source groups to pull members from several groups in one run. Members found in more than one group are automatically de-duplicated — each person is processed once.
• Already in your target? People who are already members of your target channel are detected and skipped up front — no wasted attempts (which would count toward Telegram's limits) and no charge for them. Telegram itself also rejects duplicate adds, so it's safe either way.

❓ FAQ & Troubleshooting

Why weren't all members added? This is normal and expected. Telegram lets each user block being added to groups in their privacy settings. Those members come back as privacy_restricted and cannot be added by anyone — no tool can bypass this. In practice, a healthy run adds roughly 5–30% of a group's members. You are only charged for the ones actually added.

Common result statuses:

Status	Meaning	Charged?
added ✅	Successfully added	Yes ($0.01)
already_participant ⏭️	Already in your channel	No
privacy_restricted 🔒	User blocks group-adds (Telegram limit)	No
chat_write_forbidden 🚫	Your account lacks invite rights on the target	No
skipped_floodwait ⏳	Telegram rate limit hit — account paused	No
error:no_access_hash	Member couldn't be resolved — re-run the fetch	No

"Session string is not authorized" — regenerate it with gen_session.py; sessions can expire or be revoked.

Nothing gets added / chat_write_forbidden — make sure the account is an admin (or has invite permission) on the target channel, and is a member of the source group.

How do I stay safe from Telegram limits? Keep the default slow delays (min 30s / max 90s), start with a small Max members (100–500), and use multiple accounts to spread the load. The Actor automatically detects flood limits and puts accounts into cooldown.

Best practice: always run Safe mode (dry run) first to preview who would be added — it's free and risk-free.

✅ Quality & reliability

The MCP server and core logic ship with an automated test suite (tool registration, schemas, HTTP protocol, readiness probe, ping, and error handling) so every release behaves predictably for both humans and AI agents.

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.