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
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.
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 GitHubFrom 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

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(...).resolvesnobody 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 runs | your machine and your CI; your code goes nowhere | the readfirst-app GitHub App reads your repositories on our server |
| The map | init writes a first one; you keep it | written 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 requests | the Action posts what to read and check | PR watch comments on every pull request, whoever opened it: rules a change may break, files left out, the same table written elsewhere |
| Bug shapes | the 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 |
| Agents | Claude Code plugin and hook, MCP server, Cursor rules | the 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!
More Developer Tools MCP Servers
Rea
Freeby Morluto · Developer Tools
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Paperclip
Freeby Paperclipai · Developer Tools
Trending hip-hop artist momentum scores across four cultural dimensions.
Scrapling
Freeby D4Vinci · Developer Tools
Web scraping with stealth HTTP, real browsers, and Cloudflare bypass. CSS selectors supported.
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
