TikTok MCP server
Connect StoriesFly to ChatGPT, Claude or Cursor and the assistant can read live public TikTok data when you ask: profiles, videos, stories, followers, following and reposts, and any video without the watermark. You paste one address and sign in with Telegram. No code, no TikTok developer app, and you never log in to TikTok.
What it looks like in the chat
You ask in plain words. The assistant picks the tools, fetches the numbers and answers in the chat. Below is a sample conversation with sample numbers: a check of a creator in your niche.
@zest.kitchen is a creator in our niche. How often does she post, which videos work best and what does she repost?
tiktok_user_profile@zest.kitchentiktok_user_videoslast 30 videostiktok_user_repostslatest reposts
Here is what her public account shows right now:
Pattern: short videos with the dish in the first second get about three times the views of her longer ones. She reposts mostly other food creators, which is a list of accounts to look at next.
Takeaway:Her best format is a quick finished-dish opening. Copy the structure, not the recipes, and test it on three videos.
Example chat · sample numbers
What the assistant can pull from TikTok
The server gives the assistant 7 TikTok tools and one download tool that covers both networks. Each call uses requests from your allowance; the last column shows how many. The tool account_status shows what is left and costs nothing.
Lists such as videos, followers, following and reposts come a page at a time, and the assistant asks for the next page only when the question needs it.
| Tool | What it returns | Try asking | Cost |
|---|---|---|---|
tiktok_video | One TikTok video or photo post by its link (short vm.tiktok.com links too). | “Pull this TikTok video: views, likes, comments, shares and the file without the watermark.” | 1 request |
tiktok_user_profile | A TikTok account's profile by username. | “How many followers and videos does @creator have on TikTok?” | 1 request |
tiktok_user_videos | A TikTok account's videos, newest first, a page at a time. | “List @creator's last 30 TikTok videos and rank them by views.” | 1 request per page |
tiktok_user_stories | The stories a TikTok account has up now, by username. | “Does @creator have a TikTok story up now?” | 1 request |
tiktok_user_followers | The accounts that follow a TikTok account, a page at a time. | “Show the first page of @creator's TikTok followers.” | 1 request per page |
tiktok_user_following | The accounts a TikTok account follows, a page at a time, with the same fields as its followers. | “Which accounts does @creator follow on TikTok?” | 1 request per page |
tiktok_user_reposts | The videos a TikTok account has reposted, newest repost first, a page at a time. | “What has @creator reposted lately?” | 1 request per page |
download_media | The files of one post by its link. | “Give me the download links for this post or video.” | 1 request |
Connect it in a minute
The server's address is https://storiesfly.com/mcp. In ChatGPT or Claude, add it as a connector (a custom MCP server) and sign in with Telegram when you are asked. Cursor takes the same address in its MCP settings.
In Claude Code, one command does it: claude mcp add --transport http storiesfly https://storiesfly.com/mcp.
The tabs below show the steps for each app.
https://storiesfly.com/mcpWorks on the Free plan too
- In ChatGPT, open Plugins, then Add, then Add custom MCP server.
- Paste the address below and pick OAuth for sign-in.
- Press Connect and sign in with Telegram on the StoriesFly page.
- Ask about any public account: “Check @creator before an ad deal”.
https://storiesfly.com/mcpclaude.ai and the Claude apps
- In Claude, open Customize, then Connectors, then Add custom connector.
- Name it StoriesFly and paste the address below.
- Press Connect and sign in with Telegram on the StoriesFly page.
- Ask about any public account in a new chat.
The Free plan of Claude allows one custom connector.
https://storiesfly.com/mcpIn your terminal
- Run the command below.
- In Claude Code, type
/mcp, pick storiesfly and sign in with Telegram.
claude mcp add --transport http storiesfly https://storiesfly.com/mcpmcp.json
- Add StoriesFly to
mcp.json(in Cursor's MCP settings, or~/.cursor/mcp.json). - Cursor shows StoriesFly under MCP: press Connect and sign in with Telegram.
{
"mcpServers": {
"storiesfly": {
"url": "https://storiesfly.com/mcp"
}
}
}Any client with HTTP MCP
- Create an API key in the API dashboard (sign in with Telegram).
- Add the server address and send the key as a Bearer token.
https://storiesfly.com/mcp
Authorization: Bearer <API key>What it costs
- Free: 100 requests, once per Telegram account. The same free requests as the API, no card.
- Basic, $4.99 a month: 100 requests a month. The StoriesFly Basic subscription.
- Pro, $19.99 a month: 500 requests a month. The StoriesFly Pro subscription.
- Prepaid balance: from $10, $1.50 per 1,000 requests, with no monthly cap. The balance never expires. See all the plans.
- A creator check takes about 4 requests.
What it cannot do
- It reads public TikTok accounts only. For a private account the assistant tells you so, and that look-up counts as one request.
- It reads the accounts and videos you name. It does not list trending sounds or hashtags.
- An account that hides its followers or following list answers an empty page, and the assistant says the list is hidden.
- It cannot post, like, follow or send messages.
- You never log in to TikTok with your own account, and your own account never appears among the story's viewers.
Docs and next steps
Every tool is one endpoint of the StoriesFly API, so the same data is available from code: tiktok/user/profile, tiktok/user/videos, tiktok/user/followers and tiktok/video. The AI assistants page has the plans side by side and the questions people ask about MCP.
To read Instagram from the same chat, see the Instagram MCP server. To call the TikTok endpoints from your own code, read the TikTok API.
Questions developers ask
What is a TikTok MCP server?
MCP (Model Context Protocol) is the standard way to plug a tool into an AI assistant. A TikTok MCP server lets ChatGPT, Claude or Cursor ask for live public TikTok data in the middle of a chat and work with it. StoriesFly's server is at https://storiesfly.com/mcp.
Does it work with ChatGPT and Claude?
Yes. Add the address as a connector in ChatGPT or Claude, or to Cursor or Claude Code, and sign in with Telegram. The steps for each app are on this page and on the AI assistants page.
Can the assistant read private TikTok accounts?
No. Only public accounts. When an account is private, the assistant tells you so, and that look-up counts as one request.
Will my own TikTok account show up among the viewers of a story?
You never log in to TikTok with your own account, and your own account never appears among the story's viewers.
How many requests does a creator check take?
About 4: the profile, two pages of videos and a page of reposts. The 100 requests free requests cover about 25 of them.
What does it cost?
100 requests are free, once per Telegram account. After that, Basic is $4.99 a month for 100 requests a month, Pro is $19.99 a month for 500, and a prepaid balance from $10 costs $1.50 per 1,000 requests with no monthly cap. A call that was not made is not charged.
Do I need a TikTok account, a developer app or an approval?
No. You need a Telegram account to sign in. For code instead of a chat, see the TikTok API. The data is the public TikTok data of the accounts you name.
Your first 100 requests are on us
Sign in with Telegram, create a key, call any endpoint. Top up only when you need more.