FactReason
Check npm and PyPI upgrades for breaking changes, with evidence for each finding
- Pricing
- Free trial
- Platforms
- API
- Runs
- Remotely
- Version
- 2.2.0
- Listing updated
- 1 day ago
About FactReason
FactReason is an MCP server for developer tools. It runs as a hosted remote server, so there is nothing to install locally.
Before an agent edits package.json, it can ask FactReason what breaks between two exact releases. The advisory is derived from publisher-declared registry metadata: yanks, module-format changes, raised runtime floors, exports, peers and licence changes. Each finding carries the registry field and its values before and after, so the claim can be checked against npm or PyPI directly. The README's chalk 4.1.2 to 5.0.0 example flags a switch to ESM and a higher Node requirement.
Beyond upgrades, the service answers questions about developer API schemas across 1,097 services and electronic component specifications. Heavy tools accept a compact response format that trims repeated fields and reports token savings counted with o200k_base. Responses are Ed25519-signed.
An agent can create its own key with factreason_create_key and top up through a checkout link for a human. Accuracy is described as best-effort, not guaranteed.
Install
Run in a terminal
claude mcp add --transport http factreason https://www.factreason.com/mcpAdd to Settings → Connectors → Add custom connector
https://www.factreason.com/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"factreason": {
"url": "https://www.factreason.com/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"factreason": {
"type": "http",
"url": "https://www.factreason.com/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"factreason": {
"serverUrl": "https://www.factreason.com/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"factreason": {
"type": "http",
"url": "https://www.factreason.com/mcp"
}
}
}Tools this server provides (3)
Taken from the project documentation; the running server may differ.
- factreason_package_upgrade_advisory
- Returns breaking-change advisories between two versions of an npm or PyPI package.
- factreason_create_key
- Creates an API key for the agent.
- factreason_create_topup_link
- Creates a checkout link a human can use to add credit.
What it does
- Upgrade advisories
- Compares two exact npm or PyPI releases for breaking changes.
- Evidence fields
- Attaches the registry field with before and after values.
- API schema lookup
- Gives publisher schemas across 1,097 services.
- Component specs
- Looks up electronic component facts.
- Compact responses
- Trims output to save agent context and reports token counts.
- Signed answers
- Responses are Ed25519-signed.
Good for
- Check a major version bump before changing package.json
- Assemble a third-party API call from its publisher schema
- Look up deprecation and sunset dates across services
- Verify a component's specifications
Pricing
Free trial
Pay per query from prepaid credit; $0.05 trial credit; advisory $0.02
Prices change. Check factreason.com before you buy.
FactReason FAQ
How is it priced?
Prepaid credit is debited per successful query; an upgrade advisory costs $0.02 and a component lookup $0.001.
Is there a free trial?
Eligible new users may get up to $0.05 of one-off trial credit with no card.
Can an agent get its own key?
Yes, by calling factreason_create_key.
Is it always correct?
No. The site says accuracy is best-effort and not guaranteed.
Is FactReason free?
FactReason is a paid product with a free trial.
How do I add FactReason to Claude Code?
Run this command in your terminal: claude mcp add --transport http factreason https://www.factreason.com/mcp
What are the best alternatives to FactReason?
The closest alternatives to FactReason are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to FactReason

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools