Docs · v1.0.1
Lil Nero MCP server
One remote MCP server that turns any AI app into a content strategist for YouTube, X, Instagram and Threads creators. Add the URL, sign in, and ask.
https://mcp.lilnero.com/mcppsst: it's the same URL for every app ✦
Quick start
- 1
Add the connector
Paste
https://mcp.lilnero.com/mcpwhere your AI app adds a custom connector or MCP server. Steps for 25 apps. - 2
Sign in
Your app opens the Lil Nero sign-in. Use Google or email, then click Allow. There's no API key.
- 3
Ask
Type
/hey-neroand what you want, or just ask in plain words. For platform research, also add the Chrome extension.
Claude Code: claude mcp add --transport http lil-nero https://mcp.lilnero.com/mcp
What to ask
Lil Nero has five moves. You never have to name them, but naming one is a shortcut.

analyze
Why a post, account or comment section works, compared with the creator's own history.
/hey-nero analyze youtube.com/@Fireship

research
Outlier posts, rising topics and new creators in a niche.
/hey-nero research outlier videos about AI coding

optimize
Test a title, hook, script or thumbnail before posting.
/hey-nero optimize this title: "I tried 5 AI coding tools"

make
Scripts ready to record, ideas, drafts, replies and a weekly plan, in the creator's voice.
/hey-nero make a 60-second script about AI code review

brief
The Daily Drop: what changed and what to post today.
/hey-nero brief
Tools
46 tools. Your AI app picks them; you don't call them by hand. Every tool has a title and MCP annotations, shown here as labels.
Start here
Get a Lil Nero playbook
workflow_get
Lil Nero's playbook for a request, e.g. "/hey-nero what should I post", "analyze @x" or "fix my hook". verb='overview' covers a plain-English request; analyze, research, optimize, make and brief cover one move each. With `rule`, returns a supporting rule that a playbook step names.
Reads only
Workspace
Show plan and limits
plan_status
The user's plan (PRO or MAX), its limits, current usage, and the overnight schedule.
Reads onlyList tracked accounts
reference_list
List tracked accounts (own and references).
Reads onlyList tracked topics
topic_list
List tracked topics.
Reads onlyTrack a topic
topic_track
Track a topic. On MAX, Lil Nero searches it every night and alerts you when it starts rising.
Saves to your workspaceStop tracking a topic
topic_untrack
Stop tracking a topic. No-op if it wasn't tracked.
Saves to your workspaceDeletes or overwritesCreate a workspace
workspace_init
Create a workspace and make it the active one.
Saves to your workspaceList workspaces
workspace_list
List your workspaces and which one is active.
Reads onlyTrack an account
workspace_register
Register a creator account to track. Re-registering updates url/own/tags.
Saves to your workspaceSwitch workspace
workspace_switch
Set the active workspace. It must already exist.
Saves to your workspaceStop tracking an account
workspace_unregister
Stop tracking an account. No-op if it wasn't registered.
Saves to your workspaceDeletes or overwrites
Runs
Cancel a run
run_cancel
Cancel an in-flight run.
Saves to your workspaceDeletes or overwritesDelete a run
run_delete
Delete a run and its run documents. Promoted items (ideas, research, knowledge) are kept.
Saves to your workspaceDeletes or overwritesLog run progress
run_event_append
Record a step in the run's event log.
Saves to your workspaceFinish a run
run_finalize
Close a run. Call once at the end of a workflow.
Saves to your workspaceList runs
run_list
List recent runs, newest first.
Reads onlySave a run as research
run_promote
Turn a run into a named research project (research/{kind}/{slug}). Several runs can feed one project.
Saves to your workspaceShow a run
run_show
Show a run: metadata, inputs, promotions, and its documents.
Reads onlyStart a run
run_start
Start a run: the record of one workflow's steps and outputs. Returns the run_id that later calls attach to.
Saves to your workspace
Documents
List documents
doc_list
List workspace documents under a path prefix (paths and metadata, no bodies).
Reads onlyRead a document
doc_read
Read a workspace document (frontmatter + body). Long bodies come in chunks; pass next_offset to continue.
Reads onlySave an analysis
write_analysis
Save an analysis document with frontmatter metadata, attributed to a run. The `report` argument is the version the dashboard shows.
Saves to your workspaceSave a run's output
write_run_output
Save a workflow's human-facing result under runs/{run_id}/output/. The `report` argument is the version the dashboard shows. Items in `highlights` become alerts for the creator.
Saves to your workspace
Research
Delete research
research_delete
Delete a research project and its research-scoped analyses. Source runs are kept.
Saves to your workspaceDeletes or overwritesList research
research_list
List named research projects.
Reads onlyShow research
research_show
Show a research project: its source runs and every document in it.
Reads only
Knowledge
Search your knowledge
knowledge_search
Search patterns (ranked by relevance x confidence), learnings, and strategy docs. Each hit includes the path of the full document.
Reads onlyRead your strategy
knowledge_strategy
Get the consolidated strategy docs (full text), grouped by format.
Reads onlySave a learning
write_learning
Record a learn-session snapshot. Call once at the end of a learn pass.
Saves to your workspaceSave a pattern
write_pattern
Save a knowledge pattern. If a near-identical pattern exists (>80% word overlap) it is merged instead: evidence and sources are added and confidence is nudged up.
Saves to your workspaceReplace a strategy
write_strategy
Write or replace a consolidated strategy doc for a format (knowledge/{format}/strategies/{name}.md).
Saves to your workspaceDeletes or overwrites
Projects
Edit a document
doc_edit
Revise an existing document: exact-text body replacements and/or frontmatter field updates. Use for updating ideas (status, tags), drafts, and strategy docs.
Saves to your workspaceDeletes or overwritesSave a draft for an idea
promote_artifact
Save a draft (script, post, short, plan, reply) into content/ideas/{idea_slug}/.
Saves to your workspaceSave an idea
promote_idea
Save a selected idea to content/ideas/{slug}/idea.md.
Saves to your workspaceSave to the library
promote_library
Save an external piece of content to library/{item_id}.md.
Saves to your workspaceWrite a strategy document
promote_strategy
Save a long-lived strategy doc under strategy/.
Saves to your workspaceDeletes or overwrites
Platforms
Check the Chrome extension
browser_status
Check whether the user's Lil Nero Chrome extension is online. Research that reads platform pages needs it.
Reads onlyRead an account's posts
crawl_account
Crawl an account's profile and recent content through the user's browser. Saves JSON under the run. Returns `changes`: which items are new since the last crawl of this account in this workspace (`new_content_ids`, `new_count`, `first_crawl`), follower / post-count changes, and `pace`: young posts vs the creator's usual views at the same age (compare with this, not raw totals).
Saves to your workspaceReads public platformsRead a post's comments
crawl_comments
Collect comments / replies on one piece of content.
Saves to your workspaceReads public platformsRead a post
crawl_content
Deep-crawl one piece of content (text, stats, transcript where available, top comments).
Saves to your workspaceReads public platformsRead your home feed
feed
Read the user's home feed on a platform (what the algorithm shows them) and save it.
Saves to your workspaceReads public platformsSearch a platform
search
Search a platform as the user (their logged-in view) and save the results.
Saves to your workspaceReads public platforms
Video and images
Get video frames
filmstrip
Show evenly spaced frames from a video so you can analyse pacing, visuals, and on-screen text. If the video's frames can't be read, the result has error_code frames_unavailable.
Saves to your workspaceReads public platformsGet a post's thumbnail
thumbnail
Show the thumbnail / cover image of a post, video, or reel so you can analyse it visually.
Saves to your workspaceReads public platforms
System
Server info
server_info
Report the Lil Nero server version. Use to check the connection works.
Reads onlyWho am I
whoami
Show which Lil Nero account this connection is signed in as.
Reads only
Sign-in
Standard MCP authorization. Apps register themselves and send you to the Lil Nero sign-in; you approve once per app.
- Transport
- Streamable HTTP at
https://mcp.lilnero.com/mcp(no SSE) - Protocol
- OAuth 2.1 authorization code flow with PKCE (S256)
- Client registration
- Dynamic client registration (RFC 7591); client ID metadata documents are advertised
- Discovery
- A 401 includes
resource_metadata; metadata at/.well-known/oauth-protected-resource/mcpand/.well-known/oauth-authorization-server - Scope
nero, one scope for your Lil Nero workspaces- Tokens
- Access tokens last 1 hour; refresh tokens last 30 days and rotate on every use. Revoke at /revoke or by removing the connector.
- Sign-in methods
- Google, or email and password. Choose a different account on the consent screen any time.
Prompts and skills
The playbooks behind the five moves are served three ways, from one source.
- Tool
workflow_getreturns the playbook for a move. Works in every app.- MCP prompts
/hey-nero,/analyze,/research,/optimize,/make,/brief, in apps that show prompts as commands (Claude, Claude Code, VS Code, Cursor).- Agent Skills
hey-neroplushey-nero-<verb>through the MCP Skills extension, also readable asskill://resources.- Claude Code plugin
/plugin install lil-nero --marketplace TheRexyCodes/lil-nero-claude
Data and privacy
- Where data lives
- In your Lil Nero workspace (Google Cloud, us-central1): tracked accounts, research runs, reports and documents.
- How platforms are read
- By the Lil Nero Chrome extension, in your own browser, in tabs it opens for a job. Your platform logins never leave Chrome. On MAX, public data also comes from a licensed data provider.
- What it never does
- Post, comment, like or change anything on YouTube, X, Instagram or Threads. Read your other tabs or browsing history.
- AI processing
- Your AI app does the thinking during a conversation; Lil Nero calls no AI model then. On MAX, the overnight team uses Claude to write your Daily Drop.
- Policies
- Privacy policy · Terms
Plans
PRO
Your strategist on demand: every tool, 15 tracked creators and 5 topics. Research runs through the Chrome extension.
MAX
Adds the 24/7 overnight team: nightly tracking, alerts, comment watch and a Daily Drop every morning. 100 creators and 50 topics.
Lil Nero adds no AI credits; your AI app does the thinking. Pricing
Support
- Email: support@lilnero.com
- Setup help for your app: lilnero.com/install
- Using Lil Nero in Claude: the Claude guide
- Status check:
https://mcp.lilnero.com/health
Version 1.0.1 · updated

