English Français العربية

io.github.thehomer87/badge-mcp-server

Official registry Health

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

Website

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @badgeia/mcp-server
Claude Code 
claude mcp add badge-mcp-server -e 'BADGE_API_KEY=<your badge_api_key>' -e 'BADGE_API_URL=https://api.badgeia.com' -e 'BADGE_WEB_URL=<BADGE_WEB_URL>' -- npx -y @badgeia/mcp-server@0.1.4
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "badge-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@badgeia/mcp-server@0.1.4"
            ],
            "env": {
                "BADGE_API_KEY": "<your badge_api_key>",
                "BADGE_API_URL": "https://api.badgeia.com",
                "BADGE_WEB_URL": "<BADGE_WEB_URL>"
            }
        }
    }
}

Environment variables

  • BADGE_API_KEY secret Badge API key (create under Settings -> API keys). Required for screen_agent; optional for read-only tools.
  • BADGE_API_URL 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.

Frequently asked questions

What is io.github.thehomer87/badge-mcp-server?

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

How do I install io.github.thehomer87/badge-mcp-server?

It runs on your machine. In Claude Code: claude mcp add badge-mcp-server -e 'BADGE_API_KEY=<your badge_api_key>' -e 'BADGE_API_URL=https://api.badgeia.com' -e 'BADGE_WEB_URL=<BADGE_WEB_URL>' -- npx -y @badgeia/mcp-server@0.1.4. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.thehomer87/badge-mcp-server need an API key?

Yes. It expects BADGE_API_KEY, which you set in its configuration.

Who maintains io.github.thehomer87/badge-mcp-server?

It is published by thehomer87. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.