# HasData TikTok

Read-only MCP server providing TikTok profiles, video lists, comments, and creator search as JSON. Works without a TikTok developer account or OAuth.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 12
- Author: HasData
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/HasData/tiktok-mcp
- Updated: 2026-10-12
- HTML: https://affpapa.org/en/nevibecode/mcp/hasdata-tiktok

## What it does

The server gives MCP clients four read-only actions for TikTok. An agent can inspect creator profiles, browse video feeds, extract comments, or discover videos and accounts by keyword. All responses arrive as structured JSON. It only reads material that any signed-out guest can view in a web browser.

Setup avoids official TikTok developer verification entirely. You connect directly to the hosted endpoint at `https://mcp.hasdata.com/mcp?apis=tiktok` or use a local stdio wrapper via npm or PyPI. You will need a HasData API key. The free plan supplies 1,000 credits each month without asking for a credit card. Because each successful call uses 10 credits, that allowance covers 100 requests.

This tool cannot modify anything on TikTok. It does not support posting videos, leaving replies, or authenticating as an account holder.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.hasdata.com/mcp?apis=tiktok`
- Environment variables: `HASDATA_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI**
```bash
claude mcp add tiktok -e HASDATA_API_KEY=<HASDATA_API_KEY> -- npx -y @hasdata/tiktok-mcp
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http hasdata-tiktok 'https://mcp.hasdata.com/mcp?apis=tiktok'
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add hasdata-tiktok --url 'https://mcp.hasdata.com/mcp?apis=tiktok'
```

2. **Platform CLI**
```bash
codex mcp add hasdata-tiktok --env HASDATA_API_KEY=<HASDATA_API_KEY> -- npx -y @hasdata/tiktok-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "hasdata-tiktok": {
            "url": "https://mcp.hasdata.com/mcp?apis=tiktok"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "hasdata-tiktok": {
            "command": "npx",
            "args": [
                "-y",
                "@hasdata/tiktok-mcp"
            ],
            "env": {
                "HASDATA_API_KEY": "<HASDATA_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "hasdata-tiktok": {
            "type": "http",
            "url": "https://mcp.hasdata.com/mcp?apis=tiktok"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "hasdata-tiktok": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@hasdata/tiktok-mcp"
            ],
            "env": {
                "HASDATA_API_KEY": "<HASDATA_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http hasdata-tiktok 'https://mcp.hasdata.com/mcp?apis=tiktok'
```

2. **Platform CLI**
```bash
gemini mcp add -e HASDATA_API_KEY=<HASDATA_API_KEY> hasdata-tiktok npx -y @hasdata/tiktok-mcp
```
Replace <…> with your own values

## When to use it
- Pull creator profile details and follower counts without signing in
- Retrieve video engagement stats and play counts across an account feed
- Fetch top comments and nested discussion replies for a given video URL
- Search creators and clips by keyword to extract structured JSON data

## Example prompts
- Find TikTok accounts discussing specialty coffee and list the top five by subscriber count with their bios.
- Fetch profile data for @mrbeast, inspect the latest videos, and calculate their median view count.
- Extract the top comments from this TikTok link and highlight the three replies with the highest like count.

## Similar
- [analyzing-tiktok-hashtag-performance](https://affpapa.org/en/nevibecode/skills/analyzing-tiktok-hashtag-performance.md) — skill · 730 installs
- [HasData Instagram](https://affpapa.org/en/nevibecode/mcp/hasdata-instagram.md) — MCP server · ★ 15
- [scraping-tiktok-posts-by-music](https://affpapa.org/en/nevibecode/skills/scraping-tiktok-posts-by-music.md) — skill · 793 installs
- [tiktok-teneo](https://affpapa.org/en/nevibecode/skills/tiktok-teneo.md) — skill · 520 installs
- [tiktok-research](https://affpapa.org/en/nevibecode/skills/tiktok-research.md) — skill · 1200 installs
- [tiktok-api](https://affpapa.org/en/nevibecode/skills/tiktok-api.md) — skill · 6700 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md