Integrations

Refract produces a deterministic event stream — standard NDJSON with typed schemas, deterministic hashes, and provenance metadata. Anything that reads JSON or speaks HTTP can consume it. This page catalogs every supported integration.

By pattern

Pattern	Best for	Start here
CLI pipeline	Shell scripts, cron jobs, CI/CD	CLI reference
SDK (TypeScript)	Node.js apps, custom analyzers	SDK reference
SDK (Python)	Jupyter, pandas, data science	Python SDK tutorial
MCP server	AI coding agents (Claude Code, Cursor, VS Code)	MCP agent tutorial
Direct NDJSON	DuckDB, SQL, shell pipelines	Analytics with DuckDB
HTTP/webhook	Slack, email, custom alerting	Scheduled monitoring tutorial

By tool

Databases and query engines

Tool	How	Docs
DuckDB	Query NDJSON directly: `SELECT * FROM 'events.jsonl'`	Analytics
SQLite	`@refract-org/persistence` wraps `bun:sqlite`. Stores events + revisions locally.	SDK
PostgreSQL / D1	Reference DDL with indexes for production ingestion.	Downstream
ClickHouse	Columnar analytics on event streams. Query NDJSON via `file()` table function.	Downstream

AI and ML

Tool	How	Docs
LangChain	`refract-py/src/refract_langchain.py` — loads events as `Document` objects with stability metadata for provenance-aware RAG.	RAG tutorial
LlamaIndex	Load events as nodes, use stability score as metadata filter.	RAG tutorial
Vercel AI SDK	Use stability signals as reranking features in retrieval chains.	RAG tutorial
OpenAI / DeepSeek / Ollama	Plug any OpenAI-compatible endpoint into `refract classify` at BYO-inference boundaries.	BYO-inference tutorial
MCP clients	Claude Code, VS Code, Cursor, Claude Desktop connect via `refract mcp`. Agents call Refract tools directly.	MCP agent tutorial

Model evaluation

Tool	How	Docs
Temporal leakage detection	`refract_eval.build_leakage_benchmark()` — find claims that appeared after a model's cutoff	Model evaluation tutorial
Retrieval quality scoring	`refract_eval.score_retrieval_quality()` — score passages by stability	RAG tutorial
Provenance hallucination	`refract_eval.check_provenance()` — verify if a source ever existed	Model evaluation tutorial
Benchmark submission	Standard 10-page benchmark, submission format, reproducibility requirements	BENCHMARK.md
Colab notebook	Ready-to-run notebook — `pip install refract-py` and go	notebooks/model-evaluation.ipynb

Notebooks and visualization

Tool	How	Docs
Jupyter	`refract-py` → pandas DataFrame → matplotlib/Altair.	Python SDK tutorial
Observable Framework	`@refract-org/observable` data loader.	Notebooks
Marimo	Reactive notebook runtime for live event stream analysis.	Notebooks
Mermaid / Graphviz	`refract visualize --format mermaid` produces diagrams.	CLI

Monitoring and alerting

Tool	How	Docs
Cron / systemd timers	`refract cron` — one-shot re-observation for scheduled monitoring.	Scheduled monitoring tutorial
GitHub Actions	`.github/workflows/observe.yml` — daily scheduled observation with auto-commit.	Scheduled monitoring tutorial
Slack	`--notify-slack` posts Block Kit-formatted messages with event summaries.	Scheduled monitoring tutorial
Email	`--notify-email` sends SMTP alerts.	Scheduled monitoring tutorial
Webhooks	`--notify-webhook` POSTs JSON event summaries to any endpoint.	Scheduled monitoring tutorial

Infrastructure

Tool	How	Docs
Docker	`Dockerfile` in the refract repo. `docker build -t refract .`	Install
AWS Lambda	Run `refract cron` in a Lambda function with a 15-minute timeout.	Cron
Cloudflare Workers	Run `refract` via `npx` in a Worker. Store events in D1, export to R2.	Downstream
Private wikis	Bearer token, basic auth, OAuth2. `--api-key`, `--api-user`, `--api-password`.	Private wiki tutorial

Knowledge graphs and semantic web

Tool	How	Docs
RDF / SPARQL	Convert `wikilink_added`/`category_added` events into triples.	Downstream
Neo4j	Build an evolving entity graph where each edge has a revision timestamp.	Downstream
Vector databases	Store claim embeddings alongside stability metadata for filtered retrieval.	RAG tutorial

Production patterns

Adapter pattern

Use a single adapter file as the import boundary between Refract and your codebase:

// adapter.ts — single import boundary
export type { EvidenceEvent, FactProvenance } from '@refract-org/evidence-graph';
export { sectionDiffer, citationTracker } from '@refract-org/analyzers';

No other file imports from @refract-org/* directly. This isolates version upgrades to one file.

Batch processing

refract analyze --pages-file topics.txt --depth detailed -c

Process hundreds of pages sequentially. Cache prevents re-fetching. Combine with refract export for structured output.

Scheduled re-observation

refract cron pages.txt --interval 24 -c --notify-slack

Re-observe on a schedule. Detect changes since last run. Notify on new events.

Merkle-verifiable export

refract export "Page" --bundle > bundle.json

Signed bundles with SHA-256 hashes. Downstream systems verify data hasn't been modified since export.

Complementary technologies

A full list of compatible tools is in the downstream integration reference. The Refract event stream is standard JSON/NDJSON — anything that reads JSON or speaks HTTP can consume it.