Skip to content
MCP server

AsItIs

Read-only MCP server that lints and budgets CLAUDE.md, AGENTS.md and other steering files

Runs locallyStatus and history
Install
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/mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "asitis-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@asitis/mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "asitis-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@asitis/mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools