# Signalint

> Signalint is an open-source MCP server for developer tools. Grouped, prioritized JS/TS diagnostics for coding agents, run locally over stdio. 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://tranqui004.github.io/signalint-site
- **Repository:** https://github.com/tranqui004/signalint
- **MCP Registry name:** io.github.TranQui004/signalint
- **Categories:** developer tools
- **Listing updated:** 2026-11-15

## About

Instead of pasting thousands of raw compiler lines into an agent's context, Signalint reads the output of the engines your project already uses (Oxlint, tsc, Biome, ESLint) and returns bounded clusters ranked from P1 to P5. Repeated rules are grouped by scope, and full issue detail is fetched only when the agent asks for it.

The workflow is built around baselines. An agent saves a check, makes an edit, then compares the new result to see which diagnostics were introduced, resolved or left unchanged. A loop tracker flags fixes that keep oscillating, and the README says diagnostic checks are read-only by default, with patch application as a separate explicit operation.

The README describes 13 typed tools, monorepo-aware planning for pnpm workspaces, host hooks for Claude Code, Cursor, Codex and VS Code, and ingestion of diagnostics from LSP or other compilers. It needs Node 22.12 or later and does not bundle any engines, so your project must have its own installed.

## Features

- **Priority-ranked clusters:** Groups repeated rule hits and orders them from P1 to P5 so the agent starts with systemic errors.
- **Verification deltas:** Compares a baseline check with a later one and lists introduced, resolved and unchanged diagnostics.
- **Cached incremental checks:** Reuses results when the engine's cache key matches and checks only changed files.
- **Fix-loop detection:** Reports oscillating fix signatures and rule churn across a session.
- **Workspace planning:** Orders pnpm workspace packages topologically using manifests and TypeScript project references.
- **Staged patch apply:** Previews replacements in memory, then applies them with drift checks and best-effort rollback.

## Good for

- Shrink noisy lint and type-check output before it reaches a coding agent
- Confirm an edit fixed an error without introducing new ones
- Catch an agent repeatedly flipping the same lint rule
- Run verify-after-change hooks in Claude Code or Cursor
- Plan checks across a pnpm monorepo

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `ping`: Verifies the server responds and reports the canonical project root.
- `check_project`: Full project or workspace scan across all enabled engines.
- `check_files`: Incremental check of specific files using content-hash caching.
- `get_issue_detail`: Returns full issue records anchored to a check ID.
- `get_loop_status`: Reports oscillating fix signatures and rule churn in the session.
- `get_diagnostic_snapshot`: Retrieves state and metrics for an immutable check snapshot.
- `compare_diagnostics`: Computes the delta between a baseline check and a current check.
- `after_edit_check`: Checks edited files and diffs them against a baseline.
- `ingest_diagnostics`: Ingests external LSP or compiler diagnostics.

## FAQ

### Does it ship its own linters?

No. It detects the TypeScript, Oxlint, ESLint or Biome installs in your project and ships none of them.

### Which Node version does it need?

Node 22.12 or later, because it uses the built-in node:sqlite module.

### Does a check change my source files?

Diagnostic checks are read-only. Applying patches is a separate explicit operation.

### How do I add it to a client?

Add a stdio entry that runs npx -y signalint-mcp, or run npx signalint init to configure installed clients.

### Is Signalint free?

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

### How do I add Signalint to Claude Code?

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

### What are the best alternatives to Signalint?

The closest alternatives to Signalint 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/signalint
