# leadli.me

> leadli.me is an MCP server for marketing and seo. Manage Telegram channels, bots, ad attribution and landing pages through 47 MCP tools. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Platforms:** API, Web, telegram
- **Website:** https://leadli.me/en/guides/mcp-server
- **MCP Registry name:** me.leadli/mcp
- **Categories:** [marketing and SEO](https://ai-powered.com/categories/marketing-and-seo)
- **Listing updated:** 2026-11-14

## About

This is leadli.me's reference for connecting an assistant to its Telegram growth platform. Authentication is a bearer access key created under Organization settings, and tools are scoped to the channels that key's creator can reach.

The tools cover reading attribution analytics (clicks, confirmed joins and delivered conversions, using click-time cohorts), listing observed joins and subscribers, saving or withdrawing spam, fake and scam reports, and banning or unbanning observed people from a channel. Setup tools create draft channels and bots, connect a Telegram bot, verify permissions, activate or disable a channel, and link Meta and TikTok datasets for conversion reporting. Further sections cover landing pages, a browser SDK and Telegram notifications.

The guide advises confirming the channel, person and consequence before any change, never showing tokens or botKey in answers, and treating missing ad attribution as unknown rather than organic.

## Features

- **Attribution analytics:** Reports clicks, confirmed joins and delivered conversions with hour, day or week granularity.
- **Join and subscriber lists:** Lists observed join events and subscribers with filters for ad, campaign and source.
- **Spam and scam reports:** Saves, lists and withdraws organisation reports on observed subscribers.
- **Channel and bot setup:** Creates drafts, verifies Telegram permissions, then activates or disables.
- **Meta and TikTok links:** Verifies and saves ad-platform dataset connections.
- **Read-first workflow:** Example prompts check context and readiness without changing anything.

## Good for

- Check which channels a key can access and its permissions
- Report clicks and confirmed joins for the last 7 days
- Find out if a new channel is ready to activate
- Ban a reported spammer from a channel after confirmation

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://api.leadli.me/api/v1/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.leadli.me/api/v1/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://api.leadli.me/api/v1/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://api.leadli.me/api/v1/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://api.leadli.me/api/v1/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://api.leadli.me/api/v1/mcp"
    }
  }
}
```

## Tools

- `leadli_get_context`: Get the key's organization, permissions, tools and plan access.
- `leadli_list_channels`: List channels accessible to the key creator.
- `leadli_get_channel`: Get channel details and safe Telegram setup metadata.
- `leadli_get_analytics`: Get attribution aggregates for a time range.
- `leadli_list_joins`: List observed join and rejoin events.
- `leadli_list_subscribers`: List observed subscribers.
- `leadli_get_report_status`: Get report status for up to 100 subscriber IDs.
- `leadli_save_report`: Save an organization report for a subscriber.
- `leadli_withdraw_report`: Withdraw an organization report.
- `leadli_list_organization_reports`: List the organization's reports.
- `leadli_withdraw_organization_report`: Withdraw one organization report.
- `leadli_ban_subscriber`: Ban an observed person from the channel.
- `leadli_unban_subscriber`: Remove a ban.
- `leadli_create_channel`: Create a draft Telegram channel.
- `leadli_create_bot`: Create a draft Telegram bot.
- `leadli_get_bot_code`: Read what the bot's server needs.
- `leadli_connect_bot_token`: Store a BotFather token.
- `leadli_update_channel`: Update the channel name.
- `leadli_connect_telegram_bot`: Connect and verify a Telegram bot.
- `leadli_set_telegram_destination`: Set the Telegram channel reference.
- `leadli_verify_telegram_destination`: Verify bot permissions for the channel.
- `leadli_get_setup_status`: Read channel readiness checks.
- `leadli_activate_channel`: Activate the channel.
- `leadli_disable_channel`: Disable channel attribution.
- `leadli_set_meta_connection`: Verify and save a Meta dataset connection.
- `leadli_remove_meta_connection`: Disconnect from Meta.
- `leadli_set_tiktok_connection`: Verify and save a TikTok pixel connection.

## FAQ

### How do I authenticate?

Send Authorization: Bearer with an access key created in Organization settings, Access keys.

### What transport does it use?

Streamable HTTP.

### How many tools are there?

47, listed with parameters in the tool reference.

### Is a missing attribution the same as organic traffic?

No. The guide says missing ad attribution is unknown, not proof of organic traffic.

### How do I add leadli.me to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://api.leadli.me/api/v1/mcp

### What are the best alternatives to leadli.me?

The closest alternatives to leadli.me are AdminHub for Telegram, Links, FreeSpy, LeadMe and TG Market.

## Where this comes from

- Description: written from the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [AdminHub for Telegram](https://ai-powered.com/mcp/adminhub-for-telegram): AdminHub for Telegram is a freemium MCP server for communication.
- [Links](https://ai-powered.com/mcp/links): Links is an MCP server for marketing and seo.
- [FreeSpy](https://ai-powered.com/mcp/freespy): FreeSpy is a freemium MCP server for marketing and seo.
- [LeadMe](https://ai-powered.com/mcp/leadme): LeadMe is a freemium MCP server for marketing and seo.
- [TG Market](https://ai-powered.com/mcp/tg-market): TG Market is a freemium MCP server for analytics and data.
- [Pixelary](https://ai-powered.com/mcp/pixelary): Pixelary is a freemium MCP server for marketing and seo.
- [TikTok Ads MCP Server by AdKit](https://ai-powered.com/mcp/tiktok-ads-mcp-server-by-adkit): TikTok Ads MCP Server by AdKit is an MCP server for marketing and seo.
- [Taseli](https://ai-powered.com/mcp/taseli): Taseli is an MCP server for marketing and seo.

---
Source: https://ai-powered.com/mcp/leadli-me
