MCP Tool Reference

Twenty tools across six groups. Every call is automatically scoped to the project attached to your API key — you never pass an org or project ID.

Scope requirements below apply to API keys only. Logged-in sessions are unrestricted, and a key with an empty scope list is unrestricted too.

---

Orientation

wiki_guide

Returns WitWiki's conventions, the read-before-write loop, and the tool list. Intended as the first call of a session.

Parameters: none.

Returns: guidance text.

---

Pages

wiki_getPage

Fetch a page by path.

Returns: path, title, content, metadata, updated_at, created_at.

Errors: not found if the page does not exist.

{"path": "architecture/auth"}

---

wiki_updatePage

Create or update a page. Parses [[wikilinks]] from the content and refreshes the link graph in the same transaction.

Returns: the updated page. Scope: wiki:write.

{
  "path": "decisions/auth-approach",
  "title": "Auth Approach Decision",
  "content": "# Auth Approach Decision\n\nShort-lived JWTs (15 min) with refresh tokens (7 days).\n\nSee also [[architecture/auth]].\n",
  "metadata": {"status": "decided", "date": "2026-04-21"}
}

This overwrites the whole page. There is no merge and no patch. Call wiki_getPage first and reconcile, or you will delete content you never saw. path and title must both be non-empty.

---

wiki_deletePage

Delete a page and cascade-delete its inbound and outbound links. Appends a log entry.

Returns: a confirmation message. Scope: wiki:write. Errors: not found if the page does not exist.

Prefer merging over deleting. After removing a heavily-linked page, run wiki_rebuildGraph to prune stale edges, then wiki_lint to find what now dangles.

Note that the REST equivalent, DELETE /api/pages/{path}, requires the admin role — so the same credential can delete over MCP and be refused over REST. See Concepts.

---

wiki_listPages

List, search, or filter pages.

Returns: {pages: [...]} with path, title, updated_at, created_at.

With q, results are ranked by relevance. With prefix, they're filtered by path. Both can be combined. With neither, you get every page, most recently updated first.

{"q": "authentication JWT refresh"}
{"prefix": "concepts/", "limit": 20}
{"q": "blob encryption", "prefix": "architecture/"}

---

Index

wiki_getIndex

Fetch the index page (always at path index).

Parameters: none.

Returns: the index page. Every project is seeded with one at creation, so this succeeds from the first call; not found means the index was explicitly deleted.

---

wiki_updateIndex

Create or replace the index.

Returns: the updated page. Scope: wiki:write.

Like wiki_updatePage, this replaces the entire page.

---

Log

wiki_appendLog

Append an entry to the chronological log.

Returns: the created entry. Scope: wiki:write.

{
  "kind": "ingest",
  "summary": "ingested RFC 9728 — OAuth protected resource metadata",
  "details": {"source": "rfc9728.pdf", "pages_updated": ["architecture/oauth", "index"]}
}

---

wiki_getLog

Fetch recent log entries, newest first.

Returns: {entries: [...]} with id, ts, kind, summary, details.

---

Health

wiki_lint

Find orphan pages (no inbound links) and dead wikilinks (targets that don't exist).

Parameters: none.

{
  "orphans": ["path/to/orphan-page"],
  "dead_links": [
    {"source": "page/a", "target": "missing/page"}
  ]
}

Run it after a batch of edits, after renames, and whenever someone asks whether anything is broken. Aim for zero dead links; a handful of orphans is usually fine.

---

wiki_rebuildGraph

Re-parse every page and atomically rebuild the whole link graph.

Parameters: none.

Returns: {links_written: <int>, status: "ok"}. Scope: wiki:write.

wiki_updatePage keeps the graph current on its own, so this is for repair, not routine use: after bulk renames, after deleting heavily-linked pages, or when lint still reports dead links you believe you already fixed.

---

Sources

wiki_listSources

List uploaded sources for the project.

Returns: {sources: [...]} with id, filename, content_type, size_bytes, status, blob_key.

Anything with status other than ingested is outstanding work.

---

wiki_getSource

Fetch metadata for one source.

Returns: the source record. Errors: if it does not exist or belongs to another project.

---

source_upload

Upload a file as a raw source.

Returns: the created source record. Scope: source:write.

Standard and URL-safe base64 are both accepted. All three parameters must be non-empty. Because the payload travels inside a tool call, this suits documents rather than large binaries — the web uploader at /sources is the better path for anything sizeable.

---

wiki_deleteSource

Delete a source and its blob.

Returns: {"deleted": "<id>"}. Scope: source:write.

Blob deletion is best-effort; the metadata record is removed either way.

---

wiki_markSourceIngested

Mark a source as ingested once its content is in the wiki.

Returns: the source with status: "ingested". Scope: source:write.

Also appends an ingest-log event, which is what drives the live activity feed in the app. Nothing sets this flag for you: skip it and every future session will re-read the same document.

---

Projects

project_list

List all projects in the organisation. Parameters: none.

Returns: {projects: [...]} with id, org_id, slug, name, created_at.

---

project_get

---

project_create

{"slug": "research-2026", "name": "Research 2026"}

Creating a project does not move your key to it — keys stay bound to the project they were issued for.

---

project_update

Rename a project.

---

MCP resources

Read-only resources some clients can read directly, without a tool call:

Example: wiki://page/concepts/llm-wiki