MCP Tools

The full list of tools your AI gets access to when it connects to MindWiki via MCP. Twenty tools, grouped by what they do. Read tools require the read scope; write tools require write. OAuth-connected clients get both by default.

ChatGPT-compatible (read-only)

ChatGPT's MCP integration looks for two specific tool names. MindWiki provides them so ChatGPT can use the vault as a knowledge source out of the box.

search

Read-only search across your vault. Returns the most relevant pages for a query.

• Required: query (string)
• Scope: read

fetch

Read-only fetch of a single page by id or path.

• Required: id (string — typically returned by search)
• Scope: read

Reading the vault

mindwiki_search

Hybrid keyword + semantic search. Returns top matches with relevance scores.

• Required: query (string)
• Optional: limit (number, default 10)
• Scope: read

mindwiki_read_page

Read a single page by path.

• Required: path (string — e.g. patterns/feedback-loops.md)
• Scope: read

mindwiki_list_pages

List pages in your vault, optionally filtered by path prefix.

• Optional: prefix (string — e.g. projects/)
• Scope: read

mindwiki_similar

Find pages similar to a given page, using vector similarity.

• Required: path (string)
• Optional: limit (number, default 5)
• Scope: read

mindwiki_graph

Get the knowledge graph as { nodes, edges }.

• Parameters: none
• Scope: read

mindwiki_ask

Synthesize an answer to a question using your vault as context. Returns the answer plus the source pages it drew from.

• Required: question (string)
• Optional: max_pages (number — pages to include as context, default 5)
• Scope: read

mindwiki_get_relevant_context

Retrieve the most relevant pages for a concrete agent goal, with optional constraints. Use this before planning or making changes.

• Required: goal (string)
• Optional: constraints (array of strings), limit (number, default 8, max 20)
• Scope: read

Writing to the vault

mindwiki_write_page

Create or update a page. Provide the full content including frontmatter.

• Required: path (string), content (string)
• Optional: message (string — describes the change for the activity log)
• Scope: write

mindwiki_capture

Quick-capture a thought, note, or link into the vault inbox. Auto-generates a path under capture/.

• Required: content (string)
• Optional: title (string)
• Scope: write

mindwiki_update_index

Rebuild the vault index. Useful after large bulk changes.

• Parameters: none
• Scope: write

Health and integrity

mindwiki_lint

Run a vault health check — orphans, broken links, integrity issues.

• Parameters: none
• Scope: read

Context packs

mindwiki_list_context_packs

List curated context packs available in your vault.

• Parameters: none
• Scope: read

mindwiki_get_context_pack

Load a named context pack with all its included pages.

• Required: name (string)
• Scope: read

Proposals and oversight

mindwiki_create_proposal

Create a pending proposal for a vault change instead of writing directly. The proposal lands in your review queue.

• Required: type (string — e.g. edit_note, merge_notes, move_note, add_tags, update_links, archive_note, flag_contradiction, create_decision, create_summary), summary (string)
• Optional: agent (string), target_files (array of strings), rationale (string), diff (string), payload (object)
• Scope: write

mindwiki_list_proposals

List pending or historical agent proposals.

• Optional: status (string — pending, approved, rejected, applied), limit (number, default 50, max 200)
• Scope: read

mindwiki_get_agent_activity

Return the recent MCP activity log so you (and the AI) can see what's been read, written, proposed, or attempted.

• Optional: limit (number, default 50, max 200)
• Scope: read

mindwiki_list_agent_sessions

List recent AI client sessions including identity, auth method, and last activity.

• Optional: limit (number, default 50, max 200)
• Scope: read

mindwiki_get_agent_operating_guide

Return the user's Agent Operating Guide: the safe-behavior contract, vault model, tool guide, organization guidance, workflows, and optional memory handshake that connected AI clients should read before substantive work.

• Parameters: none
• Scope: read

Quick reference

Where to go next

• MCP Server — the connection itself
• API Access — scopes, keys, REST endpoints
• Sessions & Activity — see tool calls as they happen