# mcp-lint

> mcp-lint is an open-source MCP server for developer tools. Lint MCP tool schemas across eight clients and score how well agents recover from errors. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://mcp-lint-alpha.vercel.app
- **Repository:** https://github.com/robert19001-cmyk/mcp-lint
- **MCP Registry name:** io.github.robert19001-cmyk/mcp-lint
- **Categories:** developer tools
- **Listing updated:** 2026-11-15

## About

A schema can be valid JSON Schema and still break in one client or mislead an agent. mcp-lint runs shared rules plus client-specific ones for Claude, Cursor, Gemini, VS Code, Windsurf, Cline, OpenAI and Continue, and prints which tools survive in which client. Each cell in the compatibility matrix is marked measured or not observed, and a mark is not proof that a client accepts the schema.

Beyond linting, the CLI scores recorded failures to see whether an error tells the agent what to do next, and scores a proposed tool call against a policy file before it runs, returning allow, allow with rewrite, require approval or deny. Snapshots and diffs let CI fail when a later tool list adds an error. Reports can be written as terminal text, JSON, Markdown, SARIF 2.1.0 or a local HTML file.

A separate mcp-lint-server binary exposes rule listing, explain, check, fix, preflight and recovery scoring to an agent over stdio. The site is explicit about limits: Zed and OpenCode are not claimed, Windsurf and Cline config files are not scanned, and it does not call a tool to discover it.

## Features

- **Eight-client rules:** Checks schemas against Claude, Cursor, Gemini, VS Code, Windsurf, Cline, OpenAI and Continue.
- **Compatibility matrix:** Shows which tools pass in which client.
- **Safe auto-fix:** Writes only fixes classed safe; a dry run lists review and manual ones.
- **Recovery scoring:** Scores whether a recorded failure tells the agent what to do next.
- **Preflight policy check:** Scores a proposed call against a policy before it runs.
- **Snapshot and diff for CI:** Fails a build when a new tool list adds an error.
- **Installed config scan:** Lints servers configured in Cursor, Claude and VS Code.

## Good for

- Check a tools.json before publishing an MCP server
- Find which clients reject a schema
- Block schema regressions in CI
- Review a proposed destructive call against a policy
- Write a SARIF report for code scanning

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-lint -- npx -y mcp-lint
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-lint": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-lint"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-lint": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-lint"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp-lint": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-lint"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-lint": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-lint"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-lint": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-lint"
      ]
    }
  }
}
```

## FAQ

### How do I run it?

Use npx mcp-lint@1.0.4, or install it globally or as a dev dependency with npm.

### Does it call my tools?

Not to discover them. Recovery scoring calls a tool only when both --sandbox and --invoke are set.

### Which report formats exist?

Terminal, JSON, Markdown, SARIF 2.1.0 and an HTML file that stays on your machine.

### Which clients are not covered?

Zed and OpenCode are not claimed, and Windsurf and Cline config files are not scanned by --installed.

### Is mcp-lint free?

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

### How do I add mcp-lint to Claude Code?

Run this command in your terminal: claude mcp add mcp-lint -- npx -y mcp-lint

### What are the best alternatives to mcp-lint?

The closest alternatives to mcp-lint 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-lint
