How to Connect TikTok Data to Cursor (MCP Setup, 2026)
Cursor's agent is good at turning research into files: scripts, shot lists, a content calendar in markdown. What it can't do on its own is see TikTok. Connect the FYPNow MCP server and the agent can pull this week's top videos in a niche, read their hooks, and write what it finds straight into your project. Setup takes about two minutes: one environment variable and a few lines of JSON.
What you need
- Cursor, installed.
- A FYPNow workspace on a paid plan. Creator and Starter include a 7-day free trial.
- An API key. Create one in FYPNow → Settings → API. It is shown once.
Step 1: Store the key in an environment variable
Do not paste the key into the file. Set it in your shell or system environment:
- Name:
FYPNOW_API_KEY - Value: the key from Settings → API
Restart Cursor after you set it.
Step 2: Add the server
Create .cursor/mcp.json in your project, or ~/.cursor/mcp.json for every project:
{
"mcpServers": {
"fypnow": {
"url": "https://api.fypnow.com/mcp",
"headers": {
"Authorization": "Bearer ${env:FYPNOW_API_KEY}"
}
}
}
}
Cursor expands ${env:FYPNOW_API_KEY} when it starts the server, so the key stays out of the file.
Step 3: Check it
Open Cursor's MCP settings and confirm fypnow is connected. If it is not, open the Output panel and choose MCP for the reason. A wrong URL, a missing key or a JSON syntax error are the usual causes.
Then ask:
What's trending across niches this week?
What you can ask it
The agent picks the FYPNow tools itself. These work well in an editor, because the answer can land in a file:
- "Which Fitness videos got the most views for their follower count this week?" A ranked list with views, the multiple and the opening line of each video.
- "Search analysed hooks about saving money and write the 10 best to
hooks.md, each with a fill-in template." Hook search returns a reusable template for every hook. - "Which hashtags are more creators using in Skincare than last week?" Rising hashtags, counted by distinct creators, so one busy account does not make a trend.
- "Analyze https://www.tiktok.com/@someone/video/123 and save the transcript and scene cuts to
notes/teardown.md." Needs a read+write key. A fresh teardown takes about a minute. - "Draft three scripts in
scripts/that use the top hook pattern in the Crypto niche."
What the data is
FYPNow tracks public TikTok videos by niche. Each niche is a set of keywords and hashtags, and new videos arrive when the niche refreshes, so the newest results can be a few days old. In niche results, the multiple means views compared with the creator's follower count. None of it touches anyone's private TikTok analytics.
Troubleshooting
401 missing_api_key. Cursor did not send the key. Usually the variable was set after Cursor started. Quit Cursor fully and reopen it. On macOS, an app opened from the Dock may not read your shell profile, so try launching it from a terminal withcursor ..401 invalid_api_key. The key is wrong or cut short. FYPNow keys start withfyp_sk_.403 write_scope_required. A read key called a write tool, such as analysing a new video. Create a read+write key if you need it.403 api_access_required. The workspace is not on an active paid plan. A trial counts.- The agent ignores the tools. Make sure you are in Agent mode, and name it in the prompt: "use fypnow to…".
Limits
- It reads and analyses. It does not post for you.
- A key acts on one workspace. Revoke it in Settings → API if it leaks. Revoking takes effect on the next request.
- Results describe what has happened to other videos. They are not a forecast.
Other guides
Using Windsurf or VS Code as well? See Windsurf and VS Code. The Claude setup guide covers the OAuth route and the prompts in more depth, and the MCP server page lists every tool.
Frequently asked questions
Where does Cursor keep MCP servers?
Global servers go in ~/.cursor/mcp.json. Project servers go in .cursor/mcp.json at the project root.
Why use an API key in Cursor?
The FYPNow site says Cursor needs an API key, not OAuth. Cursor's own docs say it can sign in with OAuth for some servers, so check the Cursor docs if you want to try that instead.
Should I create a read or a read+write key?
A read key can browse niches, trends, hashtags and hooks that already exist. A read+write key can also analyse new videos, create niches, search trends and generate scripts. Start with read if you only want research.
Can Cursor post videos to TikTok through FYPNow?
No. The FYPNow MCP server reads and analyses. Posting stays with you.
Start free trial
See why any TikTok or YouTube Short went viral with a frame-by-frame AI breakdown. 7-day free trial, then plans from $19/mo.
Prefer to explore first? Start free trial