Back to Browse

Readfirst MCP Server

Developer ToolsLow Risk10.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

What to read and check before changing a file: project rules, risks, checks and tests per file.

About

What to read and check before changing a file: project rules, risks, checks and tests per file.

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (0 strong, 2 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.

5 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "readfirst": {
      "command": "npx",
      "args": [
        "-y",
        "readfirst@0.34.0"
      ]
    }
  }
}

Some servers take additional arguments. See the repository for details.

Documentation

View on GitHub

From the project's GitHub README.

readfirst

What to read and check before you — or your AI agent — change a file.

It found bugs now fixed upstream in Saleor, Wagtail, n8n, django-allauth and WYGIWYH: 136 real findings across 68 open-source repositories.

Start in 30 seconds

Any language; needs Node 20+.

npx readfirst init --agent --ci   # a first map, your agents wired to it (Claude Code, Cursor, Codex, Gemini, ...), the PR Action
npx readfirst read <file>         # before changing a file: its rules, risks, checks, tests and callers
npx readfirst verify              # before you finish: the checks pass and nothing the map ties to the change was left out

npx readfirst read src/imports.mjs prints the rules, risks, checks, tests and callers for that file

Commit .readfirst/map.json. Filled maps for real repositories: examples/.

What it does

Coding agents can follow imports. What they don't know is what your team knows: "amounts here are in cents", "this table is read by the mobile app, keep old columns", "run the payment e2e after touching this". readfirst keeps that in one file next to the code and hands it out, file by file, when someone is about to change something.

  • Your rules and risks, per file, from .readfirst/map.json, with the checks to run and the files that change together.
  • Where the code broke before, from git history: npx readfirst audit, no map needed.
  • Bug shapes taken from real bugs: npx readfirst scan, no map needed (results computed and thrown away, expect(...).resolves nobody awaits, and four more).

No server, no account, no model calls. It reads your git checkout and the map.

Free and hosted

Free (MIT)Pro, $39 a month (readfirst-app)
Where it runsyour machine and your CI; your code goes nowherethe readfirst-app GitHub App reads your repositories on our server
The mapinit writes a first one; you keep itwritten for you from the code and its history (the free hosted fill is paused until three paying subscribers), and kept in step after each merge
Pull requeststhe Action posts what to read and checkPR watch comments on every pull request, whoever opened it: rules a change may break, files left out, the same table written elsewhere
Bug shapesthe 6 published shapes (scan)the full hosted set, a repository audit and fix PRs
Where outside input goes—flows: from each route to the writes it reaches and the checks on the way
AgentsClaude Code plugin and hook, MCP server, Cursor rulesthe same, plus reproduced-bug reviews in a sandbox (one a month)

Details: the guide.

What it caught

  • Saleor: an "only recalculate what changed" option recalculated every discounted price (#19984).
  • Wagtail: a superuser who submits a page got the moderation email about their own submission (#14790).
  • n8n: the RabbitMQ node handed back its channel before the queue bindings were made (#43033, fixed by the n8n team after our issue).
  • django-allauth: a provider callback returned a 500 on a non-ASCII value (f1e06cc, fixed the day it was reported).
  • WYGIWYH: client registration answered a 500 instead of a refusal on a non-ASCII token (#649, merged with its regression test).

Across 68 open-source repositories the hosted shapes recorded 897 hits, 849 judged: 100 bugs in app code, 36 tests that pass even when their check fails, and 312 false positives kept on record. The counts come after tuning on the same repositories, so read them as "what is there", not as precision. Reports still with their maintainers: the guide.

More

The Claude Code plugin and hook, MCP for any agent, Cursor rules, the GitHub Action, the map format, audit, find, monorepos and pinning a version: the guide.

License

MIT

Reviews

No reviews yet

Be the first to review this server!