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.

    Tools the model gets

    23 tools. Each call deducts credits from your TubeGrade balance (the balance check, bookmarks and competitor tracking 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.

    5credits

    Suggested Videos

    tubegrade_suggested_videos

    The videos YouTube itself recommends next to any video.

    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.

    1credit

    Video Thumbnails

    tubegrade_thumbnails

    Actual thumbnail images for specific videos, any channel.

    5credits

    Similar Channels

    tubegrade_similar_channels

    Same-topic channels of a similar size — natural competitors.

    1credit

    YouTube Rankings

    tubegrade_rankings

    Weekly fastest-growing, breakout & most-subscribed channels by country.

    2credits

    My Competitors

    tubegrade_my_competitors

    Your tracked competitors + their growth.

    Free

    Track Competitor

    tubegrade_track_competitor

    Add a channel to your tracked competitors (Pro). Free.

    Free

    Untrack Competitor

    tubegrade_untrack_competitor

    Remove a channel from your tracked competitors. Free.

    Free

    Bookmark

    tubegrade_bookmark

    Save & remove videos in your folders. Free.

    Free

    Saved Videos

    tubegrade_list_bookmarks

    List your saved videos and 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 Customize → Connectors.
    2. 2Click “+ Add”, then “Add custom connector”.
    3. 3Name it TubeGrade, paste the server URL above and click Continue.
    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 Plugins (chatgpt.com/plugins). Your account or workspace must allow custom MCP servers.
    2. 2Click “+”, then “Add custom MCP server”, and name it TubeGrade.
    3. 3Under Connection, paste the server URL above, then choose “Create as a plugin”.
    4. 4Authorize with your TubeGrade account when the sign-in window opens.
    5. 5Turn TubeGrade on from the composer’s tools menu 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 TubeGrade tools become available to the model.
    mcp.json
    {
      "mcpServers": {
        "tubegrade": {
          "url": "https://api.tubegrade.com/mcp"
        }
      }
    }