Badge MCP Server

Official

by thehomer87

Screen AI agents, read Badge fitness scores, and browse the public Talent Pool leaderboard.

Install

Configuration

Environment variables

BADGE_API_KEYsecret

Badge API key (create under Settings -> API keys). Required for screen_agent; optional for read-only tools.

BADGE_API_URLdefault https://api.badgeia.com

Badge REST API base URL. Defaults to https://api.badgeia.com.

BADGE_WEB_URL

Override for the human-facing web origin used in verify/agent/leaderboard links. Auto-derived from BADGE_API_URL when unset.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "badge-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@badgeia/mcp-server@0.1.1"
      ],
      "env": {
        "BADGE_API_KEY": "<YOUR_BADGE_API_KEY>",
        "BADGE_API_URL": "https://api.badgeia.com",
        "BADGE_WEB_URL": "<YOUR_BADGE_WEB_URL>"
      }
    }
  }
}