Back to Browse

Bangermap Integrations MCP Server

Developer ToolsLow Risk9.7MCP RegistryLocal
Free

Server data from the Official MCP Registry

Find YouTube outliers, videos that beat their channel's own baseline, on your own free API key.

About

Find YouTube outliers, videos that beat their channel's own baseline, on your own free API key.

Security Report

9.7
Low Risk9.7Low Risk

Valid MCP server (2 strong, 3 medium validity signals). 1 code issue detected. No known CVEs in dependencies. ⚠️ Package registry links to a different repository than scanned source. Imported from the Official MCP Registry. 2 finding(s) downgraded by scanner intelligence.

9 files analyzed · 2 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

Your own YouTube Data API v3 key, created free in the Google Cloud consoleRequired

Environment variable: YOUTUBE_API_KEY

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-adesiahq-bangermap-mcp": {
      "env": {
        "YOUTUBE_API_KEY": "your-youtube-api-key-here"
      },
      "args": [
        "-y",
        "bangermap-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

Bangermap integrations

YouTube outlier research as installable pieces, each running on your own free YouTube Data API key.

An outlier is a video that beat its own channel's normal performance. A 10x on a small channel is a stronger signal than a million views on a channel that always gets a million, because it is proof an idea worked without an audience behind it. Everything here measures that, and nothing here meters you.

PackageWhat it is
bangermap-mcpAn MCP server, four tools over stdio, for Claude Code, Claude Desktop and any other MCP client
n8n-nodes-bangermapAn n8n community node, the same four operations, one output item per outlier, in its own repo

The server reads src/lib, the scoring engine and YouTube client it shares with the Bangermap app, its free browser tool and the n8n node. One definition of an outlier, four places it runs, so they cannot disagree.

Why bring your own key

Google gives every account a free YouTube Data API key with 10,000 units a day, which is roughly 1,100 channel scans. Reading a channel costs one unit. Tools that resell those calls as credits are charging for something that is free on your own key, and metering it is the only way that business works.

So there is no account here, no credits, and no server of ours in the middle. Requests go from your machine to googleapis.com.

How the baseline works

For each channel, the baseline is the median views of its recent uploads of the same format, counting only uploads old enough to have settled. Shorts and long-form get separate baselines, since comparing a 40-second Short against a 20-minute upload would flatter one and punish the other. A video's multiple is its views divided by that baseline.

Discovery runs through the channel graph rather than keyword search. Google caps search at 100 calls a day on a free key while channel reads cost a single unit, so seeding from a channel you already know is both cheaper and deeper.

The outlier multiple and the baseline are computed here, not by YouTube. View and channel data comes from the YouTube Data API. YouTube is a trademark of Google LLC.

Build and test

cd mcp && npm install && npm run build

The shared engine's tests run from the root.

npm install && npm test

This repo is generated

It is a path-preserving subset of the Bangermap monorepo, synced by a script. Pull requests are welcome as discussion, but the fix lands upstream and arrives here on the next sync, so nothing committed directly here survives.

The app

Bangermap is a Mac app for the same research when you want it to persist. It keeps a watchlist that re-scans and flags what is new since your last visit, shows outliers in a thumbnail wall for pattern study, exports to CSV, and caches locally so repeat research does not re-spend quota. One payment, no subscription, same free key.

License

MIT

Reviews

No reviews yet

Be the first to review this server!