# AsItIs

> AsItIs is an open-source MCP server for files and documents. Read-only MCP server that lints and budgets CLAUDE.md, AGENTS.md and other steering files. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux
- **Website:** https://asitis.app/claude-code
- **Repository:** https://github.com/katta041/asitis-agent-tools/tree/HEAD/packages/mcp
- **MCP Registry name:** io.github.Katta041/asitis-mcp
- **Categories:** files and documents, developer tools, security
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add asitis-mcp -- npx -y @asitis/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "asitis-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@asitis/mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "asitis-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@asitis/mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "asitis-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@asitis/mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "asitis-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@asitis/mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "asitis-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@asitis/mcp"
      ]
    }
  }
}
```

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/asitis
