Skip to content

index

Jump to bottom
aniongithub edited this page May 19, 2026 · 1 revision

title: Agents type: index

Agents

mind-map's first-class consumer is an AI agent speaking architecture/mcp-server over stdio. The agent reads and writes concepts/pages the same way a human would through the architecture/web-ui — same files, same concepts/wikilinks, same concepts/search.

Why an agent wants a wiki

Problem What the wiki provides
Persistent memory across sessions Markdown on disk, queryable any time
Decision history One page per decision, concepts/backlinks surface "where else this came up"
Project state concepts/frontmatter + concepts/search
Shared context with the human Same files, same UI

Why MCP specifically

Model Context Protocol is the emerging standard for tool-use. By exposing mind-map via MCP, any compliant agent (Claude, Copilot, custom) gets access without bespoke integration.

graph LR
    Claude -->|MCP| MM[mind-map MCP]
    Copilot -->|MCP| MM
    Custom -->|MCP| MM
    MM --> Engine
    Engine --> Files
    Engine --> Index[(SQLite)]
Loading

Design principle

The MCP surface is identical in semantics to what a human sees. There's no "agent-only" data path, no special agent-mode. See design/rationale.

Clone this wiki locally