fypnow

Model Context Protocol

The TikTok MCP server for Claude

Stop copying TikTok numbers into a chat window. Connect FYPNow to Claude once and ask it directly — what’s breaking out in crypto this week, and what hooks are they using? — and it pulls the videos, reads the teardowns and answers.

18 tools, OAuth in about thirty seconds, no API key to paste anywhere. Included on every paid plan.

Server URL

https://api.fypnow.com/mcp

Streamable HTTP, OAuth 2.1 with PKCE and dynamic client registration. Point an MCP client at it and it discovers the rest — no manual client registration, no secrets to manage.

Connect it in three steps

No API key, no config file, no terminal.

  1. 1

    In Claude, open Settings → Connectors

    Choose Add custom connector.

  2. 2

    Paste the server URL

    https://api.fypnow.com/mcp — leave authentication blank. Claude discovers it.

  3. 3

    Approve it on FYPNow

    Pick which workspace the connection acts on, choose read-only or read and write, and approve. The tools appear in Claude immediately.

Things worth asking it

Real prompts. The assistant picks the tools itself.

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

“Analyze this TikTok URL and tell me how long the hook runs before the first scene change.”

“Which of my tracked creators had a video break out this week?”

“Find videos similar to this one in my library.”

“Search viral trends for #bitcoin over the last 30 days.”

“Write me a script in the format that worked best for my account last month.”

All 18 tools

Generated from the same route table the API dispatches on, so this list cannot describe a tool that does not exist. A read-only connection sees the 13 read tools only.

Read (13) — free beyond the request itself

get_analysis_result

Resolves the job handle returned by analyze_tiktok_video into the finished analysis. Status is processing, completed or failed, and the response carries a retry_after_seconds hint for how long to wait between attempts while it is still processing.

get_script_result

Resolves the job handle returned by generate_script into the finished script. Status is processing, completed or failed, and the response carries a retry_after_seconds hint for how long to wait between attempts while it is still processing.

get_trend_search_result

Resolves the job handle returned by search_viral_trends into the finished results. Status is pending, complete or error, and the response carries a retry_after_seconds hint for how long to wait between attempts. A search already in flight is resolved here; starting another for the same hashtag spends a second viral search from the monthly allowance.

search_videos

Search analyzed videos and slideshows in this workspace by username, view count, date range, or format ('video' or 'slideshow'). Each row carries platform ('tiktok' or 'youtube') and post_format ('photo' carousel, 'slideshow' template, 'video', or null for a video).

get_video_analysis

Full AI analysis for one video or slideshow. A video returns hook, timing, scenes and transcript; a slideshow (schema_version carousel_v1) returns cover, slide-by-slide breakdown, narrative, aesthetic, audio, swipe and save drivers, and scores.

find_similar_videos

Find videos or slideshows similar to a given one using vector search. Each row carries post_format.

list_breakouts

List videos currently breaking out among tracked creators.

browse_niche_catalog

Browse available niches with their stats and metadata. Returns niches only, not videos, and carries no per-video AI analysis; that lives behind analyze_tiktok_video.

get_niche_videos

Top videos in one niche, ranked by how far they outperformed the niche's median (multiplier). Takes a niche id from browse_niche_catalog. Returns catalogue stats — views, likes, author, multiplier, platform — not per-video AI analysis. Niches mix TikToks and YouTube Shorts; platform is 'tiktok' or 'youtube'. A hook and scene teardown of a TikTok comes from analyze_tiktok_video, which takes its URL; that tool does not accept YouTube Shorts. Each row carries post_format; the format input ('video' or 'slideshow') narrows the list to one.

list_creators

List tracked creators in this workspace, with their ids.

get_creator_report

Profile, follower history and winning patterns for one creator.

get_growth_scorecard

Grade the workspace own account against its niche benchmarks.

get_account_usage

Current plan allowances and consumption. Free and unmetered.

Write (5) — draw down a plan quota

analyze_tiktok_video

Analyze a TikTok video or photo slideshow by URL (/video/ or /photo/ links). Consumes one catalog slot. TikTok URLs only: YouTube Shorts are analyzed in the fypnow.com web app, not here.

Catalog slot — standing cap, does not reset

create_niche

Create a Viral Content Agent that watches a niche by keyword.

Custom niche (Viral Content Agent) slot — standing cap

search_viral_trends

Search for breakout videos by hashtag. A cached hashtag returns full results right away. An uncached one returns a job handle (202) with no results yet; that handle is resolved by get_trend_search_result, which reports status complete or error and carries the results.

Trend search — monthly allowance

generate_script

Generate a script grounded in the workspace top performers. Returns a job handle (202) rather than the script itself, because generation takes up to a minute. The handle is resolved by get_script_result, which reports status completed or failed and carries the script.

Script — monthly allowance

save_video

Save a video to the workspace library. Works for TikToks and YouTube Shorts; pass platform ('tiktok' or 'youtube') from get_niche_videos, or omit it and a YouTube-shaped id is saved as a Short.

What it does not do

  • It is not a TikTok scraper you point anywhere. A connection acts on one workspace, against that workspace’s plan limits.
  • AI teardowns are computed on request. The niche catalogue carries statistics for tens of thousands of videos; the hook and scene analysis runs when you ask for a specific video, and takes a minute or so.
  • It cannot post for you. FYPNow reads and analyses; publishing stays in your hands.
  • It needs a paid plan. API and MCP access require an active subscription — a free trial counts.

Questions

What is a TikTok MCP server?
MCP (Model Context Protocol) is an open standard that lets an AI assistant call external tools. A TikTok MCP server exposes TikTok data and analysis as tools the assistant can use, so instead of copying numbers into a chat you ask a question in plain language and the assistant fetches the data itself. FYPNow's MCP server is at https://api.fypnow.com/mcp.
Do I need an API key to connect FYPNow to Claude?
No. Claude connects over OAuth 2.1 — you point it at https://api.fypnow.com/mcp, approve the connection on a FYPNow screen, and choose which workspace it acts on and whether it may write. No key is created, copied or stored. API keys exist for clients that do not speak OAuth, such as Cursor, VS Code and Windsurf, and for calling the REST API from your own code.
Does it work with ChatGPT?
The OAuth flow ChatGPT's app directory requires is live, and a ChatGPT custom action can call the REST API today with a bearer key. FYPNow is not yet listed in the ChatGPT app directory, so there is no one-click install there yet. Claude works today as a custom connector.
What can the assistant actually do?
Eighteen tools: browse niches and their top-performing videos, search your workspace's videos, get a full AI teardown of any TikTok URL (hook, scene timing, transcript, retention signals), find similar videos by vector search, list creator breakouts, search viral trends by hashtag, generate a script from your own winning patterns, and read your usage. Five of them write or spend quota; the rest are free reads.
Does the AI see my whole account?
A connection is bound to exactly one workspace, chosen when you approve it, and you pick read-only or read and write at the same time. A read-only connection cannot analyze a video, create a niche, search trends or generate a script — those tools are not even listed to it. You can revoke a connection at any time in Settings → API.
Does the MCP server cover YouTube Shorts?
Not yet — the MCP tools are TikTok-only, and analyze_tiktok_video accepts TikTok links. The FYPNow web app does analyze YouTube Shorts: paste a Shorts link into the analyzer for the same hook, scene and transcript breakdown. See the YouTube Shorts analysis page.
Is the MCP server included in my plan?
Yes. REST API and MCP access are included on every paid plan at no extra cost — there is no separate API add-on. Reads are free beyond the request itself; the tools that reach TikTok or run AI analysis draw down the same quotas the dashboard uses.

Put TikTok research inside the assistant you already use

Included on every paid plan. Thirty seconds to connect, and you can revoke it just as fast.