DataSocial
Query a TikTok data warehouse (creators, videos, sounds, daily history) with read-only SQL.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http datasocial 'https://api.datasocial.ai/mcp' --header 'Authorization: <Bearer <your key>; free key at datasocial.ai/keys (sign in)>'
{
"mcpServers": {
"datasocial": {
"type": "http",
"url": "https://api.datasocial.ai/mcp",
"headers": {
"Authorization": "<Bearer <your key>; free key at datasocial.ai/keys (sign in)>"
}
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
DataSocial MCP: query TikTok data from Claude, Cursor or any MCP client
A hosted MCP server over a ClickHouse warehouse of TikTok data: 4.1B creators, 5.5B videos, 604M sounds and 113.7B follow edges (124.6B rows). Ask your AI assistant a question; it writes the SQL and runs it. Free.
- Endpoint:
https://api.datasocial.ai/mcp(Streamable HTTP, stateless) - Key: free. Sign in at datasocial.ai, open the MCP tab, and copy the command with your key already in it.
- Limits: 100 rows per query, 10 s per query, read-only.
Connect
Claude Code
claude mcp add --transport http datasocial https://api.datasocial.ai/mcp \
--header "Authorization: Bearer $DATASOCIAL_KEY"
Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"datasocial": {
"url": "https://api.datasocial.ai/mcp",
"headers": { "Authorization": "Bearer YOUR_KEY" }
}
}
}
Claude Desktop (claude_desktop_config.json, via mcp-remote)
{
"mcpServers": {
"datasocial": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.datasocial.ai/mcp", "--header", "Authorization:${AUTH}"],
"env": { "AUTH": "Bearer YOUR_KEY" }
}
}
}
Tools
| Tool | What it does |
|---|---|
list_tables | The tables, their row counts and what one row is |
describe_table | One table's columns, types and sort key |
examples | Worked questions with SQL that runs, plus SQL tips |
run_sql | Runs one read-only SELECT (up to 100 rows) |
Things to ask
- "Which US creators with over 1M followers grew fastest this week?"
- "Which sounds are being used in the most new videos today?"
- "Who does @<username> follow?"
- "What's the average view count of videos by creators in Brazil with 100K–500K followers?"
Daily creator and video history started on 2026-09-26; sound history has 106 days since January 2026.
Also
- Plain SQL or plain-English search in the browser, no account: datasocial.ai
- How the data is collected: Scraping TikTok's mobile API at billions of records a day
- The full database without the 100-row limit, or the scraper code: datasocial.ai/buy
This repo holds documentation only; the server is hosted.
Frequently asked questions
What is DataSocial?
Query a TikTok data warehouse (creators, videos, sounds, daily history) with read-only SQL.
How do I install DataSocial?
It runs as a remote server. In Claude Code: claude mcp add --transport http datasocial 'https://api.datasocial.ai/mcp' --header 'Authorization: <Bearer <your key>; free key at datasocial.ai/keys (sign in)>'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does DataSocial need an API key?
Yes. It expects Authorization, which you set in its configuration.
Is DataSocial open source?
Its code is public on GitHub, but the repository does not declare a standard license.
Who maintains DataSocial?
It is published by hashfunction-dev. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.