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/mcp

psst: it's the same URL for every app ✦

Streamable HTTPOAuth 2.1 + PKCE46 tools6 prompts6 skillsMCP Registry: com.lilnero/lil-nero

Quick start

  1. 1

    Add the connector

    Paste https://mcp.lilnero.com/mcp where your AI app adds a custom connector or MCP server. Steps for 25 apps.

  2. 2

    Sign in

    Your app opens the Lil Nero sign-in. Use Google or email, then click Allow. There's no API key.

  3. 3

    Ask

    Type /hey-nero and 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.

Reads onlySaves to your workspaceDeletes or overwritesReads public platforms

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 only
  • List tracked accounts

    reference_list

    List tracked accounts (own and references).

    Reads only
  • List tracked topics

    topic_list

    List tracked topics.

    Reads only
  • Track 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 workspace
  • Stop tracking a topic

    topic_untrack

    Stop tracking a topic. No-op if it wasn't tracked.

    Saves to your workspaceDeletes or overwrites
  • Create a workspace

    workspace_init

    Create a workspace and make it the active one.

    Saves to your workspace
  • List workspaces

    workspace_list

    List your workspaces and which one is active.

    Reads only
  • Track an account

    workspace_register

    Register a creator account to track. Re-registering updates url/own/tags.

    Saves to your workspace
  • Switch workspace

    workspace_switch

    Set the active workspace. It must already exist.

    Saves to your workspace
  • Stop 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 overwrites
  • Delete a run

    run_delete

    Delete a run and its run documents. Promoted items (ideas, research, knowledge) are kept.

    Saves to your workspaceDeletes or overwrites
  • Log run progress

    run_event_append

    Record a step in the run's event log.

    Saves to your workspace
  • Finish a run

    run_finalize

    Close a run. Call once at the end of a workflow.

    Saves to your workspace
  • List runs

    run_list

    List recent runs, newest first.

    Reads only
  • Save 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 workspace
  • Show a run

    run_show

    Show a run: metadata, inputs, promotions, and its documents.

    Reads only
  • Start 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 only
  • Read a document

    doc_read

    Read a workspace document (frontmatter + body). Long bodies come in chunks; pass next_offset to continue.

    Reads only
  • Save 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 workspace
  • Save 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 overwrites
  • List research

    research_list

    List named research projects.

    Reads only
  • Show 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 only
  • Read your strategy

    knowledge_strategy

    Get the consolidated strategy docs (full text), grouped by format.

    Reads only
  • Save a learning

    write_learning

    Record a learn-session snapshot. Call once at the end of a learn pass.

    Saves to your workspace
  • Save 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 workspace
  • Replace 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 overwrites
  • Save a draft for an idea

    promote_artifact

    Save a draft (script, post, short, plan, reply) into content/ideas/{idea_slug}/.

    Saves to your workspace
  • Save an idea

    promote_idea

    Save a selected idea to content/ideas/{slug}/idea.md.

    Saves to your workspace
  • Save to the library

    promote_library

    Save an external piece of content to library/{item_id}.md.

    Saves to your workspace
  • Write 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 only
  • Read 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 platforms
  • Read a post's comments

    crawl_comments

    Collect comments / replies on one piece of content.

    Saves to your workspaceReads public platforms
  • Read a post

    crawl_content

    Deep-crawl one piece of content (text, stats, transcript where available, top comments).

    Saves to your workspaceReads public platforms
  • Read 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 platforms
  • Search 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 platforms
  • Get 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 only
  • Who 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/mcp and /.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_get returns 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-nero plus hey-nero-<verb> through the MCP Skills extension, also readable as skill:// 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.

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

Version 1.0.1 · updated