Readfirst
Per-file rules, risks, checks and tests for coding agents to read before editing
- Pricing
- Freemium
- Platforms
- CLI, API, self-hosted
- Runs
- Locally
- Version
- 0.34.0
- Listing updated
- today
Similar MCP servers
About Readfirst
Readfirst is a freemium MCP server for developer tools. It runs locally on your machine and is started by your AI client.
The idea is that an agent can follow imports but does not know what the team knows, such as amounts being stored in cents or a table being read by the mobile app. readfirst keeps that knowledge in a committed .readfirst/map.json and hands it out file by file when someone is about to change something, including the checks to run and the files that tend to change together.
The command line has three core steps: init writes a first map and wires agents and a PR Action, read shows a file's rules, risks, checks, tests and callers, and verify confirms that checks pass and nothing tied to the change was left out. Two map-free commands also exist: audit finds where code broke before from git history, and scan looks for six published bug shapes such as results computed and thrown away. It runs on your machine with no server, account or model calls.
A paid hosted tier adds a GitHub App that writes and maintains the map, comments on every pull request and runs a fuller bug-shape set. The README reports 136 findings across 68 open-source repositories, with fixes merged in projects such as Saleor, Wagtail and n8n.
Install
Run in a terminal
claude mcp add readfirst -- npx -y readfirstAdd to claude_desktop_config.json
{
"mcpServers": {
"readfirst": {
"command": "npx",
"args": [
"-y",
"readfirst"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"readfirst": {
"command": "npx",
"args": [
"-y",
"readfirst"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"readfirst": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"readfirst"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"readfirst": {
"command": "npx",
"args": [
"-y",
"readfirst"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"readfirst": {
"command": "npx",
"args": [
"-y",
"readfirst"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
What it does
- Per-file map
- Rules, risks, checks and linked files stored in .readfirst/map.json.
- Read before edit
- `readfirst read` shows a file's rules, tests and callers.
- Verify before finishing
- Confirms checks passed and related files were not forgotten.
- Git-history audit
- Finds where code broke before, with no map needed.
- Bug-shape scan
- Six published patterns, for example unawaited async assertions.
- Agent wiring
- Hooks into Claude Code, Cursor, Codex, Gemini and others.
- PR Action
- A GitHub Action posts what to read and check on pull requests.
Good for
- Give an AI agent your team's unwritten rules before it edits a file
- Check that related files were not left out of a change
- Surface high-churn, historically buggy files
- Scan a repository for known bug patterns
Pricing
Freemium, from $39 a month
Free (MIT); Pro $39 a month
Readfirst FAQ
Does it send my code anywhere?
The free version runs on your machine and CI; code goes nowhere and no model calls are made.
What does the paid plan cost?
Pro is $39 a month, via the readfirst-app GitHub App.
What does it need?
Node 20 or newer; any language is supported.
What licence is the free version?
MIT.
Is Readfirst free?
Readfirst has a free plan, with paid plans for more usage or features. Paid plans start at $39 a month.
How do I add Readfirst to Claude Code?
Run this command in your terminal: claude mcp add readfirst -- npx -y readfirst
What are the best alternatives to Readfirst?
The closest alternatives to Readfirst are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.


