MCP & API

Your Telegram Pipeline, One API Away

Your data shouldn't be trapped behind a dashboard. TeleBoost exposes your entire Telegram funnel — contacts, inbox, campaigns, tickets and analytics — through a hosted MCP server, a versioned REST API, and signed webhooks. Connect Claude, ChatGPT, n8n, or your own code, and let them read your CRM, reply to a lead, or open a ticket.

What MCP is, in one paragraph

MCP — the Model Context Protocol — is an open standard that lets an AI assistant talk to an external tool through a stable, permissioned interface. Instead of copy-pasting data between your CRM and a chat window, you connect the two once: the assistant can then read and act on your live data, on your terms. TeleBoost runs a hosted MCP server, so any MCP-compatible client — Claude, ChatGPT, Cursor, Zed, and more — can work directly with your Telegram pipeline.

Crucially, this works with your real Telegram accounts and CRM, not a bot. The assistant sees the same conversations, contacts and campaigns you do — filtered to exactly the scopes you grant.

Not a bot bolted on the side

Bot APIs only see what a bot is invited to. TeleBoost's MCP and API sit on top of your own accounts and CRM data — the leads you scraped, the campaigns you ran, the replies you earned — so your AI works with the pipeline you actually built.

Tell your AI what to do, not how to do it

Once connected, the assistant has a toolbox: search contacts, read a conversation, update a lead's status, create a ticket, start a campaign, set a reminder, pull analytics — and, when you allow it, send a message. You describe the outcome in plain language; it uses the right tools in the right order.

"Find my Web3 leads who replied this week without an open ticket, open a high-priority ticket for each, and draft a personalized follow-up." — one prompt, done.

  • Search and segment leads by status, engagement score, list or reply history
  • Read conversation history and draft replies in context
  • Create and update tickets, set reminders, move pipeline stages
  • Launch, pause and inspect DM campaigns and their stats
  • Send messages from a connected account — through the same safety-quota pipeline as the app

A REST API for everything else

Not everything is an AI workflow. The same surface is available as a clean, versioned REST API with cursor pagination and a public OpenAPI spec — so you can sync contacts into your warehouse, build an internal dashboard, or wire form submissions straight into your Telegram pipeline. Anything you can do in the app, you can do from your code.

Authentication is a workspace-scoped Bearer key you create in Settings. Keys are shown once, hashed at rest, and revocable instantly. Every request is rate-limited per plan and written to an audit log you can review.

Webhooks that push, so you don't have to poll

Register an HTTPS endpoint and TeleBoost calls you the moment something happens — a lead replies, a ticket is created, a campaign finishes. Every payload is signed with HMAC-SHA256 so you can verify it came from us, delivery is retried with backoff for up to 24 hours, and a failing endpoint is auto-disabled with an alert. Route events into n8n, Make, Zapier, or your own backend.

  • Signed with HMAC-SHA256 — verify every delivery
  • Automatic retries with exponential backoff, up to 24 hours
  • Ten event types across replies, contacts, tickets and campaigns
  • Auto-disable and alert on repeated failures

Access you control, down to the scope

Power without control is a liability, so every credential is least-privilege by default. You choose exactly which scopes a key or connected app gets — read-only, CRM automation, or full access — and whether it operates on your solo data or a specific team. AI apps connect over OAuth 2.1 with PKCE, so no long-lived secret is ever stored on their side, and you can revoke any connection from either end.

Sending is deliberately gated: a key can only send messages if you grant the messages.send scope, and even then every send runs through TeleBoost's proxy-enforced, quota-limited pipeline — the same guardrails that protect your accounts in the app. The API is a front door to what you already have, never a way around your own safety limits.

Freedom with the guardrails left on

You get the full surface of your pipeline through code — and the safety quotas, proxy enforcement and single-session protections stay exactly where they are. The responsibility is yours; the safety net doesn't move.

Hosted MCP server

Connect Claude, ChatGPT, Cursor, Zed and more to your live Telegram pipeline.

Versioned REST API

Contacts, inbox, campaigns, tickets and analytics — with OpenAPI and cursor pagination.

Signed webhooks

HMAC-signed events with retries — push replies, tickets and campaign results anywhere.

Scoped, revocable access

OAuth 2.1 with PKCE or workspace-scoped keys. Least-privilege scopes, instant revocation.

Frequently asked questions

Which AI tools can connect?

Any MCP-compatible client — including Claude, ChatGPT, Cursor, Zed, Windsurf, and automation tools like n8n and Make. You add the TeleBoost MCP URL as a custom connector and authorize it with OAuth. Tools that don't speak OAuth can use an API key instead.

Can the AI send messages on my behalf?

Only if you explicitly grant the messages.send scope. Even then, every message goes through the same proxy-enforced, quota-limited pipeline as the app — so your accounts stay protected. Without that scope, the AI can read and draft but never send.

Is my data safe?

Access is scoped and revocable, keys and tokens are hashed at rest, and OAuth uses PKCE so no secret is stored on the client. Session strings and proxy credentials are never exposed through the API or MCP — not even to admins. Every request is rate-limited and audit-logged.

Which plans include the API and MCP?

The API, MCP server and webhooks are available on the Pro and Business plans, with higher rate limits on Business. You can see and manage everything under Settings → Developers.

Do I need to run any infrastructure?

No. The MCP server is hosted by TeleBoost — you just add a URL to your AI tool and authorize it. For webhooks you provide an HTTPS endpoint; we handle signing, retries and delivery.

Share

Plug your AI and your stack into Telegram

Available on Pro and Business. Create a key in seconds, add the MCP URL to your AI tool, and start automating — with safety quotas always in force.

Related