TikTok hashtag trends as an MCP tool. Plug into Claude, Cursor, or any MCP-compatible AI host. Weekly series, growth percentages, and live TikTok trending hashtags. Powered by trendsmcp.ai
Project description
tiktok-trends-mcp
TikTok trend data for AI assistants Spot TikTok trends before they go mainstream. Track hashtag volume growth, viral spikes, and platform-specific demand signals - all accessible from your AI in plain language.
Full docs and live demo: https://trendsmcp.ai/tiktok-trends
Part of Trends MCP - the MCP server for live trend data across 12+ sources. See the main repo: https://github.com/trendsmcp/trends-mcp
Get started in 2 steps
Step 1: Get your free API key at trendsmcp.ai 100 requests/day, no credit card required.
Step 2: Add to your AI client (replace YOUR_API_KEY):
Cursor / Windsurf / Cline (~/.cursor/mcp.json or equivalent)
{
"mcpServers": {
"trends-mcp": {
"url": "https://api.trendsmcp.ai/mcp",
"transport": "http",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}
VS Code / GitHub Copilot (.vscode/mcp.json)
{
"servers": {
"trends-mcp": {
"type": "http",
"url": "https://api.trendsmcp.ai/mcp",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}
Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"trends-mcp": {
"url": "https://api.trendsmcp.ai/mcp",
"transport": "http",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}
Claude.ai (browser) Settings -> Connectors -> Add custom connector:
https://api.trendsmcp.ai/mcp
Example query
After connecting, ask your AI:
get_trends(keyword='booktok', source='tiktok', data_mode='weekly')
Available tools
| Tool | What it does |
|---|---|
get_trends |
Time-series for a keyword on this source |
get_growth |
Growth % over 1W, 1M, 3M, 6M, 1Y periods |
get_top_trends |
What is trending right now on this source |
get_ranked_trends |
Top topics ranked by volume |
FAQ
What TikTok data does Trends MCP provide?
TikTok hashtag trend volume - normalized interest, growth rate, and historical time series. This reflects how frequently a hashtag appears and grows on the platform over time.
How early can I detect a TikTok trend?
Trends MCP returns weekly and daily data. Daily data (last 30 days) lets you spot early-stage growth spikes before a hashtag reaches mainstream saturation.
Can I compare TikTok trends against Google Search?
Yes. Query both sources in one call. TikTok often shows spikes 2-4 weeks before the same topic rises on Google Search, making cross-platform comparison a leading indicator strategy.
Does this work for brand monitoring on TikTok?
Yes. Track a brand name or product hashtag over time to measure TikTok presence growth relative to competitors.
Are TikTok hashtags case-sensitive?
No. The query is normalized before lookup. You can use 'booktok', 'BookTok', or '#booktok' - all return the same signal.
All data sources
Trends MCP covers 12+ sources in one connection: Google Search, YouTube, TikTok, Reddit, Amazon, Wikipedia, News Sentiment, Web Traffic, App Downloads, Steam, npm, and more.
Browse all: https://trendsmcp.ai/data-sources
Also works as a Python client
Same API key works directly in Python - no MCP host needed.
pip install tiktok-trends-mcp
import os
from tiktok_trends_mcp import TrendsMcpClient, SOURCE
client = TrendsMcpClient(api_key=os.environ["TRENDSMCP_API_KEY"])
series = client.get_trends(source=SOURCE, keyword="your keyword")
growth = client.get_growth(source=SOURCE, keyword="your keyword", percent_growth=["1M", "3M", "12M"])
top = client.get_top_trends(type="Tiktok", limit=10)
Full Python docs: trendsmcp.ai/docs
License
MIT © Trends MCP
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file tiktok_trends_mcp-1.0.0.tar.gz.
File metadata
- Download URL: tiktok_trends_mcp-1.0.0.tar.gz
- Upload date:
- Size: 4.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
49e2b9098842a12583c324b2c1bdf35fa5ca1fe49850ceb7916c6314c124b2c5
|
|
| MD5 |
23cd5e717c3f88431984355c144a46b0
|
|
| BLAKE2b-256 |
e028c7bed692ffd6f2a3190150cc394a5eaf4de9afb75e97ed2f4a4ce33a7db5
|
Provenance
The following attestation bundles were made for tiktok_trends_mcp-1.0.0.tar.gz:
Publisher:
publish.yml on trendsmcp/tiktok-trends-mcp
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
tiktok_trends_mcp-1.0.0.tar.gz -
Subject digest:
49e2b9098842a12583c324b2c1bdf35fa5ca1fe49850ceb7916c6314c124b2c5 - Sigstore transparency entry: 1203565777
- Sigstore integration time:
-
Permalink:
trendsmcp/tiktok-trends-mcp@2fe36b58c65b491760287e41cb2b0c63d1994693 -
Branch / Tag:
refs/tags/v1.0.0 - Owner: https://github.com/trendsmcp
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@2fe36b58c65b491760287e41cb2b0c63d1994693 -
Trigger Event:
release
-
Statement type:
File details
Details for the file tiktok_trends_mcp-1.0.0-py3-none-any.whl.
File metadata
- Download URL: tiktok_trends_mcp-1.0.0-py3-none-any.whl
- Upload date:
- Size: 4.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ac4921159ce199d1cd18aa030885a353ca722e6f99dfd19ac9abd46f93b46622
|
|
| MD5 |
c24fc4b6aa5e374e955b22903dd69a06
|
|
| BLAKE2b-256 |
41d0c59d7885b99fbc3ae5c566eb2cb51ac43e7ab64f82cd3fb90f12ebc47995
|
Provenance
The following attestation bundles were made for tiktok_trends_mcp-1.0.0-py3-none-any.whl:
Publisher:
publish.yml on trendsmcp/tiktok-trends-mcp
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
tiktok_trends_mcp-1.0.0-py3-none-any.whl -
Subject digest:
ac4921159ce199d1cd18aa030885a353ca722e6f99dfd19ac9abd46f93b46622 - Sigstore transparency entry: 1203565780
- Sigstore integration time:
-
Permalink:
trendsmcp/tiktok-trends-mcp@2fe36b58c65b491760287e41cb2b0c63d1994693 -
Branch / Tag:
refs/tags/v1.0.0 - Owner: https://github.com/trendsmcp
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@2fe36b58c65b491760287e41cb2b0c63d1994693 -
Trigger Event:
release
-
Statement type: