
ctxlint MCP Server: Lint CLAUDE.md, AGENTS.md and MCP Configs
Lets your assistant check your CLAUDE.md, AGENTS.md, skills and MCP configs for stale references and mistakes.
ctxlint's server lets Claude, Cursor and other assistants check the files that guide them, such as CLAUDE.md and AGENTS.md, against your real code. It also checks your MCP config files and skill definitions, and reports token waste.
It runs on your computer and needs no account or API key. Six of the seven tools only read. The fix tool edits your context files to repair broken paths, so ask for a dry run first.
Good for
- Developers who keep CLAUDE.md or AGENTS.md and want them accurate
- Teams that share MCP configs across Cursor, VS Code and Claude
- Heavy Claude Code users who want to clean skills and memory
Works in
12 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install ctxlint MCP
Claude Code
- 1
Copy this prompt.
Add the ctxlint MCP server to Claude Code. Run this command: claude mcp add ctxlint -- npx -y @yawlabs/ctxlint@latest serve Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Node.js.
The server starts with the serve command after the package name, so the commands and configs here include it. On Windows, the README wraps npx in cmd /c in the config file.
From the project README. Source.
Tools
Checks CLAUDE.md and AGENTS.md against your code
Looks for stale file references, commands that do not exist, repeated or contradictory content, bad frontmatter and wasted tokens in your agent context files.
Try: “Audit my CLAUDE.md and AGENTS.md for stale references.”
Files ·
ctxlint_auditChecks your MCP config files for mistakes
Lints MCP server config files for wrong structure, hardcoded secrets, deprecated transports, wrong environment variable syntax and settings that differ between apps.
Try: “Lint my MCP configs for secrets and mistakes.”
Files ·
ctxlint_mcp_auditChecks agent sessions and memory for problems
Looks across your projects for diverged config files, stale or duplicate memory entries, command loops and, in Claude Code transcripts, repeated large file reads and other hazards.
Try: “Audit my agent sessions for loops and stale memory.”
Files ·
ctxlint_session_auditChecks skill and subagent definitions
Looks at skill and agent files for frontmatter problems, broken references, triggers that collide and unused tool limits.
Try: “Audit my skills and subagents for broken references.”
Files ·
ctxlint_skill_auditChecks that a path in a context file exists
Says whether one file path named in a context file exists in the project and suggests a fix if not.
Try: “Does src/utils/helpers.ts exist in this project?”
Files ·
ctxlint_validate_pathCounts tokens in your context files
Gives token counts per file and in total, plus an estimate of waste from repeated content.
Try: “How many tokens do my context files use?”
Files ·
ctxlint_token_reportFixes broken file paths in context files
Repairs broken paths in your context files using git history and fuzzy matching, and edits the files. Pass dryRun to preview the changes without writing.
Try: “Fix broken paths in my context files, dry run first.”
Write ·
ctxlint_fix
Read from the source code
Permissions
medium risk · 3 things to watch
Medium risk
The assistant can read your project files, your MCP configs and, for the session audit, your agent history, and one tool edits your context files. Ask it to run the fix tool as a dry run first.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
ctxlint_fix edits your context files
It rewrites broken paths in files such as CLAUDE.md. Use dryRun first and check the result in git. npmjs.com
It can read global configs and agent history
ctxlint_mcp_audit can scan user-level MCP configs and ctxlint_session_audit reads session data and Claude Code transcripts, which can hold private material. npmjs.com
Read-only tools declare it to your app
The tools that only read are marked read-only, so some apps skip the confirmation prompt for them. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | No read-only switch is documented. Only ctxlint_fix writes, and it takes a dryRun option that previews changes without writing. |
|---|---|
| Sign-in and keys | No account or API key. |
Questions
Is the ctxlint MCP server official?
It is made by Yaw Labs, the team behind the ctxlint tool, and is not tied to any AI app. It connects to local files, so there is no other vendor.
Do I need an API key?
No. It runs locally with no account or key.
Which files does it check?
Agent context files such as CLAUDE.md and AGENTS.md, MCP config files, skill and subagent definitions, and session data. The README lists 16 AI tools and 8 MCP clients it understands.
Can it change my files?
Only the fix tool, which repairs broken file paths in context files. It supports a dry run, so you can preview first.
Is ctxlint also a command-line tool?
Yes. The same package runs from the terminal and in CI, and the MCP server is started with its serve command, which the install box includes.
How do I add it on Windows?
The README says to wrap the command in cmd /c for npx in the config file. The install box shows the macOS and Linux form.
Information
updated Nov 2, 2026
- Publisher
- Community
- Package
@yawlabs/ctxlint- Registry
- npm
- Transport
- stdio
- Version
- 0.28.1
- License
- MIT
- Last commit
- Oct 31, 2026
- Open issues
- 0
- Listed in
- Official MCP registry
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 2Hide
- github.com · github.com
- www.npmjs.com · npmjs.com