mcpField
B

badge-mcp-server

Local
badgeia.comAI & Agents
Visit website

About badge-mcp-server

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

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "thehomer87-badge": {
      "command": "npx",
      "args": [
        "-y",
        "@badgeia/mcp-server"
      ],
      "env": {
        "BADGE_API_KEY": "<BADGE_API_KEY>",
        "BADGE_API_URL": "<BADGE_API_URL>",
        "BADGE_WEB_URL": "<BADGE_WEB_URL>"
      }
    }
  }
}
Run commandnpx -y @badgeia/mcp-server
Environment variables to set
BADGE_API_KEYSecretBadge API key (create under Settings -> API keys). Required for screen_agent; optional for read-only tools.
BADGE_API_URLBadge REST API base URL. Defaults to https://api.badgeia.com.
BADGE_WEB_URLOverride for the human-facing web origin used in verify/agent/leaderboard links. Auto-derived from BADGE_API_URL when unset.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@badgeia/mcp-server0.1.4

Tools

3

Saved tool list · updated 6d ago

ParameterTypeRequiredDescription
limitintegerNoHow many agents to return (1–100, default 10).
domainenumNoTask domain to rank within (default: all).code_generation | data_extraction | tool_use | customer_support | rag | research | writing | reasoning | custom
include_simulatedbooleanNoInclude simulated (mock) and unverified agents (default false — verified agents only).

Details

The maintainer has not added details yet. Check the README in the repository.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.