HasData/tiktok-mcp

A hosted Model Context Protocol (MCP) server that gives Claude, Cursor, Windsurf and any other MCP client four read-only TikTok tools. Look up a public profile, walk an account's videos, read the comments on a video, and search TikTok for videos or creators, all as structured JSON, with no TikTok developer account and no OAuth.
It reads public data that a signed-out visitor can see. It does not sign in, post, or act as an account.
**1,000 free credits every month, no card required**, which is 100 TikTok calls.
- Prompts and resources
Contents
- What you need
- Quick start
- Example prompts
- Tools
- Errors and failure paths
- Pricing, free tier and limits
- Tool selection
- How it compares
- FAQ
- HasData links
- Development
- Contributing
- License
What you need
An MCP client and a HasData API key from the dashboard, free to create. This is a remote server, so the simplest path is a URL and an x-api-key header, with no container to run and no TikTok developer account anywhere in the flow. A client that only speaks stdio reaches it through a thin launcher, published as @hasdata/tiktok-mcp on npm and hasdata-tiktok-mcp on PyPI, shown below.
Quick start
The server URL is the same for every client. We run it hands-on in Claude Code and Claude Desktop. The other blocks follow each client's own documented format for a remote server.
| Field | Value |
| :--- | :--- |
| URL | https://mcp.hasdata.com/mcp?apis=tiktok |
| Transport | HTTP, streamable |
| Auth header | x-api-key: HASDATA_API_KEY |
Clients with OAuth support can add the same URL as a connector and sign in without putting a key in a config file.
Claude Code
Claude Desktop
Settings, then Connectors, then Add custom connector, then paste https://mcp.hasdata.com/mcp?apis=tiktok and sign in.
For the config-file route, Claude Desktop loads only local (stdio) servers, so it reaches a remote server through a stdio launcher. The @hasdata/tiktok-mcp package is that launcher, and it reads the key from the environment. Add this to claude_desktop_config.json:
Python instead of Node? Swap the launcher for the PyPI package, which uvx runs without a manual install:
Cursor
~/.cursor/mcp.json for every project, or .cursor/mcp.json for one:
Windsurf
~/.codeium/windsurf/mcp_config.json. Windsurf calls the field serverUrl, not url:
Cline
VS Code
.vscode/mcp.json in the workspace:
Codex CLI
~/.codex/config.toml:
Gemini CLI
~/.gemini/settings.json:
Example prompts
Prompts, not code. Paste one in and the agent picks the tool itself. Each is annotated with the calls it takes, because in MCP the model decides how many calls to make and every successful call costs 10 credits.
> Take @mrbeast. Pull the profile, then walk the first two pages of videos and give me the median play count across them.
*Three calls, 30 credits. The profile is one call, and each page of videos is another.*
> Search TikTok for creators around "cold brew coffee" and rank the top ten by followers, each with their bio.
*One call, 10 credits. A user search already carries follower count and bio, so no per-profile follow-up is needed.*
> Here is a video URL. Read its top comments and tell me the overall sentiment and the three most-liked replies.
*One call, 10 credits. The numeric id in the URL is all the comments tool needs.*
> Take that same video, then expand the replies under its most-liked comment.
*Two calls, 20 credits. Top-level comments first, then a second call with that comment's id for its replies.*
> Search "asmr" videos, then pull the author profile of the three with the highest play counts.
*Four calls, 40 credits. One search, then one profile each. Every author in a search result carries a link straight to its profile endpoint, so the agent never has to guess a handle.*
Paging costs a call each time. A creator audit that reads a profile then walks five pages of videos is six calls and 60 credits. The free tier goes further on narrow questions than on open-ended crawls.
Tools
| Tool | What it returns |
| --- | --- |
| hasdata_tiktok_comments_getTikTokComments | Fetches the comments on a public TikTok video by its numeric video id, or the replies to a specific comment when commentId is given. 10 credits a call |
| hasdata_tiktok_posts_getTikTokPosts | A page of ~35 videos plus a nextPageToken; pass that token back to walk the account history one page at a time. 10 credits a call |