# FactReason

> FactReason is an MCP server for developer tools. Check npm and PyPI upgrades for breaking changes, with evidence for each finding. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Platforms:** API
- **Website:** https://factreason.com
- **Repository:** https://github.com/factreason/factreason
- **MCP Registry name:** io.github.factreason/factreason
- **Categories:** developer tools
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http factreason https://www.factreason.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://www.factreason.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "factreason": {
      "url": "https://www.factreason.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "factreason": {
      "type": "http",
      "url": "https://www.factreason.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "factreason": {
      "serverUrl": "https://www.factreason.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "factreason": {
      "type": "http",
      "url": "https://www.factreason.com/mcp"
    }
  }
}
```

## Tools

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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/factreason
