fypnow
← Back to blog
mcpclaude-codeaitiktok

How to Connect TikTok Data to Claude Code (MCP Setup, 2026)

FYPNow Team··3 min read

Claude Code already lives where you keep scripts, notes and content plans. Adding FYPNow gives it TikTok data to work from: it can pull the week's top videos in a niche, read their hooks, check which hashtags more creators are picking up, and write the results straight into your repo. It takes one terminal command and a sign-in, and no API key ends up in your project.

What you need

  • Claude Code, installed and working.
  • A FYPNow workspace on a paid plan. Creator and Starter include a 7-day free trial.

Step 1: Add the server

Run this in a terminal:

claude mcp add --transport http fypnow https://api.fypnow.com/mcp

Step 2: Sign in

Start Claude Code, then run:

/mcp

Choose fypnow and sign in. A FYPNow window asks which workspace the connection acts on and whether it may write. Choose read only if you only want to research.

Step 3: Ask a real question

What's trending across niches this week?

Claude should call get_trending_videos. Then try:

What are the top videos in the Crypto niche right now, and what hooks do they use?

More prompts worth trying

Claude Code is at its best when the answer becomes a file:

  • "Search analysed hooks that open with a question and write the 10 strongest to hooks.md, each with its fill-in template."
  • "Which hashtags are more creators using in Skincare this week than last?" Counted by distinct creators, so one busy account doesn't make a trend.
  • "List the open trends in Fitness, with example video links, and save them to trends/fitness.md."
  • "Analyze https://www.tiktok.com/@someone/video/123: how long is the hook, and where are the scene cuts?" Needs read and write access. A fresh teardown takes about a minute.
  • "Which of my tracked creators had a video break out this week?" Breakouts compare a video with that creator's usual views, not their follower count.

What the data is

FYPNow tracks public TikTok videos by niche, and each niche refreshes on a schedule, so the newest videos can be a few days old. In niche results the multiple is views compared with follower count. Breakouts for creators you track are measured against that creator's own recent videos. None of it includes private analytics for any account.

Troubleshooting

  • fypnow is missing from /mcp. Run claude mcp list. The default scope is the project you ran the command in, so if you started Claude Code somewhere else, add it again with --scope user.
  • It says it needs authentication. Open /mcp, choose fypnow and sign in again. If the browser doesn't open, copy the link Claude Code prints.
  • Every call fails with a permission error. The connection may be bound to the wrong workspace, or that workspace's plan has lapsed. Connect again and pick a workspace on a paid plan.
  • write_scope_required. You chose read only. Connect again with write access to analyse new videos or search trends.

Limits

  • It reads and analyses. It does not post for you.
  • A connection is bound to one workspace. You can revoke it in Settings → API.
  • Results describe what has happened to other videos. They are not a forecast.

Using another terminal agent as well? See Codex CLI, Gemini CLI and OpenCode. For the Claude app, read the Claude setup guide. The MCP server page lists every tool.

Frequently asked questions

Do I need an API key for Claude Code?

No. The FYPNow server at https://api.fypnow.com/mcp uses OAuth. You sign in once with /mcp and approve the connection on a FYPNow screen. No key is created or stored in your project.

Is there a FYPNow plugin for Claude Code?

Not yet. The plugin install commands are hidden until the plugin repository is public. For now, add the server directly with the steps below.

Should I choose read only or read and write?

Read only can browse niches, trends, hashtags, hooks and existing analyses. Read and write can also analyse new videos, create niches, search trends and generate scripts. Start with read only; you can connect again with write access later.

Can I add it for one project only?

Yes. claude mcp add uses local scope by default, which means the current project on your machine. Add --scope user to use it everywhere, or --scope project to write it to a .mcp.json file your team can share.

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.

Start your 7-day free trial to analyze this video.

Prefer to explore first? Start free trial