MCP-native · BSL 1.1 · Open-core

Turn markdown into
an AI oracle.

Oraclize converts any directory of documentation into a search-powered MCP server. AI coding agents query your architecture docs, runbooks, and ADRs through standardized tools — zero custom server code.

Start for free View on GitHub

terminal

$ pip install oraclize[mcp]
Collecting oraclize[mcp]...
✓ Successfully installed oraclize-0.8.0

$ oraclize init --name my-oracle
Scaffolding project structure...
✓ Created knowledge/ procedures/ policy/ tracker/

$ oraclize serve
Indexing 47 documents with BM25...
✓ MCP server running on stdio
Tools: oraclize_search oraclize_get_doc oraclize_list_docs
       oraclize_get_policy oraclize_create_backlog_item
       +21 more tools registered

◆BM25 full-text search◆Model Context Protocol◆Zero-config startup◆Policy enforcement◆Work item tracker◆Claude · Cursor · Copilot · Gemini◆BSL 1.1 open core◆ADRs · Runbooks · Architecture docs◆BM25 full-text search◆Model Context Protocol◆Zero-config startup◆Policy enforcement◆Work item tracker◆Claude · Cursor · Copilot · Gemini◆BSL 1.1 open core◆ADRs · Runbooks · Architecture docs

// How it works

Ship the engine,
let developers bring their own knowledge.

Drop your markdown files in, run one command, and every AI agent you connect has instant access to your institutional knowledge through standardized MCP tools.

01

📁

Write docs

Author markdown files in knowledge/ and procedures/ — your architecture decisions, runbooks, and domain knowledge.

02

⚡

Auto-index

Oraclize ingests and indexes everything using BM25 full-text search. No embeddings, no vector DBs, no external API calls — runs entirely local.

03

🔌

Connect agents

Point Claude, Cursor, Copilot, or any MCP-compatible agent at your oracle. They query via 26 standardized tools — no custom code needed.

04

📋

Govern & track

Optionally add policy rules and a work tracker. Agents can create and update backlog items, and validate their output against your policies.

26

MCP tools out of the box

0

Config files required

4

AI providers supported

BSL

Open-core license

// MCP Tools

Everything your agent
needs to reason well.

26 standardized tools covering search, document retrieval, policy enforcement, and backlog management — all exposed through the Model Context Protocol.

oraclize_search

BM25-ranked full-text search with document type filtering and configurable score thresholds.

oraclize_get_doc

Fetch any document by path, with optional section extraction for pinpoint retrieval.

retrieval

oraclize_list_docs

Enumerate all indexed documents with metadata — useful for agent orientation.

retrieval

oraclize_get_policy

Retrieve a specific policy rule by ID so agents know what constraints apply.

policy

oraclize_query_policies

Filter policy rules by tier, category, repository, or language — scoped governance.

policy

oraclize_validate_meta_block

Validate agent JSON meta-blocks against your policy ruleset before any action is taken.

policy

oraclize_get_context

Full agent grounding — returns policies, recipes, pitfalls, experts, and usage stats in one call.

agent

oraclize_get_agent_context

One-call grounding — returns policies, recipes, pitfalls, and expert profiles in a single request.

agent

oraclize_create_doc

Create new codex documents by path — agents can author knowledge as they learn.

docs

oraclize_list_backlog

List all work backlog items, filterable by status — for agentic task planning.

tracker

oraclize_create_backlog_item

Let agents create new work items directly from their workflow — async by design.

tracker

oraclize_generate

Auto-generate AGENTS.md, CONSTITUTION.md, and CONTEXT.md from your knowledge base.

generation

"AI coding agents are only as good as the context they operate in. Oraclize gives them your actual institutional knowledge — not hallucinations."

Ship the engine, let developers bring their own knowledge

// CLI-first

Powerful defaults,
total control.

Zero config to get started. Full YAML-driven customization when you need it. Works with every major AI coding assistant out of the box.

oraclize.yaml

name: "my-project"
version: "1.0.0"

search:
  min_score: 0.5
  aliases:
    k3s: "kubernetes k3s"

policy:
  enabled: true
  rule_id_pattern: "R-[A-Z]+-\d{2}"

tracker:
  enabled: true
  backlog_file: "tracker/backlog.yaml"

Supported providers

claudecursorcopilotgemini

The full CLI gives you everything you need to manage your oracle from the command line — search, validate, generate, and instruct.

Core commands

oraclize initScaffold new project

oraclize serveStart MCP server

oraclize searchQuery knowledge base

oraclize generateGenerate AGENTS.md etc.

oraclize instructProvider instructions

oraclize validateCheck project structure

oraclize policyQuery policy rules

oraclize backlogManage work items

oraclize scanScan & index codebase

Zero config to start

Just put docs in knowledge/ and run oraclize serve. No YAML required.

// Pricing

Open source core.
Enterprise control plane.

The engine is BSL 1.1 licensed — free forever for individual and internal use. The control plane adds team management, analytics, and SLA-backed support for organizations running Oraclize at scale.

Open Source

Community

$0 / forever

Full MCP server, all 26 tools, BM25 search, CLI. BSL 1.1 licensed. Self-hosted. No limits.

✓All 26 MCP tools
✓BM25 full-text search
✓Policy engine
✓Work item tracker
✓All 4 AI provider integrations
✓Zero configuration startup
✓Self-hosted, unlimited projects
—Control plane dashboard
—Team management
—Usage analytics

View on GitHub →

Control Plane · Starter

Starter

$49 / seat / mo

Everything in Community, plus a hosted control plane for teams managing oracles across repos.

✓Everything in Community
✓Hosted control plane dashboard
✓Up to 5 repos · 5 seats
✓Core + community plugins
✓Weekly governance reports
✓Cascade PR automation
✓Email support (48h SLA)

Request access →

Control Plane · Pro

Pro

$99 / seat / mo

Scale across your organization with all plugins, daily governance, and advanced analytics.

✓Everything in Starter
✓Up to 25 repos · 25 seats
✓All plugins
✓Daily governance reports
✓Advanced query analytics
✓Priority email support (24h SLA)

Request access →

Control Plane · Enterprise

Enterprise

Custom 

Unlimited scale with compliance, SSO, real-time governance, and dedicated support.

✓Everything in Pro
✓Unlimited repos & seats
✓All plugins + custom
✓Real-time governance reports
✓SSO / SAML integration
✓Field-level encryption & RBAC
✓Dedicated support + SLA

Feature comparison

Feature
Community
Starter
Pro
Enterprise

All 26 MCP tools

✓

BM25 search + policy engine

✓

Self-hosted deployment

✓

Control plane dashboard

—

✓

Team & access management

—

✓

Governance reports

—

Weekly

Daily

Real-time

Query analytics & audit logs

—

✓

SSO / SAML

—

✓

SLA-backed support

—

48h

24h

Custom

Frequently asked questions

Everything you need to know about oraclize.

Turn markdown intoan AI oracle.

Ship the engine,let developers bring their own knowledge.

Write docs

Auto-index

Connect agents

Govern & track

Everything your agentneeds to reason well.

Powerful defaults,total control.

Open source core.Enterprise control plane.

Frequently asked questions

Turn markdown into
an AI oracle.

Ship the engine,
let developers bring their own knowledge.

Everything your agent
needs to reason well.

Powerful defaults,
total control.

Open source core.
Enterprise control plane.