# Refract (npm · @refract-org/cli)

git log for Wikipedia: typed events for changed sentences, citations, and structure on any page.

- Trust score: 82/100 (high trust)
- Change this week: +28
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-21

## Components

- npm · `@refract-org/cli`: 82/100 (this document), [markdown](https://verifymcp.io/servers/zz-plant-refract/refract-org-cli.md), [page](https://verifymcp.io/servers/zz-plant-refract/refract-org-cli)

## Channel facts

- Registry: `npm`
- Package: `@refract-org/cli`
- Version: `0.7.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-21.

- **Supply Chain Security**: 98/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 5 of 11 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 100/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to zz-plant/refract).
  - Clear OSI-approved license (AGPL-3.0).
  - Actively maintained (last published 1 days ago).
  - Publishes a security disclosure policy (SECURITY.md).
- **Schema Quality & AI Usability**: 66/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 1126 tokens (~140/item across 8 items; 8 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 30/100
  - Stability observed for 9 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 8 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 8 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 60/100
  - Spec-recency check failed: implements MCP spec 2025-06-18; the latest is 2026-07-28.

## Install

### How do I install the Refract MCP server?

Refract runs locally as an npm package, launched with npx -y @refract-org/cli mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add zz-plant-refract -- npx -y @refract-org/cli mcp
```

### Cursor

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

### VS Code

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

### Codex

```bash
codex mcp add zz-plant-refract -- npx -y @refract-org/cli mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "zz-plant-refract": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@refract-org/cli",
        "mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add zz-plant-refract --command npx --arg -y --arg @refract-org/cli --arg mcp
```

### Hermes

```yaml
mcp_servers:
  zz-plant-refract:
    command: "npx"
    args: ["-y", "@refract-org/cli", "mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "zz-plant-refract": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "@refract-org/cli",
        "mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add zz-plant-refract -t stdio -c npx -a -y @refract-org/cli mcp
```

### Other

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

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-21 (score 82, +1)

No change was recorded against any check on this day. Stability & Change Management went from 27 to 30. That category is still filling its 30-day observation window: 8 days of observed history at the previous scan, 9 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-19 (score 81, 0)

- [functional regression] Schema quality: 124 → 140
- [functional] Package version: 0.6.2 → 0.7.0

### 2026-11-17 (score 81, +1)

No change was recorded against any check on this day. Stability & Change Management went from 13 to 17. That category is still filling its 30-day observation window: 4 days of observed history at the previous scan, 5 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-15 (score 80, +26)

- [security improvement] Malware scan: unverified → pass
- [security improvement] Known CVEs: unverified → pass
- [functional improvement] Dependency health: unverified → 0.83

### 2026-11-14 (score 54, −24)

- [security regression] Malware scan: pass → unverified
- [security regression] Known CVEs: pass → unverified
- [functional regression] Dependency health: 0.83 → unverified
- [functional regression] Schema quality: pass → fail
- [functional improvement] Stability: unverified → 0.07
- [functional] Package version: 0.6.1 → 0.6.2

### 2026-11-13 (score 78, +15)

- [security improvement] Malware scan: unverified → pass
- [functional improvement] Security disclosure: unverified → pass

### 2026-11-12 (score 63)

First indexed and scored.

## MCP tools (8)

### `analyze` (~157 tokens)

Analyze a MediaWiki page's full edit history. Returns a structured event stream: claims, citations, sections, templates, categories, wikilinks, and reverts — all provenance-tagged with revision IDs and timestamps.

Input parameters:

- `api` (string): MediaWiki API base URL. Defaults to English Wikipedia.
- `config` (object): Analyzer configuration overrides
- `depth` (string): Analysis depth: brief (event metadata only), detailed (text included), forensic (full wikitext)
- `from` (string): Start revision ID
- `page` (string, required): Page title (e.g. 'Bitcoin', 'Climate change')
- `since` (string): Re-observe from ISO timestamp
- `to` (string): End revision ID

### `claim` (~74 tokens)

Track a specific sentence's provenance across revisions. Shows when a sentence first appeared, was removed, or was reintroduced — with section context and revision IDs.

Input parameters:

- `api` (string): MediaWiki API base URL
- `page` (string, required): Page title
- `text` (string, required): Sentence text to track (partial match supported)

### `export` (~69 tokens)

Export page analysis as structured JSON. Returns all events with revision, section, and timestamp provenance.

Input parameters:

- `api` (string): MediaWiki API base URL
- `depth` (string): Analysis depth
- `page` (string, required): Page title
- `since` (string): Re-observe from ISO timestamp

### `cron` (~45 tokens)

One-shot re-observation for cron: reads a pages file, runs analysis, reports new events.

Input parameters:

- `pagesFile` (string, required): Path to file with page titles (one per line)

### `classify` (~138 tokens)

Ask a model to classify a single observation boundary — revert detection, sentence similarity, edit type, template signal, or activity spike. Uses MCP sampling if no API key is configured, otherwise calls the configured provider.

Input parameters:

- `apiKey` (string): API key for the inference provider (optional; falls back to MCP sampling)
- `boundary` (string, required): Which inference boundary to classify
- `endpoint` (string): Inference provider endpoint URL (default: OpenAI-compatible)
- `input` (object, required): Input data for the boundary (field names vary by boundary type)
- `model` (string): Model name (default: gpt-4o-mini)

### `get_statement_history` (~259 tokens)

Track a statement's trajectory across a page's revisions. A revision matches when its text contains the statement after lowercasing and collapsing whitespace, or else, partially, when one sentence holds at least 70% of the statement's words longer than three characters (at least three such words); a partial match does not establish the same meaning. Returns each transition (first seen, wording changed, removed, reintroduced) with the fetched revisions it lies between, revert evidence, how many revisions the result held, and the nearest remaining sentence on a removal; plus matched revisions, an overall status, and a short change summary.

Input parameters:

- `api` (string): MediaWiki API base URL. Defaults to English Wikipedia.
- `context` (string): Optional use-context slug for scoped analysis
- `depth` (string): History depth: brief, detailed, or forensic
- `from` (number): Read forward from this revision ID
- `limit` (number): Revisions to read (default 50, or the whole range when both from and to are given)
- `page` (string, required): MediaWiki page title to ground against
- `statement` (string, required): Raw text statement to track
- `to` (number): Read back from this revision ID

### `snapshot` (~148 tokens)

Return the revision of a MediaWiki page that was live at a date: the newest revision at or before it, with its revision ID, timestamp, section headings, and text.

Input parameters:

- `api` (string): MediaWiki API base URL. Defaults to English Wikipedia.
- `at` (string): Target date or timestamp, ISO 8601 (e.g. '2024-01-15'). Defaults to the current time.
- `content` (string): Page text to include: plain (markup stripped, default), wikitext, or none
- `page` (string, required): Page title
- `revisionLimit` (number): Max revisions to fetch at or before the date (default 500)

### `review` (~236 tokens)

Observe changes to a list of pages since their last acknowledged review and return the saved review report as JSON. Saves revisions and the report under stateDir. Never acknowledges: a person inspects the report and acknowledges it with the CLI command the result gives, and an incomplete report cannot be acknowledged.

Input parameters:

- `api` (string): MediaWiki API base URL. Defaults to English Wikipedia.
- `eventTypes` (array): Show only these event types in view; the saved report stays unfiltered
- `from` (number): Initial comparison baseline revision ID for a page with no acknowledged review
- `limit` (number): New revisions per page per call (default 200); call again to resume
- `pages` (array): Page titles to review
- `sample` (boolean): Review the bundled fictional history offline instead of pages
- `section` (string): Show only events in this section in view
- `stateDir` (string, required): Absolute path of the review state directory. All state and saved reports are written here; use the same directory the person acknowledges with.
- `text` (string): Show only events whose text contains this in view

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/zz-plant-refract/refract-org-cli#diagnostics

## Score history

- 2026-11-21: 82
- 2026-11-20: 81
- 2026-11-19: 81
- 2026-11-18: 81
- 2026-11-17: 81
- 2026-11-16: 80
- 2026-11-15: 80
- 2026-11-14: 54
- 2026-11-13: 78
- 2026-11-12: 63

## Common questions

### What is the Refract MCP server?

Refract is an MCP server listed in the public MCP registry as io.github.zz-plant/refract. git log for Wikipedia: typed events for changed sentences, citations, and structure on any page. This page covers its npm package (@refract-org/cli).

### Is the Refract MCP server safe to use?

Refract scores 82 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 21 November 2026. It declares no install or post-install scripts. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Refract MCP server expose?

Refract exposes 8 tools: analyze, claim, export, cron, classify, and 3 more. Their descriptions and schemas cost roughly 1,126 tokens of context every time the server is loaded.

### Is the Refract MCP server still maintained?

Refract is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the Refract MCP server under?

Refract declares the AGPL-3.0 licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

### What did VerifyMCP test on the Refract MCP server?

VerifyMCP ran 16 checks on Refract, covering Malware scan, Known CVEs, Install scripts, Dependency health and 12 more. Endpoint Security and Transport & Reachability do not apply to an npm package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- npm package: https://www.npmjs.com/package/@refract-org/cli
- Socket report: https://socket.dev/npm/package/@refract-org/cli
- Repository: https://github.com/zz-plant/refract
- Website: https://zz-plant.github.io/refract/
- Changelog RSS feed: https://verifymcp.io/servers/zz-plant-refract/refract-org-cli.xml
- Changelog JSON feed: https://verifymcp.io/servers/zz-plant-refract/refract-org-cli/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/zz-plant-refract/refract-org-cli.json
- HTML version of this page: https://verifymcp.io/servers/zz-plant-refract/refract-org-cli
