Skip to content
MCP server

Refract

Local MCP server that reports how a Wikipedia page's sentences and citations changed

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.6.2
Listing updated
3 days ago

About Refract

Refract is an open-source MCP server for analytics and data. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "refract": {
      "command": "npx",
      "args": [
        "-y",
        "@refract-org/cli"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "refract": {
      "command": "npx",
      "args": [
        "-y",
        "@refract-org/cli"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

What it does

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

Pricing

Open source

Engine licensed AGPL-3.0

Prices change. Check zz-plant.github.io before you buy.

Refract 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 to Refract

  1. 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
  2. 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
  3. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  4. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  5. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  6. Local-first long-term memory layer for AI agents, served over MCP

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • 1.3K GitHub stars
    • Knowledge and memory