Claude Code

\n\n```bash\nclaude mcp add --transport http tiktok \"https://mcp.hasdata.com/api/mcp?apis=tiktok\" \\\n --header \"x-api-key: HASDATA_API_KEY\"\n```\n\n

\n\n

Claude Desktop

\n\nSettings, then Connectors, then Add custom connector, then paste `https://mcp.hasdata.com/api/mcp?apis=tiktok` and sign in.\n\nFor 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`:\n\n```json\n{\n \"mcpServers\": {\n \"tiktok\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@hasdata/tiktok-mcp\"],\n \"env\": { \"HASDATA_API_KEY\": \"YOUR_KEY\" }\n }\n }\n}\n```\n\nPython instead of Node? Swap the launcher for the PyPI package, which `uvx` runs without a manual install:\n\n```json\n{\n \"mcpServers\": {\n \"tiktok\": {\n \"command\": \"uvx\",\n \"args\": [\"hasdata-tiktok-mcp\"],\n \"env\": { \"HASDATA_API_KEY\": \"YOUR_KEY\" }\n }\n }\n}\n```\n\n

\n\n

Cursor

\n\n`~/.cursor/mcp.json` for every project, or `.cursor/mcp.json` for one:\n\n```json\n{\n \"mcpServers\": {\n \"tiktok\": {\n \"url\": \"https://mcp.hasdata.com/api/mcp?apis=tiktok\",\n \"headers\": { \"x-api-key\": \"HASDATA_API_KEY\" }\n }\n }\n}\n```\n\n

\n\n

Windsurf

\n\n`~/.codeium/windsurf/mcp_config.json`. Windsurf calls the field `serverUrl`, not `url`:\n\n```json\n{\n \"mcpServers\": {\n \"tiktok\": {\n \"serverUrl\": \"https://mcp.hasdata.com/api/mcp?apis=tiktok\",\n \"headers\": { \"x-api-key\": \"HASDATA_API_KEY\" }\n }\n }\n}\n```\n\n

\n\n

Cline

\n\n```json\n{\n \"mcpServers\": {\n \"tiktok\": {\n \"url\": \"https://mcp.hasdata.com/api/mcp?apis=tiktok\",\n \"type\": \"streamableHttp\",\n \"headers\": { \"x-api-key\": \"HASDATA_API_KEY\" },\n \"disabled\": false\n }\n }\n}\n```\n\n

\n\n

VS Code

\n\n`.vscode/mcp.json` in the workspace:\n\n```json\n{\n \"servers\": {\n \"tiktok\": {\n \"type\": \"http\",\n \"url\": \"https://mcp.hasdata.com/api/mcp?apis=tiktok\",\n \"headers\": { \"x-api-key\": \"HASDATA_API_KEY\" }\n }\n }\n}\n```\n\n

\n\n

Codex CLI

\n\n`~/.codex/config.toml`:\n\n```toml\n[mcp_servers.tiktok]\nurl = \"https://mcp.hasdata.com/api/mcp?apis=tiktok\"\n\n[mcp_servers.tiktok.headers]\n\"x-api-key\" = \"HASDATA_API_KEY\"\n```\n\n

\n\n

Gemini CLI

\n\n`~/.gemini/settings.json`:\n\n```json\n{\n \"mcpServers\": {\n \"tiktok\": {\n \"httpUrl\": \"https://mcp.hasdata.com/api/mcp?apis=tiktok\",\n \"headers\": { \"x-api-key\": \"HASDATA_API_KEY\" }\n }\n }\n}\n```\n\n

\n\n## Example prompts\n\nPrompts, 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.\n\n> Take @mrbeast. Pull the profile, then walk the first two pages of videos and give me the median play count across them.\n\n*Three calls, 30 credits. The profile is one call, and each page of videos is another.*\n\n> Search TikTok for creators around \"cold brew coffee\" and rank the top ten by followers, each with their bio.\n\n*One call, 10 credits. A user search already carries follower count and bio, so no per-profile follow-up is needed.*\n\n> Here is a video URL. Read its top comments and tell me the overall sentiment and the three most-liked replies.\n\n*One call, 10 credits. The numeric id in the URL is all the comments tool needs.*\n\n> Take that same video, then expand the replies under its most-liked comment.\n\n*Two calls, 20 credits. Top-level comments first, then a second call with that comment's id for its replies.*\n\n> Search \"asmr\" videos, then pull the author profile of the three with the highest play counts.\n\n*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.*\n\nPaging 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 trial goes further on narrow questions than on open-ended crawls.\n\n## Tools\n\nFour tools, all read-only. Samples below are trimmed from real calls, and the numbers in them move as TikTok updates. Read them as shapes. Each tool name links to its endpoint reference, which carries the full field list.\n\nThe samples are the payload, not the whole response. A `tools/call` result carries one text block, and that text is itself JSON holding `url`, `status`, `text` and `json`, with the scraped data under `json`. From a raw JSON-RPC response the path is `result.content[0].text`, parsed, then `.json`. A chat client unwraps that for you and code talking to the endpoint directly does not.\n\nHandles, video ids and comment ids chain together. A profile links to its posts, every post carries its own video id for the comments tool, and every author in comments and search results carries a `hasdataLink` to its profile and a `hasdataPostsLink` to its videos. An agent walks from a keyword to a creator to a video to its comments without ever constructing a URL.\n\n### Get TikTok profile\n\n[`hasdata_tiktok_profile_getTikTokProfile`](https://docs.hasdata.com/apis/tiktok/profile?utm_source=github&utm_medium=syndication&utm_campaign=tiktok-mcp)\n\nOne public account by handle.\n\n| Parameter | Type | Required | Notes |\n| :--- | :--- | :--- | :--- |\n| `handle` | string | yes | The username, with or without the leading `@` |\n\nReturns `username`, `nickname`, `biography`, `bioLink`, `verified`, `language`, `createTime`, the avatar URLs, and the `followers`, `follows`, `likes`, `videos` and `friends` counts as integers. The counts are already parsed, so `followers > 1000000` compares numbers, not display strings.\n\n> A handle that does not exist still comes back with `requestMetadata.status` set to `ok`, the `profile` object simply absent. Check that the object is there before reading `username` or any other field, or an agent doing `profile.username` throws on nothing.\n\n```json\n{\n \"username\": \"mrbeast\",\n \"nickname\": \"MrBeast\",\n \"verified\": true,\n \"biography\": \"Checkout My New Book!👇\",\n \"bioLink\": \"http://themostdangerousgames.com\",\n \"createTime\": \"2018-10-20T19:26:16.000Z\",\n \"followers\": 138387571,\n \"follows\": 354,\n \"likes\": 1427086888,\n \"videos\": 466,\n \"friends\": 285\n}\n```\n\n### Get TikTok posts\n\n[`hasdata_tiktok_posts_getTikTokPosts`](https://docs.hasdata.com/apis/tiktok/posts?utm_source=github&utm_medium=syndication&utm_campaign=tiktok-mcp)\n\nA page of an account's videos by handle, newest first.\n\n| Parameter | Type | Required | Notes |\n| :--- | :--- | :--- | :--- |\n| `handle` | string | yes | The username, with or without the leading `@` |\n| `nextPageToken` | string | | The `pagination.nextPageToken` from the previous response. Omit it for the first page |\n\nOne call returns about thirty videos plus `pagination`, which carries `hasMore` and the `nextPageToken` you feed back to walk the account history one page at a time. Each video carries `id`, `description`, `url`, `duration`, the cover and playable video URLs, `music`, and the `likes`, `comments`, `shares`, `plays`, `collects` and `reposts` counts as integers.\n\n> `hashtags` and `mentions` are present only on videos that use them. In one real page of 27 videos, 4 carried a `hashtags` array and 10 carried `mentions`. Test for the key before you read it, rather than assuming every video has both.\n\n```json\n{\n \"id\": \"7677375185028271391\",\n \"description\": \"would you take the car or nah?\",\n \"url\": \"https://www.tiktok.com/@mrbeast/video/7677375185028271391\",\n \"createTime\": \"2026-08-23T23:36:59.000Z\",\n \"duration\": 41,\n \"likes\": 129500,\n \"comments\": 6670,\n \"shares\": 2033,\n \"plays\": 1100000,\n \"collects\": 4986,\n \"music\": { \"title\": \"original sound\", \"authorName\": \"MrBeast\", \"original\": true }\n}\n```\n\n### Get TikTok comments\n\n[`hasdata_tiktok_comments_getTikTokComments`](https://docs.hasdata.com/apis/tiktok/comments?utm_source=github&utm_medium=syndication&utm_campaign=tiktok-mcp)\n\nThe comments on a public video, or the replies under one comment.\n\n| Parameter | Type | Required | Notes |\n| :--- | :--- | :--- | :--- |\n| `videoId` | string | yes | The numeric id, the part after `/video/` in a TikTok URL. Keep it a string. The id is a 64-bit number that loses its last digits if it ever passes through a JavaScript `Number` |\n| `commentId` | string | | Pass it to get the replies to that comment instead of the video's top-level comments. A string, for the same 64-bit reason as `videoId` |\n| `nextPageToken` | string | | Token from the previous response. Omit it for the first page |\n\nEach comment carries `text`, `likes`, `createTime`, `replyCount` and an `author`, and every author carries a `hasdataLink` to its profile and a `hasdataPostsLink` to its videos. `pagination.total` reports the video's whole comment count, so you know the depth before you page. A comment with a non-zero `replyCount` has replies you reach by calling again with its `id` as `commentId`.\n\n```json\n{\n \"id\": \"7677377150003053325\",\n \"text\": \"How could someone turn down a car\",\n \"createTime\": \"2026-08-23T23:45:06.000Z\",\n \"likes\": 3802,\n \"replyCount\": 22,\n \"author\": {\n \"username\": \"hohce.verggr\",\n \"nickname\": \"Sasori\",\n \"hasdataLink\": \"https://api.hasdata.com/scrape/tiktok/profile?handle=hohce.verggr\",\n \"hasdataPostsLink\": \"https://api.hasdata.com/scrape/tiktok/posts?handle=hohce.verggr\"\n }\n}\n```\n\n### Search TikTok\n\n[`hasdata_tiktok_search_getTikTokSearch`](https://docs.hasdata.com/apis/tiktok/search?utm_source=github&utm_medium=syndication&utm_campaign=tiktok-mcp)\n\nA keyword search over videos or creators.\n\n| Parameter | Type | Required | Notes |\n| :--- | :--- | :--- | :--- |\n| `keyword` | string | yes | The phrase to search for |\n| `type` | string | | `video` by default, or `user` to search creators |\n| `nextPageToken` | string | | Token from the previous response. Omit it for the first page |\n\nWith `type: video` the response holds videos in the same shape the posts tool returns, each with its author. With `type: user` it holds creators, each with `username`, `nickname`, `signature` (the bio), `avatarUrl`, `followers`, and the same `hasdataLink` and `hasdataPostsLink` to chain into a profile or its videos. A `verified` flag is present on accounts that carry one.\n\n```json\n{\n \"username\": \"la.mooncoldbrew\",\n \"nickname\": \"lamoon cold brew coffee\",\n \"signature\": \"อยากได้สูตรชงเมนูไหน Comment ไว้เลยน้า\",\n \"followers\": 48000,\n \"hasdataLink\": \"https://api.hasdata.com/scrape/tiktok/profile?handle=la.mooncoldbrew\",\n \"hasdataPostsLink\": \"https://api.hasdata.com/scrape/tiktok/posts?handle=la.mooncoldbrew\"\n}\n```\n\n## Errors and failure paths\n\nYour client almost never sees an HTTP error code from a tool call. The MCP layer answers 200 and puts the failure inside the result, with `isError` set to `true` and the reason as text. The agent reads a message where you might expect a status line.\n\n**A wrong key surfaces as tool output, not as a failed connection.** `tools/list` accepts any non-empty key and returns all four tools, so the client completes its handshake and shows green. The first tool call then comes back with `isError: true` and the text `HasData API error: 401 Unauthorized`. Watch for that string, because nothing earlier in the flow reports the problem.\n\n**A missing key is the one real HTTP error.** Authorization runs before any tool, and the connection itself fails with 401. CORS headers are present, and a browser client reads the status and not an opaque network failure.\n\n**An argument that breaks a tool's schema is rejected before it becomes a scrape.** The server answers with `isError: true` and the text `MCP error -32602: Input validation error`, naming the offending field. Nothing is fetched and nothing is charged.\n\n**A call that succeeds and finds nothing is the case that trips people up.** A handle that does not exist comes back as an ordinary result with `requestMetadata.status` set to `ok` and the data key simply missing. Nothing in the body says the result was empty. Test for the field you need, not for an error.\n\n**An identifier the platform rejects returns 400** with `requestMetadata.status` set to `error`.\n\nResults that carry data also carry a `requestMetadata.id` worth quoting in support.\n\n## Pricing, free tier and limits\n\nEvery TikTok tool costs **10 credits per successful call**. Response size does not change the price. A full page of videos costs the same as a profile with one field.\n\nThe free trial is **1,000 credits over 30 days with no card**, which is 100 TikTok calls. After that an active account keeps getting 100 credits topped up each day whenever its balance drops below 100, so a low-volume agent runs on the free tier indefinitely.\n\nPaid plans start at **$49 a month** for 200,000 credits, which is 20,000 calls. The unit price falls with volume, from **$2.45 per 1,000 calls** on the entry plan to **$0.99** on Business, **$0.83** on Growth and **$0.75** on the largest [high-volume plans](https://hasdata.com/prices?utm_source=github&utm_medium=syndication&utm_campaign=tiktok-mcp).\n\nYour plan also sets concurrency. The free trial allows 1 request at a time, Startup 15, Business 30, Growth 50, and the high-volume plans run from 200 to 1,500. Handle the overflow case defensively in anything unattended, because an agent that fans out will reach the ceiling before you do.\n\nA request that comes back non-200 is not billed. A successful call that finds nothing is still a call.\n\n## Tool selection\n\nThe `apis` query parameter decides which tools your agent sees. Fewer tools means less context spent on tool definitions, and fewer chances for the model to reach for the wrong one.\n\n```\n?apis=tiktok the four tools in this repo\n?apis=tiktok,instagram a social bundle\n?apis=tiktok,google_serp add Google search\n```\n\nThe parameter takes provider names like `tiktok` and individual API names like `tiktok_search`. Misspelled names are ignored. If every name is wrong the request fails with 400, and the body lists both what it did not recognise and every valid value. Drop the parameter and the same endpoint exposes all 57 HasData tools.\n\n## How it compares\n\nTikTok's own developer program does not cover general reading of public content. The [Research API](https://developers.tiktok.com/products/research-api/) is gated behind an application and open to approved academic and nonprofit researchers in a limited set of regions. The Display API returns only the content of the account that signs in over OAuth. Neither fits an agent that needs to read an arbitrary public profile, its videos, or a video's comments.\n\n| | Official TikTok APIs | This server |\n| :--- | :--- | :--- |\n| Access | Research API by application, or Display API for your own account | One key and one URL |\n| Scope | Approved researchers, or your own authenticated account | Any public profile, video or search |\n| Auth | Application review or OAuth | An `x-api-key` header |\n| Comments of videos you do not own | Restricted | Yes, with reply threads |\n| Setup | Developer account and approval | None |\n| Writes and private data | Posting and your own account data over OAuth | Read-only, public data only |\n\nMost other TikTok MCP servers wrap a single unofficial endpoint. This one covers the four reads an agent actually chains, profile to posts to comments, plus search, so a whole research pass runs against one server.\n\n**What this server does not do.** No posting, no direct messages, no follower-only or private content, no analytics for accounts you do not own. It reads what a signed-out visitor can see.\n\n## FAQ\n\n### Is there an official TikTok MCP server?\n\nTikTok does not publish one. Every option is built by somebody else. This one is maintained by HasData and reads public pages, which is why it needs no TikTok developer account.\n\n### What is a TikTok MCP server?\n\nA server that exposes TikTok data as tools an AI client can call. The client sends a tool call over the Model Context Protocol, the server fetches the data and returns structured JSON, and the model works with the result and never sees a page of HTML. This one exposes four tools and runs remotely. The client connects to a URL and starts no local process.\n\n### Do I need a TikTok API key or a developer account?\n\nNo. The only credential is your HasData key. There is no developer application to file and no OAuth consent screen, because the tools read public TikTok pages and not the TikTok developer APIs.\n\n### Do I need to host or run anything?\n\nNo. This is a remote MCP server on streamable HTTP. Nothing to install, no container to keep warm, no process to restart.\n\n### Is the data live or cached?\n\nLive. Each call fetches at request time and carries its own `requestMetadata.id`. Counters like plays and likes track the page, so they move as the page moves.\n\n### Can I read a private account?\n\nNo. The tools return what a signed-out visitor sees. A private account's videos are not public, so they are not in any response.\n\n### Can I read comment replies, not just top-level comments?\n\nYes. Call the comments tool with a comment's `id` as `commentId` and it returns that comment's replies. A comment's `replyCount` tells you whether there are any.\n\n### Can I use this together with other HasData APIs?\n\nYes. The `apis` parameter takes a list, and `?apis=tiktok,instagram` gives your agent the four TikTok tools plus Instagram. [Drop the parameter](#tool-selection) and you get everything.\n\n### Compliance and personal data\n\nHasData accesses publicly available data only. A platform's terms may restrict automated access, and you are responsible for your own compliance. Where the data you collect includes personal information, make sure you have a lawful basis for it under GDPR, CCPA or the equivalent rules in your jurisdiction.\n\n## HasData links\n\n| | |\n| :--- | :--- |\n| Product page and request builder | [TikTok Scraper API](https://hasdata.com/apis/tiktok-scraper-api?utm_source=github&utm_medium=syndication&utm_campaign=tiktok-mcp) |\n| Server documentation | [MCP server docs](https://docs.hasdata.com/mcp-server?utm_source=github&utm_medium=syndication&utm_campaign=tiktok-mcp) |\n| All 57 tools in one server | [HasData/hasdata-mcp](https://github.com/HasData/hasdata-mcp) |\n| Client walkthroughs | [MCP clients and integrations](https://hasdata.com/integrations/mcp?utm_source=github&utm_medium=syndication&utm_campaign=tiktok-mcp) |\n| Everything else we scrape | [TikTok Scraper API and 54 more](https://hasdata.com/apis/?utm_source=github&utm_medium=syndication&utm_campaign=tiktok-mcp) |\n| Plans and credit costs | [Plans and credit costs](https://hasdata.com/prices?utm_source=github&utm_medium=syndication&utm_campaign=tiktok-mcp) |\n| Keys and usage | [HasData dashboard](https://app.hasdata.com?utm_source=github&utm_medium=syndication&utm_campaign=tiktok-mcp) |\n| Node launcher on npm | [@hasdata/tiktok-mcp](https://www.npmjs.com/package/@hasdata/tiktok-mcp) |\n| Python launcher on PyPI | [hasdata-tiktok-mcp](https://pypi.org/project/hasdata-tiktok-mcp/) |\n\n## Development\n\nThis repository is configuration and documentation for a remote server. There is no build step and nothing to containerize.\n\nThe tests in `test/` assert the tool contract, the part that can break without a commit here. They check that `?apis=tiktok` returns exactly four tools, that every tool still declares its required parameter, that no name changed, and that the key in use is actually accepted. That last check calls a tool for real and costs 10 credits, which is the price of a canary that can fail for the right reason.\n\n```bash\n# macOS and Linux\nHASDATA_API_KEY=your_key_here npm test\n\n# Windows PowerShell\n$env:HASDATA_API_KEY=\"your_key_here\"; npm test\n```\n\nThe same suite runs in CI on every push and once a week on a schedule, because the upstream tool list can change without anyone touching this repository. A failure means the tool list moved, the key stopped working, or the endpoint was unreachable, and the assertion message says which.\n\n## Contributing\n\nCorrections to the tool tables and the response samples are the most useful contribution, because those are the parts that drift. Include the call you made and the response you got. Pull requests from forks run the suite without a key, and the live checks skip instead of going red.\n\n## License\n\nMIT. See [LICENSE](https://github.com/HasData/tiktok-mcp/blob/main/LICENSE).\n","changelogMarkdown","videoKey","requiredSecretsJson","[{\"name\":\"x-api-key\",\"scope\":\"per-user\",\"header\":\"x-api-key\"}]","publishedAt","priceCents","trialDays",0,"upstream",{"_115":116,"_117":118,"_119":120,"_121":122,"_123":124,"_125":126},"requiredSecrets",[109],"tags",[99,100,101,19,102,103,104,105,21,106,107,108],"assets",[],"stats",{"_97":86,"_98":86},"ratingAvg","reviewCount","ai-agents","claude","cursor","llm-tools","social-media","tiktok","tiktok-api","tiktok-scraper","web-scraping","windsurf",{"_110":111,"_112":113,"_114":111},"name","x-api-key","scope","per-user","header","topics",[99,100,101,19,102,135,136,137,103,104,105,21,106,107,108],"license","MIT","language","JavaScript","registryName","com.hasdata/tiktok","homepage","https://hasdata.com/apis/tiktok-scraper-api","packages",[127,128],{"_129":134,"_131":22,"_75":133},{"_129":130,"_131":132,"_75":133},"registryType","pypi","identifier","hasdata-tiktok-mcp","1.0.2","npm","mcp","mcp-server","model-context-protocol","ENV",{"_140":141,"_142":143,"_144":145},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]

HasData TikTok