Badgeia MCP Server
io.github.thehomer87/badge-mcp-serverv0.1.3
Screen AI agents, read Badge fitness scores, and browse the public Talent Pool leaderboard.
context tax
queued
security
queued
cold start
queued
freshness
Maintained2mo ago
Install Badgeia MCP server
Install in Claude Code
claude mcp add badgeia -e BADGE_API_KEY='<badge-api-key>' -- npx -y @badgeia/mcp-serverInstall in Cursor
{
"mcpServers": {
"badgeia": {
"command": "npx",
"args": [
"-y",
"@badgeia/mcp-server"
],
"env": {
"BADGE_API_KEY": "<badge-api-key>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"badgeia": {
"command": "npx",
"args": [
"-y",
"@badgeia/mcp-server"
],
"env": {
"BADGE_API_KEY": "<badge-api-key>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"badgeia": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@badgeia/mcp-server"
],
"env": {
"BADGE_API_KEY": "<badge-api-key>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"badgeia": {
"command": "npx",
"args": [
"-y",
"@badgeia/mcp-server"
],
"env": {
"BADGE_API_KEY": "<badge-api-key>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| BADGE_API_KEY | — | yes | 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. |
Freshness
Maintained — last maintenance signal 2mo ago. The newest of the signals below sets the band.
Last commit (default branch)
no data · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-08-10 · 2mo ago · official registry · v0.1.3
FAQ
›How do I install the Badgeia MCP server in Claude Code?
Run: claude mcp add badgeia -e BADGE_API_KEY='<badge-api-key>' -- npx -y @badgeia/mcp-server. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Badgeia require an API key?
Yes. It expects BADGE_API_KEY, of which 1 is a secret.
›Can I use Badgeia as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Badgeia in the official MCP registry?
Yes, as io.github.thehomer87/badge-mcp-server.