# Refract

> Refract is an open-source MCP server for analytics and data. Local MCP server that reports how a Wikipedia page's sentences and citations changed. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://zz-plant.github.io/refract/
- **Repository:** https://github.com/zz-plant/refract
- **MCP Registry name:** io.github.zz-plant/refract
- **Categories:** analytics and data, knowledge and memory
- **Listing updated:** 2026-11-14

## About

Wikipedia's history is searchable by revision, but not by what a sentence said at a given moment. Refract reads a page's revision history and emits typed events for changed sentences, added, removed or replaced citations, and structural edits, each tied to the revisions behind it.

It runs locally under deterministic rules with no API key or model, and works on other MediaWiki wikis too. A worked example follows the 43 revisions Pluto's article went through in under an hour on 24 August 2006. A watchlist mode remembers the last revision you acknowledged, and output can be exported as NDJSON for notebooks, SQL or a bundled browser viewer; a Python adapter reads events as dataclasses or DataFrames.

The authors list limits: a wording change does not prove a dispute, and an arbitrary web URL has no revision history.

## Features

- **Sentence changes:** Shows wording before and after for each observed transition.
- **Citation events:** Flags references added, removed or replaced.
- **Review watchlists:** Keeps fetched progress separate from reviewed progress.
- **NDJSON export:** Writes events for notebooks, SQL or the browser viewer.
- **Repeatable output:** The same inputs and analyzer versions give the same observations.

## Good for

- Audit when a citation was removed from an article
- Trace how a claim's wording drifted over time
- Review pages you revisit since your last check
- Feed edit events into a research notebook

## Install

### Claude Code (Terminal)

```sh
claude mcp add refract -- npx -y @refract-org/cli
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "refract": {
      "command": "npx",
      "args": [
        "-y",
        "@refract-org/cli"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "refract": {
      "command": "npx",
      "args": [
        "-y",
        "@refract-org/cli"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "refract": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@refract-org/cli"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "refract": {
      "command": "npx",
      "args": [
        "-y",
        "@refract-org/cli"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "refract": {
      "command": "npx",
      "args": [
        "-y",
        "@refract-org/cli"
      ]
    }
  }
}
```

## FAQ

### Does it need an API key?

No. It runs locally with no key or model.

### Which sites does it support?

Wikipedia and other MediaWiki wikis.

### What licence applies?

The engine is AGPL-3.0; the site's own documentation is CC-BY-4.0.

### Is Refract free?

Yes. Refract is open source, so you can use and self-host it for free.

### How do I add Refract to Claude Code?

Run this command in your terminal: claude mcp add refract -- npx -y @refract-org/cli

### What are the best alternatives to Refract?

The closest alternatives to Refract are Codebase Memory, XERJ, Agent-Native Analytics, Claude Code Ultimate Guide and Google Ads + Meta Ads + SEO/GEO MCP.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [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.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.

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