TubeGradeTubeGrade
    Model Context Protocol

    TubeGrade MCP Server

    Give Claude, ChatGPT and any MCP client direct access to TubeGrade’s YouTube research — breakout videos, viral formats, channel & video stats with growth, transcripts, thumbnail similarity and keyword research, on demand.

    Server URLhttps://api.tubegrade.com/mcp

    Remote server over streamable HTTP. Sign in with your TubeGrade account to authorize — each call uses your credits.

    Get a free accountHow to connect

    Tools the model gets

    Sixteen tools. Each call deducts credits from your TubeGrade balance (the balance check and bookmarks are free).

    5credits

    Channel Stats

    tubegrade_get_channel

    Full stats + growth for any channel by id, @handle, or URL.

    5credits

    Video Stats

    tubegrade_get_video

    Metadata + growth (when tracked) for any video.

    5credits

    Search

    tubegrade_search_videos

    Search YouTube and rank results by signal.

    10credits

    Get Transcript

    tubegrade_get_transcript

    Pull the full transcript of any public video.

    20credits

    Similar Thumbnails

    tubegrade_find_similar_thumbnails

    Visual-similarity search across thumbnails.

    10credits

    Breakout Videos

    tubegrade_get_channel_outliers

    A channel’s biggest over-performing videos.

    5credits

    Get Comments

    tubegrade_get_comments

    Pull a video’s top comments.

    1credit

    Keyword Ideas

    tubegrade_expand_keywords

    Turn a seed query into related keyword ideas.

    10credits

    Find Outliers

    tubegrade_find_outliers

    Breakout videos by keyword — only over-performers.

    5credits

    Viral Formats

    tubegrade_viral_formats

    Proven viral title & thumbnail patterns by niche.

    3credits

    Channel Videos

    tubegrade_channel_videos

    A channel’s recent, popular, or shorts uploads.

    10credits

    Channel Transcripts

    tubegrade_channel_transcripts

    Bulk transcript text for a channel’s videos.

    1credit

    Channel Thumbnails

    tubegrade_channel_thumbnails

    Bulk thumbnail images for a channel’s videos.

    2credits

    My Competitors

    tubegrade_my_competitors

    Your tracked competitors + their growth.

    Free

    Bookmark

    tubegrade_bookmark

    Save, list & remove videos in your folders. Free.

    Free

    Credit Balance

    tubegrade_balance

    Check your remaining credits. Always free.

    How to connect

    TubeGrade is a remote MCP server, so any client that supports custom connectors can use it. Here are the three most common.

    Claude

    1. 1Open Claude (claude.ai or the desktop app) and go to Settings → Connectors.
    2. 2Click “Add custom connector”.
    3. 3Name it TubeGrade and paste the server URL above.
    4. 4Click Add, then Connect — sign in with your TubeGrade account to authorize.
    5. 5The TubeGrade tools now appear in chat. Ask things like “find outliers for this channel”.

    ChatGPT

    1. 1In ChatGPT, open Settings → Connectors (enable Developer mode if your plan requires it).
    2. 2Choose “Add” → custom MCP server.
    3. 3Paste the server URL above and continue.
    4. 4Authorize with your TubeGrade account when the OAuth window opens.
    5. 5Enable TubeGrade from the tools menu in the composer to use it in a chat.

    Cursor & other clients

    1. 1Open your client’s MCP config (e.g. Cursor’s mcp.json, VS Code, or any MCP-capable app).
    2. 2Add the TubeGrade server using the JSON below.
    3. 3Reload the client — it will prompt you to sign in with your TubeGrade account.
    4. 4The sixteen TubeGrade tools become available to the model.
    mcp.json
    {
  "mcpServers": {
    "tubegrade": {
      "url": "https://api.tubegrade.com/mcp"
    }
  }
}
    Create your account See credits & pricing