Sage Wiki

sage-wiki

Local-first knowledge graph that compiles documents into an interlinked, human-readable wiki with provenance. Exposes 19 MCP tools over stdio/SSE and a versioned REST API under /v1/. Output is Obsidian-compatible markdown.

How to connect

MCP (primary): The server runs as a subprocess over stdio, or over SSE/HTTP:

{
  "mcpServers": {
    "sage-wiki": {
      "command": "sage-wiki",
      "args": ["serve", "--transport", "stdio", "--project", "/path/to/wiki"]
    }
  }
}

REST (/v1/): When the server is running with --ui, the REST facade is at /v1/. Auth is Bearer-token (same as SAGE_WIKI_TOKEN); loopback is zero-config. All errors use a fixed {error: {code, message, details}} envelope.

The 19 MCP Tools

wiki_add_ontology (write)

Create an ontology entity or relation.

• REST: POST /v1/ontology/entities / POST /v1/ontology/relations

  Argument	Type	Required	Default
  entity_id	string	no	—
  entity_name	string	no	—
  entity_type	string	no	—
  relation	string	no	—
  source_id	string	no	—
  target_id	string	no	—

wiki_add_source (write)

Add a source file to a source folder and update the manifest.

• REST: POST /v1/sources

  Argument	Type	Required	Default
  path	string	yes
  type	string	no	—

wiki_capture (write)

Capture knowledge from a conversation or text.

• REST: POST /v1/capture

  Argument	Type	Required	Default
  content	string	yes
  context	string	no	—
  tags	string	no	—

wiki_commit (write)

Git add and commit all changes.

• REST: POST /v1/git/commit

  Argument	Type	Required	Default
  message	string	no	—

wiki_compile (async)

Run the full compile pipeline: diff → summarize → extract concepts → write articles.

• REST: POST /v1/jobs/compile (async — 202 + job_id)

  Argument	Type	Required	Default
  dry_run	boolean	no	false
  fresh	boolean	no	false
  prune	boolean	no	false

wiki_compile_diff (read)

Show added/modified/removed source files compared to the manifest.

• REST: GET /v1/compile/diff

wiki_compile_topic (async)

Compile sources for a specific topic on demand.

• REST: POST /v1/jobs/compile?topic=... (async — 202 + job_id)

  Argument	Type	Required	Default
  max_sources	number	no	—
  topic	string	yes

wiki_graph_query (read)

Answer a relational question by graph traversal: seed entities are resolved from the question (aliases resolve to their canonical entity), a bounded multi-hop subgraph is serialized, and the answer is grounded ONLY in those edges — every citation carries source_doc and confidence provenance.

• REST: POST /v1/graph/query

  Argument	Type	Required	Default
  as_of	string	no	—
  hops	number	no	—
  max_edges	number	no	—
  mode	string	no	—
  question	string	yes

wiki_learn (write)

Store a learning entry for the self-learning loop.

• REST: POST /v1/learnings

  Argument	Type	Required	Default
  content	string	yes
  tags	string	no	—
  type	string	yes

wiki_lint (async)

Run linting passes on the wiki.

• REST: POST /v1/jobs/lint (async — 202 + job_id)

  Argument	Type	Required	Default
  fix	boolean	no	false
  pass	string	no	—

wiki_list (read)

List wiki articles, optionally filtered by entity type.

• REST: GET /v1/entities

  Argument	Type	Required	Default
  type	string	no	—

wiki_ontology_query (read)

Query the ontology graph.

• REST: GET /v1/ontology/{entity}/traverse

  Argument	Type	Required	Default
  depth	number	no	—
  direction	string	no	—
  entity	string	yes
  relation	string	no	—

wiki_provenance (read)

Show source-article provenance.

• REST: GET /v1/provenance

  Argument	Type	Required	Default
  article	string	no	—
  source	string	no	—

wiki_query (compound)

Ask a free-form question against the wiki: searches sources and compiled articles, synthesizes a cited answer with the LLM (spends LLM budget), and files the result to wiki/under_review/ by default (trust output review) or wiki/outputs/ only when trust include_outputs is 'true'.

• REST: —

  Argument	Type	Required	Default
  question	string	yes
  top_k	number	no	—

wiki_read (read)

Read the full content of a wiki article by path.

• REST: GET /v1/articles/{path}

  Argument	Type	Required	Default
  path	string	yes

wiki_search (read)

Search the wiki with hybrid retrieval: BM25 + vector over documents and chunks, fused with ontology-graph proximity.

• REST: GET /v1/search

  Argument	Type	Required	Default
  boost_tags	string	no	—
  channels	string	no	—
  expand	boolean	no	false
  limit	number	no	—
  query	string	yes
  rerank	boolean	no	false
  tags	string	no	—