DataSocial MCP server

Q: How do I add DataSocial MCP to Claude Code?

Run `claude mcp add --transport http datasocial-mcp https://api.datasocial.ai/mcp` in your terminal. Add `--scope user` to make it available in every project.

Q: How do I add DataSocial MCP to Cursor?

Open `~/.cursor/mcp.json` and add the server under `mcpServers`, using the Cursor config shown in the install section above.

Commit Oct 23, 2026

hashfunction-dev/datasocial-mcp

Query a massive TikTok data warehouse containing billions of creators, videos, and sounds using read-only SQL through an AI assistant.

Also known as hashfunction-dev/datasocial-mcp, datasocial-mcp

remote 4 tools Databases

Install GitHub ↗

Stars: 0
Tools: 4
Downloads, 30 days: —
Latest version: 1.0.0
Last commit: Oct 23, 2026
License: —

What is DataSocial MCP?

DataSocial queries a massive TikTok data warehouse containing billions of creators, videos, and sounds using read-only SQL through an AI assistant. It exposes 4 tools, such as list_tables, describe_table, examples.

Summary generated from the project's README

About DataSocial MCP server

DataSocial provides access to a massive ClickHouse warehouse containing TikTok data, including 4.1 billion creators, 5.5 billion videos, and 604 million sounds. Developers can connect this hosted MCP server to clients like Claude Code, Cursor, or Claude Desktop using a streamable HTTP endpoint. Once configured with an authorization key from the DataSocial website, an AI assistant can translate natural language questions into read-only SQL queries to explore the dataset.

The server includes specific tools such as list_tables to view row counts, describe_table to inspect column types, and examples to see worked SQL questions. Users can execute queries through the run_sql tool, which is subject to a 100-row limit and a 10-second execution timeout per query. This setup allows for rapid analysis of creator growth, sound trends, and follower relationships without requiring manual SQL writing.

What you can do with it

1Analyze creator growth trendsAsk the assistant to identify US-based creators with over one million followers who experienced the fastest growth this week.
2Track trending audio usageDetermine which specific sounds are appearing in the highest number of new videos today.
3Calculate engagement metrics by regionFind the average view counts for videos produced by creators in Brazil within a specific follower range.

Written from the project's README. Every use case is checked against a quote from it.

How to install DataSocial MCP

Formats verified 10 Nov 2026Add to Cursor Add to Goose

Claude CodeCursorVS CodeVS Code CLICodexCodex config.tomlGemini CLIGemini settings.json

$ claude mcp add --transport http datasocial-mcp https://api.datasocial.ai/mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "datasocial-mcp": {
      "url": "https://api.datasocial.ai/mcp"
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "datasocial-mcp": {
      "type": "http",
      "url": "https://api.datasocial.ai/mcp"
    }
  }
}

$ code --add-mcp '{"name":"datasocial-mcp","type":"http","url":"https://api.datasocial.ai/mcp"}'

$ codex mcp add datasocial-mcp --url https://api.datasocial.ai/mcp

~/.codex/config.toml

[mcp_servers.datasocial-mcp]
url = "https://api.datasocial.ai/mcp"

$ gemini mcp add -s user --transport http datasocial-mcp https://api.datasocial.ai/mcp

~/.gemini/settings.json

{
  "mcpServers": {
    "datasocial-mcp": {
      "url": "https://api.datasocial.ai/mcp",
      "type": "http"
    }
  }
}

No environment variables or API keys required.Setup guides:Claude Code Cursor VS Code Claude Desktop

DataSocial MCP tools 4

Detected from the README

list_tables
describe_table
examples
run_sql

list_tables	—
describe_table	—
examples	—
run_sql	—

Automated checks

Ran Nov 14, 2026Full report →

67/100

Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points

Show this score in your README

Source repository linked and reachablehashfunction-dev/datasocial-mcp is public and reachablegithub.com/hashfunction-dev/datasocial-mcp ↗Pass
Package names this repository as its sourceNot checked
Build provenance (Sigstore attestation)Not checked
Open source license (OSI)No licenseFinding
Commit or release in the last yearLast commit or release 2026-10-23github.com/hashfunction-dev/datasocial-mcp ↗Pass
OpenSSF ScorecardNot checked
Package name not close to a popular packageNot checked
No critical advisory in the package or its dependenciesNot checked
No hidden instructions to the model4 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
Destructive tools are labelledNo tool named like delete, drop or execPass
Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 244 msPass

README

View on GitHub

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.

Read full README

DataSocial MCP questions

How do I add DataSocial MCP to Claude Code?

Run claude mcp add --transport http datasocial-mcp https://api.datasocial.ai/mcp in your terminal. Add --scope user to make it available in every project.

How do I add DataSocial MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

What tools does DataSocial MCP provide?

It exposes 4 tools, including list_tables, describe_table, examples, run_sql.

What are the query limits for DataSocial?

Queries are limited to 100 rows and a maximum execution time of 10 seconds.

What kind of data is available in the warehouse?

The warehouse contains data on 4.1B creators, 5.5B videos, 604M sounds, and 113.7B follow edges.

Facts

Nov 14, 2026

Stars: 0
Downloads, 30 days: —
Latest version: 1.0.0
Last commit: Oct 23, 2026
License: —
Transport: remote
Package: —

hashfunction-dev ↗

Community publisher

Published by an independent maintainer.

Alternatives

Works with

Claude Code Cursor VS Code Claude Desktop Codex Gemini CLI Windsurf Devin

Badge for your README

Show your HostedMCP checks score. The badge links readers to install instructions for every client.

[![HostedMCP checks](https://api.hostedmcp.org/v1/badge/server/hashfunction-dev/datasocial-mcp.svg)](https://hostedmcp.org/servers/hashfunction-dev/datasocial-mcp/checks)

Maintainer?

Claim this listing to edit it and add the HostedMCP badge to your README.

Claim listing

Before you install

Servers run with the permissions you give them. Use the narrowest token or database role that does the job.

About DataSocial MCP server

What you can do with it

1Analyze creator growth trendsAsk the assistant to identify US-based creators with over one million followers who experienced the fastest growth this week.
2Track trending audio usageDetermine which specific sounds are appearing in the highest number of new videos today.
3Calculate engagement metrics by regionFind the average view counts for videos produced by creators in Brazil within a specific follower range.

Written from the project's README. Every use case is checked against a quote from it.

{ "mcpServers": { "datasocial": { "command": "npx", "args": ["-y", "mcp-remote", "https://api.datasocial.ai/mcp", "--header", "Authorization:${AUTH}"], "env": { "AUTH": "Bearer YOUR_KEY" } } } }

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)

DataSocial MCP questions

How do I add DataSocial MCP to Claude Code?

Run claude mcp add --transport http datasocial-mcp https://api.datasocial.ai/mcp in your terminal. Add --scope user to make it available in every project.

How do I add DataSocial MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

What tools does DataSocial MCP provide?

It exposes 4 tools, including list_tables, describe_table, examples, run_sql.

What are the query limits for DataSocial?

Queries are limited to 100 rows and a maximum execution time of 10 seconds.

What kind of data is available in the warehouse?

The warehouse contains data on 4.1B creators, 5.5B videos, 604M sounds, and 113.7B follow edges.

DataSocial MCP server

What is DataSocial MCP?

About DataSocial MCP server

What you can do with it

How to install DataSocial MCP

Install DataSocial MCP in Claude Code

Install DataSocial MCP in Cursor

Install DataSocial MCP in VS Code

Install DataSocial MCP in VS Code CLI

Install DataSocial MCP in Codex

Install DataSocial MCP in Codex config.toml

Install DataSocial MCP in Gemini CLI

Install DataSocial MCP in Gemini settings.json

DataSocial MCP tools 4

Automated checks

README

DataSocial MCP: query TikTok data from Claude, Cursor or any MCP client

Connect

Tools

Things to ask

Also

DataSocial MCP questions

DataSocial MCP server

What is DataSocial MCP?

About DataSocial MCP server

What you can do with it

How to install DataSocial MCP

Install DataSocial MCP in Claude Code

Install DataSocial MCP in Cursor

Install DataSocial MCP in VS Code

Install DataSocial MCP in VS Code CLI

Install DataSocial MCP in Codex

Install DataSocial MCP in Codex config.toml

Install DataSocial MCP in Gemini CLI

Install DataSocial MCP in Gemini settings.json

DataSocial MCP tools 4

Automated checks

README

DataSocial MCP: query TikTok data from Claude, Cursor or any MCP client

Connect

Tools

Things to ask

Also

DataSocial MCP questions