CreatorScore MCP Server

Vet creators, influencers, and athletes from inside Claude Desktop, Claude Code, ChatGPT, or any MCP client — without leaving the conversation.

This is a Model Context Protocol server. It's a thin client over the public CreatorScore API. It holds exactly one secret — your API key — and makes plain HTTPS calls to https://creatorscore.io/api/v1/*.

It has no database access and no scraping/ML/provider credentials. Every score is produced server-side by CreatorScore's gated v2.2 seven-agent scoring pipeline — the same one the brand dashboard uses. The MCP user is strictly less privileged than a logged-in brand: credit metering, rate limits, the daily fresh-scrape circuit breaker, and tenant isolation all apply automatically.

What it can do

| Tool | What it does | Cost | |------|--------------|------| | help | Show the menu of everything CreatorScore can do and what each option needs. | Free | | check_account | Show your credit balance and per-platform pricing. | Free || score_creator_footprint | From a single handle, discover the creator's accounts across platforms (bio link-in-bio + Google-verified matches, each with a confidence) and return the unified whole-footprint score + breakdown + worst risks. The easiest way to vet a creator. | 1 credit discovery + 1 per scored account | | vet_creator | Vet one creator across all their accounts at once (you supply the handles) — unified cross-platform CreatorScore + per-platform breakdown + worst risks anywhere. Never scrapes. | 1 credit per scored account || score_creator_fresh | Run a fresh, full scoring pass (scrape + transcribe + score). Requires confirm: true. Usually queues a job. | 1–3 credits / platform | | check_score_job | Poll a fresh-scoring job until it's done. | Free | | calculate_fair_rate | OCRS rate calculator — what to charge/pay for a sponsored post. Returns a fair rate + confidence band + multiplier breakdown. Pure math, no scraping or scoring. | Free (0 credits) |

Safety by design

• Footprint, not single accounts. A CreatorScore is always a creator's whole cross-platform footprint, never one isolated account. The scoring tools read cached scores first and never silently scrape — triggering a fresh (paid) scoring pass is a separate, explicit, confirm-gated tool.
• Transparency. Score output always names the what behind a penalty — every knockout shows its reason, every risk flag shows its description. Never "2 issues detected" with no detail.

Setup

1. Get an API key

Sign up at creatorscore.io/signup/developer or grab a key from creatorscore.io/account/api. Buy a credit pack from the same page.

2. Add it to your MCP client

No install step — npx fetches and runs the published package on demand.

Claude Desktop — edit claude_desktop_config.json:

{
  "mcpServers": {
    "creatorscore": {
      "command": "npx",
      "args": ["-y", "creatorscore-mcp"],
      "env": {
        "CREATORSCORE_API_KEY": "sk_live_..."
      }
    }
  }
}

Claude Code — one command:

claude mcp add creatorscore -e CREATORSCORE_API_KEY=sk_live_... -- npx -y creatorscore-mcp

Then restart the client. Try: "Use creatorscore to check my account balance, then vet @mrbeast on youtube."

Working from a clone of this repo instead? You can run it from source: npm install && npm run build in mcp-server/, then point command/args at node /absolute/path/to/mcp-server/dist/index.js.

Configuration

| Env var | Required | Default | Description | |---------|----------|---------|-------------| | CREATORSCORE_API_KEY | ✅ | — | Your X-API-Key. | | CREATORSCORE_API_BASE | | https://creatorscore.io/api/v1 | Override the API base URL (e.g. for staging). |

How a fresh score flows

score_creator_fresh (confirm: true)
        │  POST-style GET /api/v1/creators/{platform}/{handle}
        ▼
  CreatorScore servers: scrape → transcribe every video → v2.2 scoring
        │  returns 202 + job_id
        ▼
check_score_job (poll ~every 30s)  ──►  status: done → full score

The agent never touches the scrapers, the ML service, or any provider key. It asks the API for a score; the API does the work behind the credit wall.

License

UNLICENSED — internal CreatorScore project.