mindwiki_validate_proposal

Validate a proposal payload without saving it. Returns structured errors and warnings with path, code, message, and suggested correction.

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": {
    "type": {
      "type": "string",
      "enum": [
        "edit_note",
        "create_note",
        "merge_notes",
        "split_note",
        "rename_note",
        "move_note",
        "add_tags",
        "update_links",
        "archive_note",
        "flag_contradiction",
        "create_decision",
        "create_summary",
        "create_pattern",
        "create_context_pack"
      ],
      "description": "Proposal type. Applyable in v2.0.0: update_links, add_tags, move_note, create_context_pack. Review-only in v2.0.0: create_note, create_summary, create_decision, create_pattern, rename_note, edit_note, merge_notes, split_note, archive_note, flag_contradiction."
    },
    "target_files": {
      "type": "array",
      "maxItems": 100,
      "description": "Vault paths the proposal would affect",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 1000
      }
    },
    "summary": {
      "type": "string",
      "maxLength": 2000,
      "description": "Human-readable proposal summary"
    },
    "rationale": {
      "type": "string",
      "maxLength": 8000,
      "description": "Why this proposal is useful"
    },
    "risk_level": {
      "type": "string",
      "enum": [
        "safe_additive",
        "safe_structural",
        "risky_structural",
        "content_edit",
        "destructive"
      ],
      "description": "One of: safe_additive, safe_structural, risky_structural, content_edit, destructive"
    },
    "payload": {
      "type": "object",
      "maxProperties": 100,
      "description": "Structured proposal payload"
    },
    "proposal_version": {
      "type": "string",
      "maxLength": 20,
      "description": "Proposal schema version (default 2.0)"
    }
  },
  "required": [
    "type"
  ],
  "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.