mcp integrity agents lint links 

Reference

Reference integrity for AI agents. Scans a repository for every reference and verifies each one resolves.

Version

v0.1.6

License

MIT

Platforms

Node 18 or newer, Any MCP client

Interfaces

CLI, MCP

View on GitHubnpm packageMCP server

Overview

Agents assume references resolve. They import a file that was renamed, link a repository that was deleted, or depend on a package that was unpublished, and only discover it after wasting a session. Reference extracts every reference in a repository and verifies each one up front.

Setup

npm install -g reference-mcp

Add the server to your MCP client.

{
  "mcpServers": {
    "reference": {
      "command": "reference-mcp",
      "args": []
    }
  }
}

Usage

  • reference.scan extract every reference from a repository, deduplicated by kind: local imports, module dependencies, url links, asset files.
  • reference.check verify local paths, module names, and URLs. Pass checkRemote: false for a fully offline check. Returns findings with a status per reference and a BROKEN_REFERENCES or ALL_OK verdict.

Typical agent instructions:

  • “Are any links in this repo dead?”
  • “Does every import in this project resolve?”
  • “Which of our npm dependencies no longer exist?”

Gains

  • Broken references are found before an agent or build depends on them.
  • Full coverage in one pass. Imports, assets, dependencies, and links together.
  • Offline mode for air gapped and CI environments.
  • Deterministic. The same repository produces the same report.

Repository