MindSync MCP server — local-first multi-agent memory sync and focus conflict detection
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"mindsync-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# MindSync MCP [](https://github.com/adityarya24/mindsync-mcp/actions/workflows/ci.yml) Local-first **Model Context Protocol** server for multi-agent memory sync and focus conflict detection. Use it when several coding agents (Claude Code, Codex, Cursor, Gemini CLI, Grok, custom agents, …) share one developer machine and need: 1. A shared session/focus registry (who is editing what) 2. Conflict warnings when focuses overlap 3. Optional durable fact sync to **your** remote host over SSH (offline queue when remote is down) No cloud account. No hard-coded hosts or home directories. ## Features | Tool | Purpose | | --- | --- | | `get_sync_context` | Load local state + compiled truth (optional remote pull) | | `update_focus` | Per-agent focus/project/branch (+ optional paths); conflict warnings | | `queue_durable_fact` | Write fact remotely, or queue offline if unreachable / unconfigured | | `sync_offline_facts` | Flush offline queue; consolidate + pull truth | | `pull_truth` | Windows-safe SCP pull of compiled-truth markdown | | `health` | Paths, queue depth, remote reachability | Design principles: 1. **Offline-first** — local tools always work; remote is opt-in and best-effort. 2. **Locked local state** — exclusive lockfiles around state/queue writes. 3. **Safe remote writes** — identifier allowlists + base64 text transport over SSH. 4. **No false-positive conflicts** — same project alone is not a conflict; token/path overlap is. 5. **Generic by default** — zero personal paths in code; configure via env. ## Install ```bash git clone https://github.com/adityarya24/mindsync-mcp.git cd mindsync-mcp python -m pip install -e ".[dev]" ``` ## Quick start (local only) No env vars required. State lives under `~/.mindsync`. ### MCP client config After `pip install -e .`: ```json { "mcpServers": { "mindsync": { "command": "mindsync" } } } ``` Or run the module…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.