Skip to main content
Glama

Signalint

CI npm version License: MIT Node.js

Signalint is a reliable, read-only-by-default diagnostic intelligence layer for AI coding agents (Claude Code, Cursor, Codex, VS Code) and CI workflows.

Instead of flooding an agent's context window with thousands of raw compiler lines, Signalint normalizes diagnostics across compilers, linters, and language servers into bounded, priority-clustered issue summaries, calculates verification deltas against explicit baselines, and detects oscillating fix loops.


Key Differentiators

  • 13 Complete MCP Tools: From incremental checks and immutable snapshots to live diagnostic ingestion and journaled transactional fix application.

  • Verification Deltas: Exact arithmetic on introduced, resolved, and unchanged diagnostics with semantic identity matching that survives line shifts.

  • Immutable Snapshots & Concurrency Safety: Isolated in-memory snapshot store keyed by checkId eliminates race collisions during concurrent checks.

  • Monorepo-Aware Planning: Unites package manifests (pnpm-workspace.yaml) parsed via pure-JS YAML with glob negation exclusions and TypeScript Project References, ordering checks topologically.

  • Multi-Source Provenance: Distinguishes compiler, linter, and editor/LSP diagnostics across JavaScript, TypeScript, Python (Ruff/Mypy), Rust (Clippy), and Go (GolangCI-Lint).

  • Portable Host Hooks: Native verify-after-change adapters for Claude Code, Cursor, Codex, and VS Code.

  • In-Memory Previews & In-Process Rollback: In-memory previews never touch disk; apply uses per-file adjacent temporary-file replacement, pre-write drift detection, and in-process best-effort rollback for multi-file writes (does not claim persistent crash recovery if aborted abruptly).


Related MCP server: agent-workspace-mcp

Quick Start

1. Requirements

  • Node.js >= 22.12.0 (utilizes native node:sqlite).

  • Your project installs its own diagnostic engines (typescript, oxlint, eslint, and/or @biomejs/biome). Signalint detects project-local installations and ships no bundled engines.

2. Initialize in your repository

npx signalint init

This detects your project's linters/compilers, generates signalint.config.json, and configures your installed MCP clients.

3. Add to MCP Clients

Add Signalint to your MCP configuration (e.g. claude_desktop_config.json, .cursor/mcp.json):

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

Complete MCP Tools Catalog

Signalint exposes 13 strictly typed MCP tools over stdio:

Tool

Category

Safety Annotation

Description

ping

Diagnostics

Read-only (idempotent)

Verifies server responsiveness and canonical project root path.

check_project

Diagnostics

Read-only (idempotent)

Full project/workspace scan across all enabled engines.

check_files

Diagnostics

Read-only (idempotent)

Fast incremental check on specific files using content-hash caching.

get_issue_detail

Diagnostics

Read-only (idempotent)

Retrieves full, unomitted issue records anchored to an immutable checkId.

get_loop_status

Diagnostics

Read-only (idempotent)

Returns oscillating fix signatures and rule churn detected in the session.

get_diagnostic_snapshot

Snapshots

Read-only (idempotent)

Retrieves complete state and metrics for an immutable check snapshot.

compare_diagnostics

Deltas

Read-only (idempotent)

Computes verification delta between a baseline check and a current check.

after_edit_check

Deltas

Read-only (idempotent)

Runs incremental check on edited files and diffs against a baseline check.

ingest_diagnostics

Live / LSP

Read-only (openWorld: false)

Ingests external LSP or compiler diagnostics into Signalint's clustering model.

get_live_diagnostics

Live / LSP

Read-only (idempotent)

Returns active buffered diagnostics with source provenance.

preview_diagnostic_fix

Transactions

Read-only (destructive: false)

Stages proposed code fixes in-memory. Does not write to disk.

apply_diagnostic_fix

Transactions

Mutating (destructive: true)

Per-file adjacent temp replacement, pre-write drift check, and in-process best-effort rollback.

discard_diagnostic_fix

Transactions

Read-only (idempotent)

Drops an in-memory fix transaction without touching disk.

See docs/mcp-contract.md for full JSON Schemas and error codes.


CLI Commands

Signalint includes a comprehensive command-line interface:

# Run a project diagnostic scan:
npx signalint check .
npx signalint check src/ --format github    # GitHub Actions annotations

# View session statistics and cache economics:
npx signalint stats

# Verify local engine availability and configuration:
npx signalint doctor

# Manage host verify-after-change hooks:
npx signalint hooks preview --runtime claude
npx signalint hooks install --runtime cursor --confirm
npx signalint hooks run --runtime claude --payload '<json-event>'

Monorepo Support

Signalint natively understands multi-package monorepos:

  • Configure "monorepoMode": "auto" in signalint.config.json to detect pnpm-workspace.yaml via pure-JS YAML parsing with glob negation exclusions (!).

  • Strictly differentiates local workspace packages (workspace:*) from external npm registry dependencies.

  • Builds a topological dependency graph uniting package manifests and TypeScript project references.

  • Caches whole-program TypeScript builds in isolated per-package directories (.signalint/cache/tsc/<project-id>/).

  • Changes to a shared package automatically invalidate dependent packages while keeping independent siblings cached.

See docs/monorepo.md for configuration and architecture.


Verify-After-Change Hooks

Automate post-edit verification without creating infinite agent loops:

  • Native adapters for Claude Code, Cursor, Codex, and VS Code.

  • Emits bounded context into prompt windows and blocks only on unresolved syntax/type errors.

See docs/hooks.md for setup instructions.


Documentation Index


License

MIT © 2026 Tran Trong Qui

Available Tools

13 tools
after_edit_check
Read-onlyIdempotent

Runs incremental diagnostics on specified edited files and computes a verification delta against an optional baselineCheckId. Read-only; no files are written or modified. Use this after modifying files to verify whether edits introduced or resolved diagnostics relative to the baseline check.

ParametersJSON Schema
NameRequiredDescriptionDefault
filesYes
baselineCheckIdNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
codeNo
deltaNo
engineNo
statusYes
checkIdNo
enginesNo
messageNo
clustersNo
nextStepNo
retryableNo
truncatedNo
loopWarningNo
projectRootNo
totalIssuesNo
schemaVersionNo
remainingIssuesNo
filteredOutCountNo
omittedIssueCountNo
fileRuleChurnWarningNo
filteredOutIssueCountNo
apply_diagnostic_fix
Destructive

Applies diagnostic modifications using per-file adjacent temporary-file replacement, pre-write drift detection, and in-process best-effort rollback for multi-file writes. Requires explicit confirm: true. If baselineCheckId is provided, it must be valid and active in the snapshot store; unknown or expired baselines abort immediately without modifying files. Does not provide persistent crash recovery if the process terminates abruptly.

ParametersJSON Schema
NameRequiredDescriptionDefault
confirmYes
transactionIdYes
baselineCheckIdNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
codeNo
deltaNo
errorNo
statusYes
messageNo
postCheckIdNo
filesModifiedYes
transactionIdYes
check_files
Read-onlyIdempotent

Runs Oxlint and TypeScript (and optionally Biome) lint and type diagnostics on a specific list of files, using per-engine content-hash caching to skip unchanged files. Read-only; no files are written or modified. Use this for incremental checks after editing specific files; use check_project for a full project scan. The files parameter expects relative file paths (not glob patterns) within the project directory — absolute paths or paths outside the root return an error response. Caching is file-content-hash-based: a file is re-checked only when its content or the engine's config file (e.g., .oxlintrc, tsconfig.json) has changed since the last call, not based on git status. TypeScript is a whole-program engine: it re-runs whenever any TypeScript file in the request has changed content.

ParametersJSON Schema
NameRequiredDescriptionDefault
filesYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
codeNo
engineNo
statusYes
checkIdNo
enginesNo
messageNo
clustersNo
nextStepNo
retryableNo
truncatedNo
filteredOutNo
loopWarningNo
projectRootNo
totalIssuesNo
schemaVersionNo
remainingIssuesNo
filteredOutCountNo
omittedIssueCountNo
fileRuleChurnWarningNo
filteredOutIssueCountNo
check_project
Read-onlyIdempotent

Runs and clusters Oxlint and TypeScript (and optionally Biome) lint and type diagnostics for one or more project paths. Read-only; no files are written or modified. Paths default to the project root (".") when omitted; paths must be relative and within the project directory — absolute paths or paths outside the root return an error response. Use this for a full project scan; use check_files instead for faster incremental checks after editing specific files. Each call re-runs all enabled engines with no caching.

ParametersJSON Schema
NameRequiredDescriptionDefault
pathsNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
codeNo
engineNo
statusYes
checkIdNo
enginesNo
messageNo
clustersNo
nextStepNo
retryableNo
truncatedNo
filteredOutNo
loopWarningNo
projectRootNo
totalIssuesNo
schemaVersionNo
remainingIssuesNo
filteredOutCountNo
omittedIssueCountNo
fileRuleChurnWarningNo
filteredOutIssueCountNo
compare_diagnostics
Read-onlyIdempotent

Computes a deterministic diagnostic delta between two checks (baselineCheckId and currentCheckId). Read-only; no files are modified. Identifies introduced errors, resolved errors, unchanged issues, and net error delta, resilient to line shifts.

ParametersJSON Schema
NameRequiredDescriptionDefault
currentCheckIdYes
baselineCheckIdYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
codeNo
statusYes
messageNo
netDeltaNo
nextStepNo
currentIdNo
baselineIdNo
currentCheckIdNo
errorsResolvedNo
resolvedIssuesNo
baselineCheckIdNo
unchangedIssuesNo
errorsIntroducedNo
introducedIssuesNo
discard_diagnostic_fix
Idempotent

Discards an in-memory diagnostic fix preview by transactionId, dropping it from server storage.

ParametersJSON Schema
NameRequiredDescriptionDefault
transactionIdYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
discardedYes
transactionIdYes
get_diagnostic_snapshot
Read-onlyIdempotent

Retrieves the immutable diagnostic snapshot recorded for a specific checkId. Read-only; no files are modified. Returns full metadata, engine statuses, clusters, remaining issues, and performance metrics for that check run.

ParametersJSON Schema
NameRequiredDescriptionDefault
checkIdYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
codeNo
cacheNo
sourceNo
statusYes
checkIdNo
enginesNo
messageNo
clustersNo
timestampNo
durationMsNo
projectRootNo
totalIssuesNo
remainingIssuesNo
omittedIssueCountNo
filteredOutIssueCountNo
get_issue_detail
Read-onlyIdempotent

Returns the full issue list for either one cluster ID or one issue ID for a specific checkId. Read-only; no files are written or modified. Supply checkId (required) and exactly one of clusterId or issueId — supplying both or neither returns an argument error. If the referenced checkId is unknown/expired or the issue/cluster no longer exists in that check snapshot, returns a status: "stale" response instead of an error.

ParametersJSON Schema
NameRequiredDescriptionDefault
checkIdYes
issueIdNo
clusterIdNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
codeNo
issuesNo
statusNo
messageNo
projectRootNo
get_live_diagnostics
Read-onlyIdempotent

Returns current bounded active diagnostics and clusters merged from both internal engines and ingested LSP sources, with clear provenance per issue.

ParametersJSON Schema
NameRequiredDescriptionDefault
filesNo
severityNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
issuesNo
statusYes
clustersYes
totalIssuesYes
remainingIssuesNo
get_loop_statusA
Read-onlyIdempotent

Returns all diagnostic issue signatures currently flagged as looping (repeatedly appearing and disappearing) in this server session. Read-only; no files are written or modified. Loop history is accumulated across all check_project and check_files calls in this process lifetime, and is restored from .signalint/session.jsonl on startup. Takes no parameters. Use this to identify which diagnostics an agent is oscillating on; use check_project or check_files to run fresh diagnostics.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
loopingYes
signaturesYes
fileChurningYes
fileRuleChurnsYes

TDQS

A4.9/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Although annotations already declare readOnly, idempotent, and non-destructive behavior, the description adds state-lifecycle context: loop history accumulates across all check_project and check_files calls and is restored from .signalint/session.jsonl on startup. It also confirms 'no files are written or modified,' which clarifies what the read-only hint actually guarantees.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is tight and efficient: it opens with the return value and risk guarantee, then gives state lifecycle, parameter count, and usage routing. Every sentence adds useful signal and no filler is present.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given that the tool has no parameters, has an output schema, and conveys read-only behavior through annotations, the description is complete. It also clarifies how data is aggregated across sibling calls, how it is restored from session storage, and when to choose alternative tools.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has 0 parameters, so the baseline is 4. The description explicitly says 'Takes no parameters' and the schema confirms an empty object with no additional properties. There is nothing further needed.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource: 'Returns all diagnostic issue signatures currently flagged as looping' and defines looping as repeatedly appearing and disappearing. It also distinguishes the tool from siblings like check_project and check_files by positioning it as the accumulated-history view rather than a fresh diagnostic runner.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It explicitly tells agents when to use it: 'identify which diagnostics an agent is oscillating on.' It also names the alternatives for fresh diagnostics: 'use check_project or check_files to run fresh diagnostics.' This is clear, direct usage guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

ingest_diagnostics
Read-onlyIdempotent

Ingests external LSP diagnostics (e.g., from VS Code or language servers), normalizes them to Signalint's unified schema, updates the active diagnostic buffer, and records an immutable snapshot.

ParametersJSON Schema
NameRequiredDescriptionDefault
sourceNo
serverNameNo
diagnosticsYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
checkIdNo
clustersYes
snapshotIdYes
totalIssuesYes
remainingIssuesNo
pingA
Read-onlyIdempotent

Checks whether the Signalint MCP server is responsive. Read-only; returns the string "pong" with no side effects. Use this to verify the server is connected before running diagnostics. Invalid arguments return an error response; no authentication is required.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
pongYesTrue when the server is responsive.
projectRootYesCanonical absolute project root path.

TDQS

A4.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly, idempotent, non-destructive, and closed-world, so the safety profile is covered. The description adds genuinely new behavior: the literal return string 'pong', the error behavior on invalid arguments, and the no-authentication requirement, which is not captured by any structured field.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three short sentences, front-loaded with the purpose before the usage hint and the operational caveats. The 'read-only... no side effects' clause partly restates the readOnlyHint/destructiveHint annotations, but the redundancy is minor and the whole entry is tight.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a zero-parameter health check with an output schema, everything an agent needs is present: what it returns, that no auth is required, and how errors surface. No gaps remain that would affect a correct invocation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool takes zero parameters, so the baseline is 4 and there is no parameter semantics to explain beyond the note that invalid arguments produce an error response.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Checks whether the Signalint MCP server is responsive') and is immediately distinguishable from the domain-specific siblings (check_project, check_files, get_loop_status), which test application state rather than connectivity. An agent can tell this is the generic server liveness probe without opening the schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly names the use case: 'Use this to verify the server is connected before running diagnostics.' It gives clear context for when to reach for it, though it does not state when not to use it or contrast it against the sibling check_* tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

preview_diagnostic_fix
Read-only

Creates an in-memory preview of proposed diagnostic fixes without touching the filesystem. Validates paths against canonical project root containment and returns a preview with a unique transactionId.

ParametersJSON Schema
NameRequiredDescriptionDefault
patchesYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
errorNo
statusYes
summaryYes
filesCountYes
transactionIdYes
patchesPreviewNo

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 11 tool updatesv1.0.1
    • Addedafter_edit_check
    • Addedapply_diagnostic_fix
    • Changedcheck_files15 fields changed
      • addedOutput schema / additionalProperties
        Added value: +false
      • changedOutput schema / properties / clusters / items / required
        Previous value: -[
        -  "clusterId",
        -  "rootCauseSummary",
        -  "ruleIds",
        -  "issueCount",
        -  "fileCount",
        -  "priority",
        -  "suggestedAction",
        -  "sampleIssueIds"
        -]New value: +[
        +  "clusterId",
        +  "rootCauseSummary",
        +  "ruleIds",
        +  "issueCount",
        +  "fileCount",
        +  "priority"
        +]
      • changedOutput schema / properties / engine / enum
        Previous value: -[
        -  "oxlint",
        -  "tsc",
        -  "biome",
        -  "eslint"
        -]New value: +[
        +  "oxlint",
        +  "tsc",
        +  "biome",
        +  "eslint",
        +  "external-lsp",
        +  "vscode",
        +  "all"
        +]
      • addedOutput schema / properties / engines / properties / external-lsp
        Added value: +{
        +  "additionalProperties": false,
        +  "properties": {
        +    "message": {
        +      "type": "string"
        +    },
        +    "status": {
        +      "enum": [
        +        "ok",
        +        "error",
        +        "disabled"
        +      ],
        +      "type": "string"
        +    }
        +  },
        +  "required": [
        +    "status"
        +  ],
        +  "type": "object"
        +}
      • addedOutput schema / properties / engines / properties / vscode
        Added value: +{
        +  "additionalProperties": false,
        +  "properties": {
        +    "message": {
        +      "type": "string"
        +    },
        +    "status": {
        +      "enum": [
        +        "ok",
        +        "error",
        +        "disabled"
        +      ],
        +      "type": "string"
        +    }
        +  },
        +  "required": [
        +    "status"
        +  ],
        +  "type": "object"
        +}
      • removedOutput schema / properties / engines / required
        Removed value: -[
        -  "oxlint",
        -  "tsc",
        -  "biome",
        -  "eslint"
        -]
      • addedOutput schema / properties / filteredOut
        Added value: +{
        +  "type": "integer"
        +}
      • addedOutput schema / properties / filteredOutCount
        Added value: +{
        +  "type": "integer"
        +}
      • addedOutput schema / properties / filteredOutIssueCount
        Added value: +{
        +  "type": "integer"
        +}
      • addedOutput schema / properties / nextStep
        Added value: +{
        +  "type": "string"
        +}
      • addedOutput schema / properties / omittedIssueCount
        Added value: +{
        +  "type": "integer"
        +}
      • addedOutput schema / properties / remainingIssues
        Added value: +{
        +  "items": {
        +    "additionalProperties": false,
        +    "properties": {
        +      "col": {
        +        "type": "integer"
        +      },
        +      "file": {
        +        "type": "string"
        +      },
        +      "fixable": {
        +        "type": "boolean"
        +      },
        +      "issueId": {
        +        "type": "string"
        +      },
        +      "line": {
        +        "type": "integer"
        +      },
        +      "priority": {
        +        "type": "integer"
        +      },
        +      "rule": {
        +        "type": "string"
        +      },
        +      "severity": {
        +        "enum": [
        +          "error",
        +          "warning"
        +        ],
        +        "type": "string"
        +      }
        +    },
        +    "required": [
        +      "issueId",
        +      "file",
        +      "line",
        +      "col",
        +      "rule",
        +      "severity",
        +      "fixable"
        +    ],
        +    "type": "object"
        +  },
        +  "type": "array"
        +}
      • addedOutput schema / properties / retryable
        Added value: +{
        +  "type": "boolean"
        +}
      • changedOutput schema / properties / schemaVersion / enum
        Previous value: -[
        -  "1.3"
        -]New value: +[
        +  "1.3",
        +  "1.4"
        +]
      • changedOutput schema / properties / status / enum
        Previous value: -[
        -  "clean",
        -  "issues_found",
        -  "error"
        -]New value: +[
        +  "clean",
        +  "issues_found",
        +  "error",
        +  "stale"
        +]
    • Changedcheck_project15 fields changed
      • addedOutput schema / additionalProperties
        Added value: +false
      • changedOutput schema / properties / clusters / items / required
        Previous value: -[
        -  "clusterId",
        -  "rootCauseSummary",
        -  "ruleIds",
        -  "issueCount",
        -  "fileCount",
        -  "priority",
        -  "suggestedAction",
        -  "sampleIssueIds"
        -]New value: +[
        +  "clusterId",
        +  "rootCauseSummary",
        +  "ruleIds",
        +  "issueCount",
        +  "fileCount",
        +  "priority"
        +]
      • changedOutput schema / properties / engine / enum
        Previous value: -[
        -  "oxlint",
        -  "tsc",
        -  "biome",
        -  "eslint"
        -]New value: +[
        +  "oxlint",
        +  "tsc",
        +  "biome",
        +  "eslint",
        +  "external-lsp",
        +  "vscode",
        +  "all"
        +]
      • addedOutput schema / properties / engines / properties / external-lsp
        Added value: +{
        +  "additionalProperties": false,
        +  "properties": {
        +    "message": {
        +      "type": "string"
        +    },
        +    "status": {
        +      "enum": [
        +        "ok",
        +        "error",
        +        "disabled"
        +      ],
        +      "type": "string"
        +    }
        +  },
        +  "required": [
        +    "status"
        +  ],
        +  "type": "object"
        +}
      • addedOutput schema / properties / engines / properties / vscode
        Added value: +{
        +  "additionalProperties": false,
        +  "properties": {
        +    "message": {
        +      "type": "string"
        +    },
        +    "status": {
        +      "enum": [
        +        "ok",
        +        "error",
        +        "disabled"
        +      ],
        +      "type": "string"
        +    }
        +  },
        +  "required": [
        +    "status"
        +  ],
        +  "type": "object"
        +}
      • removedOutput schema / properties / engines / required
        Removed value: -[
        -  "oxlint",
        -  "tsc",
        -  "biome",
        -  "eslint"
        -]
      • addedOutput schema / properties / filteredOut
        Added value: +{
        +  "type": "integer"
        +}
      • addedOutput schema / properties / filteredOutCount
        Added value: +{
        +  "type": "integer"
        +}
      • addedOutput schema / properties / filteredOutIssueCount
        Added value: +{
        +  "type": "integer"
        +}
      • addedOutput schema / properties / nextStep
        Added value: +{
        +  "type": "string"
        +}
      • addedOutput schema / properties / omittedIssueCount
        Added value: +{
        +  "type": "integer"
        +}
      • addedOutput schema / properties / remainingIssues
        Added value: +{
        +  "items": {
        +    "additionalProperties": false,
        +    "properties": {
        +      "col": {
        +        "type": "integer"
        +      },
        +      "file": {
        +        "type": "string"
        +      },
        +      "fixable": {
        +        "type": "boolean"
        +      },
        +      "issueId": {
        +        "type": "string"
        +      },
        +      "line": {
        +        "type": "integer"
        +      },
        +      "priority": {
        +        "type": "integer"
        +      },
        +      "rule": {
        +        "type": "string"
        +      },
        +      "severity": {
        +        "enum": [
        +          "error",
        +          "warning"
        +        ],
        +        "type": "string"
        +      }
        +    },
        +    "required": [
        +      "issueId",
        +      "file",
        +      "line",
        +      "col",
        +      "rule",
        +      "severity",
        +      "fixable"
        +    ],
        +    "type": "object"
        +  },
        +  "type": "array"
        +}
      • addedOutput schema / properties / retryable
        Added value: +{
        +  "type": "boolean"
        +}
      • changedOutput schema / properties / schemaVersion / enum
        Previous value: -[
        -  "1.3"
        -]New value: +[
        +  "1.3",
        +  "1.4"
        +]
      • changedOutput schema / properties / status / enum
        Previous value: -[
        -  "clean",
        -  "issues_found",
        -  "error"
        -]New value: +[
        +  "clean",
        +  "issues_found",
        +  "error",
        +  "stale"
        +]
    • Addedcompare_diagnostics
    • Addeddiscard_diagnostic_fix
    • Addedget_diagnostic_snapshot
    • Changedget_issue_detail7 fields changed
      • addedInput schema / required
        Added value: +[
        +  "checkId"
        +]
      • addedOutput schema / additionalProperties
        Added value: +false
      • changedOutput schema / properties / issues / items / properties / engine / enum
        Previous value: -[
        -  "oxlint",
        -  "tsc",
        -  "biome",
        -  "eslint"
        -]New value: +[
        +  "oxlint",
        +  "tsc",
        +  "biome",
        +  "eslint",
        +  "external-lsp",
        +  "vscode"
        +]
      • addedOutput schema / properties / issues / items / properties / provenance
        Added value: +{
        +  "additionalProperties": false,
        +  "properties": {
        +    "engine": {
        +      "enum": [
        +        "oxlint",
        +        "tsc",
        +        "biome",
        +        "eslint",
        +        "external-lsp",
        +        "vscode"
        +      ],
        +      "type": "string"
        +    },
        +    "kind": {
        +      "enum": [
        +        "compiler",
        +        "linter",
        +        "lsp",
        +        "editor"
        +      ],
        +      "type": "string"
        +    },
        +    "serverName": {
        +      "type": "string"
        +    },
        +    "timestamp": {
        +      "type": "integer"
        +    }
        +  },
        +  "required": [
        +    "kind",
        +    "engine",
        +    "timestamp"
        +  ],
        +  "type": "object"
        +}
      • addedOutput schema / properties / issues / items / properties / serverName
        Added value: +{
        +  "type": "string"
        +}
      • addedOutput schema / properties / issues / items / properties / sourceKind
        Added value: +{
        +  "enum": [
        +    "compiler",
        +    "linter",
        +    "lsp",
        +    "editor"
        +  ],
        +  "type": "string"
        +}
      • addedOutput schema / properties / projectRoot
        Added value: +{
        +  "type": "string"
        +}
    • Addedget_live_diagnostics
    • Addedingest_diagnostics
    • Addedpreview_diagnostic_fix
  2. 4 tool updatesv1.0.0
    • Changedcheck_files7 fields changed
      • addedOutput schema / properties / checkId
        Added value: +{
        +  "type": "string"
        +}
      • changedOutput schema / properties / engine / enum
        Previous value: -[
        -  "oxlint",
        -  "tsc",
        -  "biome"
        -]New value: +[
        +  "oxlint",
        +  "tsc",
        +  "biome",
        +  "eslint"
        +]
      • addedOutput schema / properties / engines / properties / eslint
        Added value: +{
        +  "additionalProperties": false,
        +  "properties": {
        +    "message": {
        +      "type": "string"
        +    },
        +    "status": {
        +      "enum": [
        +        "ok",
        +        "error",
        +        "disabled"
        +      ],
        +      "type": "string"
        +    }
        +  },
        +  "required": [
        +    "status"
        +  ],
        +  "type": "object"
        +}
      • changedOutput schema / properties / engines / required
        Previous value: -[
        -  "oxlint",
        -  "tsc",
        -  "biome"
        -]New value: +[
        +  "oxlint",
        +  "tsc",
        +  "biome",
        +  "eslint"
        +]
      • addedOutput schema / properties / projectRoot
        Added value: +{
        +  "type": "string"
        +}
      • changedOutput schema / properties / schemaVersion / enum
        Previous value: -[
        -  "1.2"
        -]New value: +[
        +  "1.3"
        +]
      • changedOutput schema / properties / status / enum
        Previous value: -[
        -  "clean",
        -  "issues_found",
        -  "timeout",
        -  "error"
        -]New value: +[
        +  "clean",
        +  "issues_found",
        +  "error"
        +]
    • Changedcheck_project7 fields changed
      • addedOutput schema / properties / checkId
        Added value: +{
        +  "type": "string"
        +}
      • changedOutput schema / properties / engine / enum
        Previous value: -[
        -  "oxlint",
        -  "tsc",
        -  "biome"
        -]New value: +[
        +  "oxlint",
        +  "tsc",
        +  "biome",
        +  "eslint"
        +]
      • addedOutput schema / properties / engines / properties / eslint
        Added value: +{
        +  "additionalProperties": false,
        +  "properties": {
        +    "message": {
        +      "type": "string"
        +    },
        +    "status": {
        +      "enum": [
        +        "ok",
        +        "error",
        +        "disabled"
        +      ],
        +      "type": "string"
        +    }
        +  },
        +  "required": [
        +    "status"
        +  ],
        +  "type": "object"
        +}
      • changedOutput schema / properties / engines / required
        Previous value: -[
        -  "oxlint",
        -  "tsc",
        -  "biome"
        -]New value: +[
        +  "oxlint",
        +  "tsc",
        +  "biome",
        +  "eslint"
        +]
      • addedOutput schema / properties / projectRoot
        Added value: +{
        +  "type": "string"
        +}
      • changedOutput schema / properties / schemaVersion / enum
        Previous value: -[
        -  "1.2"
        -]New value: +[
        +  "1.3"
        +]
      • changedOutput schema / properties / status / enum
        Previous value: -[
        -  "clean",
        -  "issues_found",
        -  "timeout",
        -  "error"
        -]New value: +[
        +  "clean",
        +  "issues_found",
        +  "error"
        +]
    • Changedget_issue_detail2 fields changed
      • addedInput schema / properties / checkId
        Added value: +{
        +  "type": "string"
        +}
      • changedOutput schema / properties / issues / items / properties / engine / enum
        Previous value: -[
        -  "oxlint",
        -  "tsc",
        -  "biome"
        -]New value: +[
        +  "oxlint",
        +  "tsc",
        +  "biome",
        +  "eslint"
        +]
    • Changedping2 fields changed
      • addedOutput schema / properties / projectRoot
        Added value: +{
        +  "description": "Canonical absolute project root path.",
        +  "type": "string"
        +}
      • changedOutput schema / required
        Previous value: -[
        -  "pong"
        -]New value: +[
        +  "pong",
        +  "projectRoot"
        +]
  3. 3 tool updatesv0.4.0
    • Changedcheck_files2 fields changed
      • addedOutput schema / properties / fileRuleChurnWarning
        Added value: +{
        +  "oneOf": [
        +    {
        +      "additionalProperties": false,
        +      "properties": {
        +        "checkCount": {
        +          "type": "integer"
        +        },
        +        "file": {
        +          "type": "string"
        +        },
        +        "hint": {
        +          "type": "string"
        +        },
        +        "rule": {
        +          "type": "string"
        +        }
        +      },
        +      "required": [
        +        "file",
        +        "rule",
        +        "checkCount",
        +        "hint"
        +      ],
        +      "type": "object"
        +    },
        +    {
        +      "type": "null"
        +    }
        +  ]
        +}
      • changedOutput schema / properties / schemaVersion / enum
        Previous value: -[
        -  "1.1"
        -]New value: +[
        +  "1.2"
        +]
    • Changedcheck_project2 fields changed
      • addedOutput schema / properties / fileRuleChurnWarning
        Added value: +{
        +  "oneOf": [
        +    {
        +      "additionalProperties": false,
        +      "properties": {
        +        "checkCount": {
        +          "type": "integer"
        +        },
        +        "file": {
        +          "type": "string"
        +        },
        +        "hint": {
        +          "type": "string"
        +        },
        +        "rule": {
        +          "type": "string"
        +        }
        +      },
        +      "required": [
        +        "file",
        +        "rule",
        +        "checkCount",
        +        "hint"
        +      ],
        +      "type": "object"
        +    },
        +    {
        +      "type": "null"
        +    }
        +  ]
        +}
      • changedOutput schema / properties / schemaVersion / enum
        Previous value: -[
        -  "1.1"
        -]New value: +[
        +  "1.2"
        +]
    • Changedget_loop_status3 fields changed
      • addedOutput schema / properties / fileChurning
        Added value: +{
        +  "type": "boolean"
        +}
      • addedOutput schema / properties / fileRuleChurns
        Added value: +{
        +  "items": {
        +    "additionalProperties": false,
        +    "properties": {
        +      "checkCount": {
        +        "type": "integer"
        +      },
        +      "file": {
        +        "type": "string"
        +      },
        +      "hint": {
        +        "type": "string"
        +      },
        +      "rule": {
        +        "type": "string"
        +      }
        +    },
        +    "required": [
        +      "file",
        +      "rule",
        +      "checkCount",
        +      "hint"
        +    ],
        +    "type": "object"
        +  },
        +  "type": "array"
        +}
      • changedOutput schema / required
        Previous value: -[
        -  "looping",
        -  "signatures"
        -]New value: +[
        +  "looping",
        +  "signatures",
        +  "fileChurning",
        +  "fileRuleChurns"
        +]
  4. 5 tool updatesv0.3.7
    • Changedcheck_files1 field changed
      • changedOutput schema / (root)
        Previous value: -nullNew value: +{
        +  "properties": {
        +    "clusters": {
        +      "items": {
        +        "additionalProperties": false,
        +        "properties": {
        +          "clusterId": {
        +            "type": "string"
        +          },
        +          "fileCount": {
        +            "type": "integer"
        +          },
        +          "issueCount": {
        +            "type": "integer"
        +          },
        +          "priority": {
        +            "type": "integer"
        +          },
        +          "rootCauseSummary": {
        +            "type": "string"
        +          },
        +          "ruleIds": {
        +            "items": {
        +              "type": "string"
        +            },
        +            "type": "array"
        +          },
        +          "sampleIssueIds": {
        +            "items": {
        +              "type": "string"
        +            },
        +            "type": "array"
        +          },
        +          "suggestedAction": {
        +            "type": "string"
        +          }
        +        },
        +        "required": [
        +          "clusterId",
        +          "rootCauseSummary",
        +          "ruleIds",
        +          "issueCount",
        +          "fileCount",
        +          "priority",
        +          "suggestedAction",
        +          "sampleIssueIds"
        +        ],
        +        "type": "object"
        +      },
        +      "type": "array"
        +    },
        +    "code": {
        +      "type": "string"
        +    },
        +    "engine": {
        +      "enum": [
        +        "oxlint",
        +        "tsc",
        +        "biome"
        +      ],
        +      "type": "string"
        +    },
        +    "engines": {
        +      "additionalProperties": false,
        +      "properties": {
        +        "biome": {
        +          "additionalProperties": false,
        +          "properties": {
        +            "message": {
        +              "type": "string"
        +            },
        +            "status": {
        +              "enum": [
        +                "ok",
        +                "error",
        +                "disabled"
        +              ],
        +              "type": "string"
        +            }
        +          },
        +          "required": [
        +            "status"
        +          ],
        +          "type": "object"
        +        },
        +        "oxlint": {
        +          "additionalProperties": false,
        +          "properties": {
        +            "message": {
        +              "type": "string"
        +            },
        +            "status": {
        +              "enum": [
        +                "ok",
        +                "error",
        +                "disabled"
        +              ],
        +              "type": "string"
        +            }
        +          },
        +          "required": [
        +            "status"
        +          ],
        +          "type": "object"
        +        },
        +        "tsc": {
        +          "additionalProperties": false,
        +          "properties": {
        +            "message": {
        +              "type": "string"
        +            },
        +            "status": {
        +              "enum": [
        +                "ok",
        +                "error",
        +                "disabled"
        +              ],
        +              "type": "string"
        +            }
        +          },
        +          "required": [
        +            "status"
        +          ],
        +          "type": "object"
        +        }
        +      },
        +      "required": [
        +        "oxlint",
        +        "tsc",
        +        "biome"
        +      ],
        +      "type": "object"
        +    },
        +    "loopWarning": {
        +      "oneOf": [
        +        {
        +          "additionalProperties": false,
        +          "properties": {
        +            "hint": {
        +              "type": "string"
        +            },
        +            "occurrences": {
        +              "type": "integer"
        +            },
        +            "signature": {
        +              "type": "string"
        +            }
        +          },
        +          "required": [
        +            "signature",
        +            "occurrences",
        +            "hint"
        +          ],
        +          "type": "object"
        +        },
        +        {
        +          "type": "null"
        +        }
        +      ]
        +    },
        +    "message": {
        +      "type": "string"
        +    },
        +    "schemaVersion": {
        +      "enum": [
        +        "1.1"
        +      ],
        +      "type": "string"
        +    },
        +    "status": {
        +      "enum": [
        +        "clean",
        +        "issues_found",
        +        "timeout",
        +        "error"
        +      ],
        +      "type": "string"
        +    },
        +    "totalIssues": {
        +      "type": "integer"
        +    },
        +    "truncated": {
        +      "type": "boolean"
        +    }
        +  },
        +  "required": [
        +    "status"
        +  ],
        +  "type": "object"
        +}
    • Changedcheck_project1 field changed
      • changedOutput schema / (root)
        Previous value: -nullNew value: +{
        +  "properties": {
        +    "clusters": {
        +      "items": {
        +        "additionalProperties": false,
        +        "properties": {
        +          "clusterId": {
        +            "type": "string"
        +          },
        +          "fileCount": {
        +            "type": "integer"
        +          },
        +          "issueCount": {
        +            "type": "integer"
        +          },
        +          "priority": {
        +            "type": "integer"
        +          },
        +          "rootCauseSummary": {
        +            "type": "string"
        +          },
        +          "ruleIds": {
        +            "items": {
        +              "type": "string"
        +            },
        +            "type": "array"
        +          },
        +          "sampleIssueIds": {
        +            "items": {
        +              "type": "string"
        +            },
        +            "type": "array"
        +          },
        +          "suggestedAction": {
        +            "type": "string"
        +          }
        +        },
        +        "required": [
        +          "clusterId",
        +          "rootCauseSummary",
        +          "ruleIds",
        +          "issueCount",
        +          "fileCount",
        +          "priority",
        +          "suggestedAction",
        +          "sampleIssueIds"
        +        ],
        +        "type": "object"
        +      },
        +      "type": "array"
        +    },
        +    "code": {
        +      "type": "string"
        +    },
        +    "engine": {
        +      "enum": [
        +        "oxlint",
        +        "tsc",
        +        "biome"
        +      ],
        +      "type": "string"
        +    },
        +    "engines": {
        +      "additionalProperties": false,
        +      "properties": {
        +        "biome": {
        +          "additionalProperties": false,
        +          "properties": {
        +            "message": {
        +              "type": "string"
        +            },
        +            "status": {
        +              "enum": [
        +                "ok",
        +                "error",
        +                "disabled"
        +              ],
        +              "type": "string"
        +            }
        +          },
        +          "required": [
        +            "status"
        +          ],
        +          "type": "object"
        +        },
        +        "oxlint": {
        +          "additionalProperties": false,
        +          "properties": {
        +            "message": {
        +              "type": "string"
        +            },
        +            "status": {
        +              "enum": [
        +                "ok",
        +                "error",
        +                "disabled"
        +              ],
        +              "type": "string"
        +            }
        +          },
        +          "required": [
        +            "status"
        +          ],
        +          "type": "object"
        +        },
        +        "tsc": {
        +          "additionalProperties": false,
        +          "properties": {
        +            "message": {
        +              "type": "string"
        +            },
        +            "status": {
        +              "enum": [
        +                "ok",
        +                "error",
        +                "disabled"
        +              ],
        +              "type": "string"
        +            }
        +          },
        +          "required": [
        +            "status"
        +          ],
        +          "type": "object"
        +        }
        +      },
        +      "required": [
        +        "oxlint",
        +        "tsc",
        +        "biome"
        +      ],
        +      "type": "object"
        +    },
        +    "loopWarning": {
        +      "oneOf": [
        +        {
        +          "additionalProperties": false,
        +          "properties": {
        +            "hint": {
        +              "type": "string"
        +            },
        +            "occurrences": {
        +              "type": "integer"
        +            },
        +            "signature": {
        +              "type": "string"
        +            }
        +          },
        +          "required": [
        +            "signature",
        +            "occurrences",
        +            "hint"
        +          ],
        +          "type": "object"
        +        },
        +        {
        +          "type": "null"
        +        }
        +      ]
        +    },
        +    "message": {
        +      "type": "string"
        +    },
        +    "schemaVersion": {
        +      "enum": [
        +        "1.1"
        +      ],
        +      "type": "string"
        +    },
        +    "status": {
        +      "enum": [
        +        "clean",
        +        "issues_found",
        +        "timeout",
        +        "error"
        +      ],
        +      "type": "string"
        +    },
        +    "totalIssues": {
        +      "type": "integer"
        +    },
        +    "truncated": {
        +      "type": "boolean"
        +    }
        +  },
        +  "required": [
        +    "status"
        +  ],
        +  "type": "object"
        +}
    • Changedget_issue_detail1 field changed
      • changedOutput schema / (root)
        Previous value: -nullNew value: +{
        +  "properties": {
        +    "code": {
        +      "type": "string"
        +    },
        +    "issues": {
        +      "items": {
        +        "additionalProperties": false,
        +        "properties": {
        +          "clusterId": {
        +            "type": "string"
        +          },
        +          "col": {
        +            "type": "integer"
        +          },
        +          "engine": {
        +            "enum": [
        +              "oxlint",
        +              "tsc",
        +              "biome"
        +            ],
        +            "type": "string"
        +          },
        +          "file": {
        +            "type": "string"
        +          },
        +          "fixable": {
        +            "type": "boolean"
        +          },
        +          "issueId": {
        +            "type": "string"
        +          },
        +          "line": {
        +            "type": "integer"
        +          },
        +          "message": {
        +            "type": "string"
        +          },
        +          "rule": {
        +            "type": "string"
        +          },
        +          "severity": {
        +            "enum": [
        +              "error",
        +              "warning"
        +            ],
        +            "type": "string"
        +          }
        +        },
        +        "required": [
        +          "issueId",
        +          "file",
        +          "line",
        +          "col",
        +          "engine",
        +          "rule",
        +          "severity",
        +          "message",
        +          "fixable"
        +        ],
        +        "type": "object"
        +      },
        +      "type": "array"
        +    },
        +    "message": {
        +      "type": "string"
        +    },
        +    "status": {
        +      "enum": [
        +        "stale",
        +        "error"
        +      ],
        +      "type": "string"
        +    }
        +  },
        +  "type": "object"
        +}
    • Changedget_loop_status1 field changed
      • changedOutput schema / (root)
        Previous value: -nullNew value: +{
        +  "additionalProperties": false,
        +  "properties": {
        +    "looping": {
        +      "type": "boolean"
        +    },
        +    "signatures": {
        +      "items": {
        +        "additionalProperties": false,
        +        "properties": {
        +          "hint": {
        +            "type": "string"
        +          },
        +          "occurrences": {
        +            "type": "integer"
        +          },
        +          "signature": {
        +            "type": "string"
        +          }
        +        },
        +        "required": [
        +          "signature",
        +          "occurrences",
        +          "hint"
        +        ],
        +        "type": "object"
        +      },
        +      "type": "array"
        +    }
        +  },
        +  "required": [
        +    "looping",
        +    "signatures"
        +  ],
        +  "type": "object"
        +}
    • Changedping1 field changed
      • changedOutput schema / (root)
        Previous value: -nullNew value: +{
        +  "additionalProperties": false,
        +  "properties": {
        +    "pong": {
        +      "description": "True when the server is responsive.",
        +      "type": "boolean"
        +    }
        +  },
        +  "required": [
        +    "pong"
        +  ],
        +  "type": "object"
        +}
  5. 5 tool updatesv0.3.3
    • First observedcheck_files
    • First observedcheck_project
    • First observedget_issue_detail
    • First observedget_loop_status
    • First observedping

TDQS

A4.6/5.0

Scored across 5 tools

Disambiguation5/5

Each tool has a clearly distinct purpose: ping for health, check_project for full scans, check_files for incremental scans, get_issue_detail for inspecting results, and get_loop_status for loop detection. Descriptions explicitly cross-reference each other (e.g., check_project vs check_files) to guide selection, leaving no meaningful overlap.

Naming Consistency4/5

Mostly consistent verb_noun pattern with check_project, check_files, get_issue_detail, and get_loop_status. The bare 'ping' deviates slightly, but it follows standard health-check convention so it remains readable and predictable.

Tool Count5/5

Five tools is well-scoped for a lint/diagnostic server, with each tool earning its place across the scan-inspect-monitor workflow. No redundant or filler tools are present.

Completeness4/5

The surface covers the core lifecycle: health check, full and incremental scans, issue detail retrieval, and loop monitoring. Minor gaps exist (e.g., no explicit tool to list all clusters or clear/reset session history), but agents can work around these via existing tools.

Maintenance

ActivityActive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    D
    maintenance
    An MCP server that integrates the high-performance Oxlint linter into AI-powered editors and development tools. It enables efficient JavaScript and TypeScript code analysis and linting through the Model Context Protocol.
    1
    9 npm
    1
    Apache 2.0
  • A
    license
    A
    quality
    D
    maintenance
    A TypeScript-aware MCP server that provides coding agents with repository discovery, code intelligence, and web project context for local codebases. It enables deep symbol navigation, diagnostic reporting, and structural analysis of monorepos without requiring full IDE integration.
    7
    15 npm
    1
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    A lightweight MCP server that provides 40 tools for TypeScript/JavaScript refactoring and code intelligence, directly mapping to TypeScript's tsserver protocol commands for accurate structural changes and workspace analysis.
    40
    27 npm
    3
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that provides TypeScript 7 native language server capabilities (go to definition, find references, hover types, diagnostics) to coding agents, using the Go-based tsc compiler for fast and accurate semantic analysis.
    317 npm
    1
    MIT