Skip to content
MCP server

FactReason

Check npm and PyPI upgrades for breaking changes, with evidence for each finding

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://www.factreason.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "factreason": {
      "url": "https://www.factreason.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools