mindwiki_prepare_context

Build a bounded context plan for a vault task when the user wants MindWiki to choose between saved context packs and general vault retrieval. Returns a strategy, selected packs, supplemental page references, alternatives, rationale, and an optional proposed_pack candidate. Plan mode returns references only; response_mode 'inline' includes page content within the selected budget. Records one context-usage event.

Access

Requires read access and the corresponding vault agent permission. MCP access requires Pro or Power. See Authentication for OAuth versus API key scopes.

Input schema

json

{
  "type": "object",
  "properties": {
    "goal": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "description": "The user's goal in their own words, lightly normalised. E.g. 'analyze my product vision' or 'brief me on MindWiki development'."
    },
    "constraints": {
      "type": "array",
      "maxItems": 20,
      "description": "Optional constraints, domains, or preferences shaping retrieval",
      "items": {
        "type": "string",
        "maxLength": 500
      }
    },
    "preferred_pack": {
      "type": "string",
      "maxLength": 200,
      "description": "Optional explicit pack name or slug to force-load. With mode='force_pack' the router always loads this pack; with mode='auto' it short-circuits scoring."
    },
    "mode": {
      "type": "string",
      "enum": [
        "auto",
        "pack_first",
        "search_first",
        "force_pack",
        "freshen_pack"
      ],
      "description": "auto (default), pack_first, search_first, force_pack, freshen_pack"
    },
    "budget": {
      "type": "string",
      "enum": [
        "tight",
        "balanced",
        "generous"
      ],
      "description": "tight, balanced (default), or generous \u2014 caps pages + token estimate"
    },
    "response_mode": {
      "type": "string",
      "enum": [
        "plan",
        "inline"
      ],
      "description": "plan (default \u2014 return references only) or inline (include page content up to the budget cap)"
    },
    "max_supplemental": {
      "type": "integer",
      "minimum": 0,
      "maximum": 20,
      "description": "Hard limit on supplemental retrieval pages (overrides the budget default)"
    }
  },
  "required": [
    "goal"
  ],
  "additionalProperties": false
}

Client use

Call this tool through tools/call at https://api.mindwiki.io/mcp after initialization and authentication. Check the tool result for errors before reporting success. A proposal creation or apply request is not itself proof that a change was applied; inspect the returned status and verify the result in MindWiki.

See MCP Tools for the complete catalog and Muse for connector availability.