PlugWiki
ctxlint logo

ctxlint MCP Server: Lint CLAUDE.md, AGENTS.md and MCP Configs

CommunityLocal
Getnpm@yawlabs/ctxlintyawlabs/ctxlint

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.

Install ctxlint MCP

Claude Code

  1. 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. 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_audit

  • Checks 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_audit

  • Checks 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_audit

  • Checks 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_audit

  • Checks 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_path

  • Counts 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_report

  • Fixes 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-onlyNo read-only switch is documented. Only ctxlint_fix writes, and it takes a dryRun option that previews changes without writing.
Sign-in and keysNo 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

WebsiteGitHubnpmOfficial MCP RegistryChangelogIssues

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 2
  1. github.com · github.com
  2. www.npmjs.com · npmjs.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.