agent-native · uncontested

TikTok intelligence, callable by agents.

No TikTok analytics tool and no scraper API ships an MCP server. PopTrend does — the same data behind the dashboard is a first-class endpoint for Claude, agents, and automations.

add the stdio MCP server (dev server must be running)

claude mcp add poptrend -- node ./mcp-server.mjs

# or point at a deployment:
POPTREND_URL=https://popstats.xyz node ./mcp-server.mjs

try it — live against the mock adapter

POST /api/mcp · tools/calllive

toolarguments (json)

response

// select a tool and run it against the live mock adapter

tool catalog

decode_tiktok_timestamp

Decode the exact post time from a TikTok URL or video id (no scrape needed — reads the id bits). Free.

get_tiktok_post

Full metadata for a TikTok post: author, caption, hashtags, sound, stats, reposts.

get_tiktok_profile

Profile intelligence: followers, account-creation date, engagement rate, best hour.

verify_post

Evidence bundle for a post: decoded timestamp, account age, repost history, capture record. (Audience A)

search_posts

Semantic search across tracked/derived post text (mock embeddings in prototype).

list_monitors

List active monitors (accounts, hashtags, sounds) and their current metrics.

create_monitor

Start tracking an account, hashtag, or sound over time.

get_alerts

Recent alerts from monitors (new posts, spikes, thresholds).

get_profile_history

Full posting history for a showcase TikTok account: post count, followers, the dashboard's insight sentences, and the 20 most recent posts with views/likes/comments.

also available as plain REST

GET  /api/tiktok/post?url=<url|id>       → full post metadata
GET  /api/tiktok/profile?handle=<@h>     → profile intelligence
GET  /api/verify?url=<url|id>            → evidence bundle (json)
GET  /api/verify?url=<url|id>&format=csv → evidence export (csv)
GET  /api/monitors                       → list monitors
POST /api/monitors { kind, target }      → start a monitor
POST /api/mcp  (jsonrpc 2.0)             → initialize | tools/list | tools/call