Mindbase

Find pages connected to a given page via wikilinks, shared tags, or shared sources. Returns a ranked list with the connection reason.

Mark two pages as containing contradictory claims that the user should review. Use when the new content directly conflicts with statements in an existing page. The pages are NOT modified — this is a notice for the human.

Generate a morning brief summarizing recent wiki activity with [N] citations. Default 24h lookback. Does not email — for that use the web UI Settings → Daily Brief → Send Now.

Compute graph insights for the wiki: top hubs, orphans, broken links, fragmented tag clusters.

Get today's (or a specific date's) wiki pulse: weekly writes, new connections, contradictions, stale notes, SRS due count. Use to give the user a daily situational awareness of their knowledge base.

Conversational ingest, step 2 of 2. Commits the user-approved subset of a plan returned by ingest_plan. `approvals` is a map of action id → boolean; omitted ids default to approved (true). Returns the per-action results plus a summary of what got created / updated.

Conversational ingest, step 1 of 2. Reads the source, returns the LLM's narrative takeaways and a structured plan of proposed actions — without writing anything yet. The user reviews the takeaways + plan, decides which actions to approve, and then calls ingest_execute(planId, approvals) to commit the approved subset.

Ingest a new source into the wiki: saves the raw text, runs LLM compile to create/update wiki pages, applies cross-linking. Returns a summary of changes.

Add a typed edge between two existing pages. Use this to capture relationships you observe but the body text does not explicitly include via [[wikilinks]]. Edge type must be one of: mentions, elaborates, cites, contradicts, supersedes, is_a, part_of, example_of.

List recent chat sessions saved in MindBase, newest first.

List all RSS feeds the user is subscribed to, with stats (last poll time, items ingested, errors). Use this when the user asks "what feeds am I subscribed to?" or wants to check their RSS subscriptions.

List wiki pages added or updated within the past N days, newest first.

List spaced-repetition review cards. By default returns cards due now (due_only=true). Use this to conduct an interactive review session: list due cards, present each Q to the user, wait for their answer, call answer_card, repeat.

Propose that two pages are duplicates of the same concept and should be merged. NEVER applied automatically — queued for human review in the audit log. Use sparingly: prefer link or flag_contradiction unless you are confident the two pages cover the same thing.

Append a structured entry to logs/<today>.md. Format: ## [YYYY-MM-DD HH:MM] {operation} | {topic} | {details}

Overlay a schema template onto an existing project. Appends template prose to README.md and seeds template-specific sections in context.md. Idempotent — re-running with same template is a no-op marker.

Write new content into context.md atomically. Steps: (1) snapshot current context.md → state/builder/snapshots/<timestamp>.md, (2) tmpwrite + rename, (3) append log entry. Enforces 400-line cap by truncating overflow to sources/research/<auto>.md.

Append a contributor entry to the current project. Writes to sources/contributors/<user>/<YYYY-MM-DD>.md (append-only) plus log entry. Route mode forces routing: auto (LLM decides), daily (only contributor file), concept (also flag for /mb:build to extract concept), daily+concept (both).

Export a project to a portable artifact. markdown-bundle: copies project tree to artifacts/exports/<projectId>-<timestamp>/. zip-archive: same plus zips (uses `zip` if available).

List contributor + research files modified since the last build (or since a given ISO date). Returns paths + sizes + mtimes. Used by /mb:build to know what to synthesize.

Ingest a file (PDF, .md, or .txt) into a project: archives the original into sources/raw/<date>/, extracts text locally (pdfjs for PDFs — no API call), writes an .extracted.md sidecar for PDFs, and returns the text. Accepts a local absolute path OR an http(s) URL that points directly at a file (e.g. an arXiv PDF link) — URLs are downloaded first. After calling this, discuss the key takeaways with the user and file a summary via mindbase_contribute.

Scaffold a new MindBase project with the v2 layout: README.md, context.md, index.yaml, sources/contributors/, sources/research/, sources/raw/, state/, logs/, artifacts/. Idempotent — refuses to overwrite existing project.

Load the README + context + index.yaml for a project (defaults to currentProjectId in config.json). Returns the three file bodies for context injection. Read-only by default; pass persist=true to also update config.json currentProjectId (i.e. switch the active project).

Migrate one or all projects from legacy wiki/ layout to v2 layout. Snapshots to archive/<projectId>-<unixTs>/ first; idempotent on re-run.

Regenerate index.yaml by scanning the project tree. Always overwrites; never partial-merges. Output schema: { project, files, contributors, sources, last_build }.

Save research findings to sources/research/<slug>.md. Appends if file exists; otherwise creates. Always appends a log entry.

Project dashboard: last build time, line counts, contributor stats, recent operations, file counts. Read-only.

Validate that a project conforms to the v2 layout. Returns list of missing required files/dirs. Used as a precondition guard by /mb:build and /mb:migrate.

Update an existing wiki page by replacing the content under a specific H2 section. Use when the new content adds detail or revises an existing concept. PREFER this over create_concept when any existing page in <context> is even loosely related.

Save content to the inbox for later batch processing (NOT a direct wiki note). Use this for "save this for later, I will categorize it myself in the MindBase UI". To create a wiki note directly, use create_note instead.

Read the full body of an existing wiki concept page. Use this before deciding whether to create a new concept or append/update an existing one. Returns the markdown body, truncated at 30000 chars if longer.

Read the full content of a wiki file. Use sparingly — only files you actually need.

Read the full content (markdown body + frontmatter + incoming/outgoing wikilinks) of a wiki page by its slug.

Search past saved chat conversations by content. Returns matching chats with previews.

Replace the full content of an existing concept article. Use during L2 health checks to improve low-quality articles.

Run the full Wiki Health pipeline: build graph → generate insights → auto cross-link → L2 lint. Writes _insights.md and applies improvements.

Save a fragment of the current AI conversation as a wiki page. LLM auto-titles it if no suggested_title. Marks `created_via: mcp` for audit.

Search the user's wiki across EVERY project (not just the current one). Returns ranked matches with their owning project id, suitable for citing as `[[<project>/<slug>]]` cross-project wikilinks. Use this when answering open-ended "have I seen this before" questions or proposing cross-project bridges during ingest.

Search the wiki, restricted to pages tagged with a specific project (uses the `project` frontmatter field).

Full-text search across the user's MindBase wiki — matches page titles, one-liners, and slugs. Returns ranked list with snippets.

Embedding-based semantic search across the wiki. Falls back to keyword search if embeddings are unavailable.

Set the visibility level of a wiki page. "internal" and "pii" pages are excluded from semantic search and Q&A by default.

Conclude that no action is needed for this raw source. Use when (a) the content is already covered by existing pages, (b) the content is too low-quality to add to the wiki, or (c) the content is off-topic. Logged but produces no changes.

Suggest wikilinks that should be added to a specific page (review mode — does NOT modify the page).

Synthesize what the user's wiki collectively knows about a topic. Returns structured threads with row-level citations, contradictions, and gaps. Cached; pass force_refresh: true to regenerate.

Add or replace tags on a wiki page. mode: "add" merges with existing tags (default); "replace" overwrites.

Update a specific section of an existing wiki page with new/better content. If the section does not exist, it is appended.

Replace the content under a section heading on an existing page. Refuses to modify human-edited pages unless force: true.

Update a concept's one-liner summary in its meta.json and INDEX.md.

Declare which concepts cite this raw source. Writes wiki/sources/<raw_id>.md.