AsItIs
Read-only MCP server that lints and budgets CLAUDE.md, AGENTS.md and other steering files
- Pricing
- Open source
- Platforms
- CLI, macOS, Windows
- Runs
- Locally
- Version
- 0.4.4
- Listing updated
- 2 days ago
About AsItIs
AsItIs is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.
AsItIs inspects the markdown files that steer a coding agent: CLAUDE.md, AGENTS.md, GEMINI.md, SKILL.md, subagents, commands, rules, Cursor .mdc rules, Copilot instructions and memory files. Its six tools read, outline, lint, estimate context budget and suggest fixes, and there is no write, patch or delete tool in the package.
The lint rules look for hidden instructions such as HTML comments addressed to an agent or zero-width characters, broken links and @imports, duplicate or contradictory rules, frontmatter mistakes, and drift between files for different agents, for example an AGENTS.md that Claude Code skips because a CLAUDE.md exists. Optional scans cover risky skill scripts and agent config such as hooks and unpinned MCP packages. Context cost is a local estimate per tool, not a vendor tokenizer.
It runs over stdio, makes no network calls or telemetry, reads only markdown under the folder you pass with --root, and needs Node 22.13 or later. The README says to pin the version rather than use @latest. The MCP package is MIT licensed; the separate AsItIs editor app has paid tiers.
Install
Run in a terminal
claude mcp add asitis-mcp -- npx -y @asitis/mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"asitis-mcp": {
"command": "npx",
"args": [
"-y",
"@asitis/mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"asitis-mcp": {
"command": "npx",
"args": [
"-y",
"@asitis/mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"asitis-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@asitis/mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"asitis-mcp": {
"command": "npx",
"args": [
"-y",
"@asitis/mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"asitis-mcp": {
"command": "npx",
"args": [
"-y",
"@asitis/mcp"
]
}
}
}What it does
- Hidden instruction checks
- Finds comments, zero-width and bidirectional characters that hide text from reviewers.
- Context budget
- Estimates tokens each file adds per session for several coding agents.
- Broken import detection
- Flags links and @imports that point to missing files.
- Drift detection
- Spots AGENTS.md files skipped by Claude Code and mirrored files that diverged.
- No writes, no network
- Read-only tools over stdio with no telemetry or remote calls.
- CLI and CI use
- The same package provides an asitis command for pre-commit and pull requests.
Good for
- Lint CLAUDE.md before merging
- Check how much context agent files cost each session
- Catch a hidden instruction in a pulled repository
- Keep AGENTS.md and CLAUDE.md in sync
- Audit a skill folder for risky scripts
Pricing
Open source
MCP server is MIT licensed; the separate AsItIs desktop app has Pro at $29 one time
Prices change. Check asitis.app before you buy.
AsItIs FAQ
Can it change my files?
No. The README says there is no write, patch or delete tool and no write code in the package.
Does it use the network?
No. It speaks MCP over stdio only, with no telemetry or update check.
Which Node version is needed?
Node 22.13 or later.
Which agent files does it understand?
CLAUDE.md, AGENTS.md, GEMINI.md, SKILL.md, subagents, commands, rules, Cursor .mdc rules, Copilot instructions and memory files.
Is AsItIs free?
Yes. AsItIs is open source, so you can use and self-host it for free.
How do I add AsItIs to Claude Code?
Run this command in your terminal: claude mcp add asitis-mcp -- npx -y @asitis/mcp
What are the best alternatives to AsItIs?
The closest alternatives to AsItIs are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to AsItIs

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools