Skip to main content
Glama

@mcpx-digital/md-lint

MCP server that lints local Markdown for broken relative links, heading hierarchy, empty links, and common README issues.

Local files only. Relative targets are checked on disk. External http(s) links are not fetched (no scraping, no network link checks).

Install (MCPX / npx)

npx -y @mcpx-digital/md-lint

Prepared for npm as @mcpx-digital/md-lint. Until published, run from a local clone.

Related MCP server: mdgraph

Cursor mcp.json example

{
  "mcpServers": {
    "md-lint": {
      "command": "npx",
      "args": ["-y", "@mcpx-digital/md-lint"]
    }
  }
}

Local clone:

{
  "mcpServers": {
    "md-lint": {
      "command": "node",
      "args": ["/absolute/path/to/md-lint-mcp/index.js"]
    }
  }
}

Tools

Tool

What it does

lint_markdown

Lint one .md file

lint_markdown_tree

Lint Markdown files under a directory

Checks

  • Broken relative links / images (filesystem)

  • Empty link targets or empty link text

  • Heading hierarchy (missing H1, level skips, multiple H1)

  • README heuristics (short/empty, missing install/license keywords, placeholders)

Example prompts

  • “Lint README.md for broken links and heading issues”

  • “Scan docs/ for Markdown problems”

Development

git clone https://github.com/TheoryofShadows/md-lint-mcp.git
cd md-lint-mcp
npm install
npm test
node index.js

Sell / list on MCPX

Suggested listing price: $5.

Install command: npx -y @mcpx-digital/md-lint

License

MIT © TheoryofShadows

Available Tools

2 tools
lint_markdownA

Lint a Markdown file for broken relative links, heading hierarchy, empty links, and common README issues. Local files only. Relative links are checked on disk; external http(s) links are not fetched.

Inputs: filePath (required), readmeChecks.

lint_markdown_treeA

Lint all Markdown files under a directory (skips node_modules/.git). Local files only. Relative links are checked on disk; external http(s) links are not fetched.

Inputs: rootPath (required), dirPath, maxFiles, readmeChecks.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have clearly distinct targets: one lints a single file, the other recursively lints a directory tree. No overlap or ambiguity exists.

    Naming Consistency5/5

    Both tool names use the consistent lint_markdown prefix with a clear suffix distinguishing scope. The pattern is predictable and readable.

    Tool Count3/5

    Two tools cover the core file and directory linting cases, but the count feels slightly thin for the domain; a tool for linting content or configuration might add value.

    Completeness4/5

    The surface covers linting individual files and directory trees, which are the primary local operations. Minor gaps like linting a list of files or custom configs exist but are not critical.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides AI assistants with the ability to lint, validate, and auto-fix Markdown files to ensure compliance with established Markdown standards and best practices.
      6
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides MCP tools to scan and navigate markdown repositories, offering graph-based overview, document reading, context retrieval, and orphan detection.
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables scoring a local markdown documentation file out of 100 across categories like title, install, usage, license, badges, structure, and relative link resolution, with letter grades and a concrete list of fixes. It works on local files only, providing a heuristic checklist of documentation completeness rather than judging code quality, security, or SEO.
      3
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables reading and optionally editing existing Markdown files under a configured root folder, including section-level queries, overwrites, appends, deletions, and front matter management, over stdio with no network dependencies.
      2
      MIT