- Home
- MCP server
Run TikTok DM outreach from your LLM
The Hooka MCP server connects Hooka to Claude, ChatGPT and Cursor, so you can run TikTok cold-DM outreach in plain language — connect accounts, launch campaigns, load leads and triage the inbox without leaving your assistant. It's a thin, open-source wrapper over Hooka's REST API. Add the hosted server (mcp.hooka.to) to Claude.ai or ChatGPT, or install locally with npx hooka-mcp for Cursor and Claude Desktop.
What is the Hooka MCP server?
The Hooka MCP server is a Model Context Protocol server that exposes Hooka's TikTok DM outreach API as tools your LLM can call. Point Claude, ChatGPT or Cursor at it and your assistant can connect TikTok accounts, create and start DM campaigns, add targets and read replies — all in natural language.
It's a thin wrapper: every tool call is translated into a request to Hooka's REST API v1 using your own API key. The server is stateless — it stores no credentials — and the same server-side safety limits (daily caps, spacing, sender rotation) apply no matter how the API is driven. It's open-source (MIT) and published on npm as hooka-mcp.
How do I connect Hooka to Claude, ChatGPT or Cursor?
Claude.ai (web), ChatGPT & other URL clients — hosted, OAuth
Add Hooka as a custom connector pointing at the hosted server. Nothing to install and no API key to paste — you sign in to Hooka and authorize:
https://mcp.hooka.to/mcp
In Claude.ai: Settings → Connectors → Add custom connector → paste the URL. In ChatGPT: add it as a connector the same way. You're redirected to Hooka to sign in and approve access (OAuth 2.1 + PKCE), then the tools appear.
Cursor & Claude Desktop — local, API key
Install with npx — no clone, no build. Add this to your client's MCP config and set your Hooka API key:
{
"mcpServers": {
"hooka": {
"command": "npx",
"args": ["-y", "hooka-mcp"],
"env": { "HOOKA_API_KEY": "hk_live_..." }
}
}
}
In Claude Desktop this goes in claude_desktop_config.json; in Cursor, under Settings → MCP. Restart and Hooka's tools appear. These clients can also use the hosted URL above with an Authorization: Bearer hk_live_… header. Get your API key self-serve from the Developers page of your dashboard. The package is on npm: npmjs.com/package/hooka-mcp.
What can it do?
23 tools mapped one-to-one to the Hooka API, covering the full outreach loop — plus guided prompts that chain them.
| Area | Tools |
|---|---|
| Senders (TikTok accounts) | list / get / create (returns a QR to scan) / refresh / delete |
| Campaigns | list / get (with live stats) / create / add targets / start / pause / resume |
| Inbox | list conversations / read messages / send reply |
| Suppression | list / add / remove from the Do-Not-Contact list |
| Events & webhooks | list events, list and create webhook endpoints |
| Prompts | launch_campaign, triage_inbox, connect_account |
Is it safe to let an AI send DMs?
The tools that take real-world action — start_campaign, resume_campaign and send_reply — are marked destructive, so MCP clients prompt you for confirmation before running them. Account connection is QR-based and password-free. And Hooka enforces its limits server-side — up to 100 DMs/day per account (spaced), rotation across senders, automatic pauses on rate-limit signals — regardless of how the API is called.
Honest note: TikTok DM automation operates outside TikTok's official API and carries real risk — no tool can promise zero bans. The MCP server doesn't change that; it just gives your LLM a clean, confirmed way to drive Hooka. Use dedicated outreach accounts and start with low volumes.
Frequently asked questions
What is the Hooka MCP server?
A Model Context Protocol server that exposes Hooka's TikTok DM outreach API as tools your LLM can call. Connected to Claude, ChatGPT or Cursor, it lets you connect accounts, launch campaigns, add targets and triage the inbox in natural language. It's a thin wrapper over Hooka's REST API v1 and stores no credentials.
How do I connect Hooka to Claude, ChatGPT or Cursor?
Two ways. For Claude.ai (web) and ChatGPT, add a custom connector pointing at the hosted server https://mcp.hooka.to/mcp and sign in to Hooka to authorize — no API key to paste (OAuth 2.1). For Cursor and Claude Desktop, install locally with npx (command "npx", args ["-y", "hooka-mcp"], env HOOKA_API_KEY), or use the hosted URL with a Bearer header. The package is on npm as hooka-mcp.
Do I need a Hooka API key?
Yes — create one from the Developers page in your dashboard (or POST /v1/api_keys). Keys start with hk_live_ or hk_test_. API access is included with a Hooka subscription, priced per connected TikTok account.
Is it safe to let an AI send TikTok DMs?
The tools that send real DMs (start_campaign, resume_campaign, send_reply) are marked destructive, so clients ask for confirmation first. Hooka enforces daily caps, spacing and rotation server-side. Connecting an account is QR-based and password-free. As with any TikTok automation, risk is never zero — review actions before confirming.
Keep reading
The REST API the MCP server wraps — senders, campaigns, targets, webhooks.
featuresEverything Hooka doesSender rotation, unified inbox, A/B testing — the engine behind every tool.
pricingHooka pricingPer connected TikTok account/month. API and MCP access included.
Let your LLM run the outreach
Cancel anytime. We never ask for your TikTok password. Secure payment with Stripe.