# Badge MCP Server

> Badge MCP Server is a freemium MCP server for ai models and llm tooling. Screen AI agents, read signed Badge fitness scores and browse the Talent Pool. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $12 a month
- **Platforms:** CLI, API, Web
- **Website:** https://badgeia.com
- **MCP Registry name:** io.github.thehomer87/badge-mcp-server
- **Categories:** AI models and LLM tooling
- **Listing updated:** 2026-11-16

## About

Badge (badgeIA) scores AI agents with the same standardised screen for everyone: three work samples produce one composite from 0 to 100, weighted 40 percent success, 30 percent execution consistency and latency, and 30 percent cost. A separate five-axis radar (correctness, latency, cost, tool efficiency, robustness) is for diagnosis only. Each completed run is signed with an Ed25519 key and gets a certificate page anyone can check against Badge's public key.

The MCP server gives an assistant five tools: screen, schedule, score, verify and leaderboard. screen_agent needs a Badge API key and the public HTTPS address of your agent, because Badge calls it from the internet. Without an endpoint, a screening is simulated and cannot earn the verified mark. The read-only tools work with an optional key and cover scores and the public Talent Pool ranking.

The site also offers a Hiring Frontier, which compares candidate models by cost per task and pass rate to find the cheapest verified one that clears your bar. Public scoring is free, and a certificate proves integrity and provenance rather than that a task was hard or the result will repeat.

## Features

- **Standardised screen:** Runs three work samples against an agent's HTTPS endpoint.
- **Signed certificates:** Ed25519-signed runs with publicly verifiable pages.
- **Talent Pool:** Browse a public leaderboard ranked by composite score.
- **Five-axis diagnosis:** Radar of correctness, latency, cost, tool efficiency and robustness.
- **Hiring Frontier:** Finds the cheapest verified model that meets your score bar.
- **README badge:** Embed a live score badge linking to the certificate.

## Good for

- Getting a verifiable score for an agent you built
- Checking a candidate agent's certificate before hiring
- Comparing models by cost per task and pass rate
- Scheduling regular re-screens
- Browsing top-ranked agents

## Install

### Claude Code (Terminal)

```sh
claude mcp add badge-mcp-server --env BADGE_API_KEY='<BADGE_API_KEY>' -- npx -y @badgeia/mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "badge-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@badgeia/mcp-server"
      ],
      "env": {
        "BADGE_API_KEY": "<BADGE_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "badge-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@badgeia/mcp-server"
      ],
      "env": {
        "BADGE_API_KEY": "<BADGE_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "badge-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@badgeia/mcp-server"
      ],
      "env": {
        "BADGE_API_KEY": "<BADGE_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "badge-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@badgeia/mcp-server"
      ],
      "env": {
        "BADGE_API_KEY": "<BADGE_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "badge-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@badgeia/mcp-server"
      ],
      "env": {
        "BADGE_API_KEY": "<BADGE_API_KEY>"
      }
    }
  }
}
```

## Tools

- `screen_agent`: Screens an agent endpoint and returns a signed score; requires a Badge API key.

## FAQ

### Is it free?

Public scoring is free; Pro is $12 a month, Team $29 a month, and Enterprise starts at $499 a month billed annually.

### Do I need a public endpoint?

Yes for a verified score. Without one the run is simulated and cannot earn a certificate.

### What does verified mean?

The run was recorded by Badge and has not been altered; it does not claim the task was hard.

### Does Badge see my code?

No. It calls your endpoint like any client and records results.

### How many runs are included?

Free allows 30 per month, Pro 1,000 and Team 5,000.

### Is Badge MCP Server free?

Badge MCP Server has a free plan, with paid plans for more usage or features. Paid plans start at $12 a month.

### How do I add Badge MCP Server to Claude Code?

Run this command in your terminal: claude mcp add badge-mcp-server --env BADGE_API_KEY='<BADGE_API_KEY>' -- npx -y @badgeia/mcp-server

### What are the best alternatives to Badge MCP Server?

The closest alternatives to Badge MCP Server are Claude Code Ultimate Guide, signafAIde, Toolkien, Lugh and HypePaper.

## Alternatives

- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [signafAIde](https://ai-powered.com/mcp/signafaide): signafAIde is a freemium MCP server for security.
- [Toolkien](https://ai-powered.com/mcp/toolkien): Toolkien is an open-source MCP server for ai models and llm tooling.
- [Lugh](https://ai-powered.com/mcp/lugh): Lugh is an open-source MCP server for ai models and llm tooling.
- [HypePaper](https://ai-powered.com/mcp/hypepaper): HypePaper is a freemium MCP server for ai models and llm tooling.
- [Agent Data Tools: Compact (find, describe, run)](https://ai-powered.com/mcp/agent-data-tools-compact-find-describe-run): Agent Data Tools: Compact (find, describe, run) is a freemium MCP server for developer tools.
- [Angel Agent Guard: pre-purchase check + prompt-injection scan](https://ai-powered.com/mcp/angel-agent-guard-pre-purchase-check-prompt-injection-scan): Angel Agent Guard: pre-purchase check + prompt-injection scan is a freemium MCP server for ai models and llm tooling.
- [Mizan Calibration](https://ai-powered.com/mcp/mizan-calibration): Mizan Calibration is a free MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/badge-mcp-server
