# MCP Compliance

> MCP Compliance is an open-source MCP server for security. Run an 88-test MCP spec compliance suite and get an A-F grade from CLI or agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API
- **Website:** https://yaw.sh/mcp-servers/mcp-compliance/
- **Repository:** https://github.com/yawlabs/mcp-compliance
- **MCP Registry name:** io.github.YawLabs/mcp-compliance
- **Categories:** security, developer tools, AI models and LLM tooling
- **Listing updated:** 2026-11-14

## About

The suite checks HTTP and stdio servers across eight categories: transport, lifecycle, tools, resources, prompts, error handling, schema validation and security. Security tests go beyond the spec: auth enforcement, TLS, session entropy, CORS and Origin validation, command, SQL, path-traversal and SSRF resistance, tool rug-pull and description poisoning, and stack-trace or internal-IP leakage.

The grade is weighted, with required tests worth 70% and optional tests 30%. Flags let you run or skip whole categories or single test IDs, and an authenticated target can take credentials per run. It ships as a CLI, an MCP server and a programmatic API.

In an agent you can ask it to explain a failing test ID and the spec section behind it. Published by Yaw Labs on npm, MIT licensed, with no API key; the suite talks only to the server you point it at.

## Features

- **88 conformance tests:** Covers transport through security in eight categories.
- **Weighted grade:** Required tests count 70% and optional ones 30%.
- **Test selection:** Run or skip categories or individual test IDs.
- **Test explanations:** Describes what a test checks and why.
- **Three interfaces:** CLI, MCP server and programmatic API.

## Good for

- Check a server in CI before release
- Audit a third-party server before trusting it
- Debug a failing JSON-RPC error code
- Check a server for description poisoning

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-compliance -- npx -y @yawlabs/mcp-compliance
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-compliance": {
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/mcp-compliance"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-compliance": {
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/mcp-compliance"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp-compliance": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/mcp-compliance"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-compliance": {
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/mcp-compliance"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-compliance": {
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/mcp-compliance"
      ]
    }
  }
}
```

## Tools

- `mcp_compliance_test`: Runs the suite against a URL or stdio command and returns grade, score and per-test results.
- `mcp_compliance_explain`: Explains a test ID and the spec section behind it.

## FAQ

### Does it send data to Yaw Labs?

No. The suite talks only to the server you target.

### Can it test stdio servers?

Yes, both HTTP endpoints and stdio commands.

### Is an API key needed?

No.

### What licence is it under?

MIT.

### Is MCP Compliance free?

Yes. MCP Compliance is open source, so you can use and self-host it for free.

### How do I add MCP Compliance to Claude Code?

Run this command in your terminal: claude mcp add mcp-compliance -- npx -y @yawlabs/mcp-compliance

### What are the best alternatives to MCP Compliance?

The closest alternatives to MCP Compliance are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [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.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/mcp-compliance
