md-lint
Lints local Markdown files and directories for broken relative links/images, empty link targets or text, heading hierarchy issues, and common README problems, with tools for linting a single Markdown file or a tree of Markdown files.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@md-lint Lint README.md for broken relative links and heading issues"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@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-lintPrepared 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 one |
| 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.jsSell / list on MCPX
Suggested listing price: $5.
Install command: npx -y @mcpx-digital/md-lint
License
MIT © TheoryofShadows
Available Tools
2 toolslint_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
Scored across 2 tools
The two tools have clearly distinct targets: one lints a single file, the other recursively lints a directory tree. No overlap or ambiguity exists.
Both tool names use the consistent lint_markdown prefix with a clear suffix distinguishing scope. The pattern is predictable and readable.
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.
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
Related MCP Connectors
Lint a SKILL.md for frontmatter, structure, secrets and size. All 6 tools free.
Lint and diff DESIGN.md files with the official Google linter, or write one from a web page.
Crawl sites to Markdown with sitemaps, globs and depth limits, obeying robots and crawl-delay
MEOK AGENTS.md Linter MCP — validates the cross-vendor coding-agent spec (Cursor / Claude Code /
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides AI assistants with the ability to lint, validate, and auto-fix Markdown files to ensure compliance with established Markdown standards and best practices.6MIT
- AlicenseNot gradedqualityDmaintenanceProvides MCP tools to scan and navigate markdown repositories, offering graph-based overview, document reading, context retrieval, and orphan detection.MIT
- AlicenseAqualityCmaintenanceEnables 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.3MIT
- AlicenseBqualityCmaintenanceEnables 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.2MIT