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

MCP serverDatabases & data

Query a TikTok data warehouse (creators, videos, sounds, daily history) with read-only SQL.

Available today. Use it from your connected AI after setup.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use DataSocial MCP: query TikTok data from Claude, Cursor or any MCP client to list tables

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

The server’s own address, for the clients that take one directly. Or connect ahel onceand every client you use reads it from one address, with the account kept on ahel rather than in each client’s config.

  • Claude Code

    claude mcp add --transport http --scope user datasocial-mcp-query-tiktok-data 'https://api.datasocial.ai/mcp'

    Run it once in your project, then open /mcp to approve any sign-in the server asks for.

  • Claude Desktop

    https://api.datasocial.ai/mcp

    Add a custom connector in Settings, paste this address, and approve the sign-in.

  • Cursor

    cursor://anysphere.cursor-deeplink/mcp/install?name=datasocial-mcp-query-tiktok-data&config=eyJ1cmwiOiJodHRwczovL2FwaS5kYXRhc29jaWFsLmFpL21jcCJ9

    Open the link and Cursor adds the server at that address.

  • ChatGPT

    https://api.datasocial.ai/mcp

    In Settings, enable Developer mode, create an MCP app, and paste this address. Your plan and workspace must allow custom apps.

  • Codex

    codex mcp add datasocial-mcp-query-tiktok-data --url 'https://api.datasocial.ai/mcp'

    Run it once, then sign in with codex mcp login datasocial-mcp-query-tiktok-data if the server asks for an account.

From the project's README

As published by hashfunction-dev/datasocial-mcp in README.md.

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

ToolWhat it does
list_tablesThe tables, their row counts and what one row is
describe_tableOne table's columns, types and sort key
examplesWorked questions with SQL that runs, plus SQL tips
run_sqlRuns 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

This repo holds documentation only; the server is hosted.

Tools it offers (4)

What this server listed when ahel dialed its public endpoint in Sep 2026, with no key and no account of yours. The names are the server’s own.

  • list_tables
  • describe_table
  • examples
  • run_sql

Signals

Last commit
Sep 2026
Advanced
Delivery
datasocial-mcp MCP server → your ahel connector (mcp.ahel.ai) → your AI.
Item type
mcp-server
Key
io-github-hashfunction-dev-datasocial-mcp
Source
github.com/hashfunction-dev/datasocial-mcp
Hosted endpoint
https://api.datasocial.ai/mcp