# SyncytiumMD

> SyncytiumMD is an open-source MCP server for developer tools. Keep AI coding rules once and generate each tool's instruction file, with agent handoff. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows
- **Repository:** https://github.com/mrcbrbn5361/syncytiummd
- **MCP Registry name:** io.github.mrcbrbn5361/syncytiummd
- **Categories:** developer tools
- **Listing updated:** 2026-11-15

## About

Different assistants want different instruction files, so teams end up with drifting copies of the same rules. SyncytiumMD keeps one canonical `.syncytium/` folder in git and transpiles it into files such as CLAUDE.md, AGENTS.md, GEMINI.md, `.cursorrules`, `.clinerules`, `.windsurfrules` and Copilot instructions. Each generated file carries a banner, and `syncytium diff --check` fails CI when any has drifted. `syncytium clean` removes only banner-tagged files.

It also coordinates agents. A lease-based workspace lock with heartbeat, a handoff note saying who has the baton and what is next, and a 100-entry audit trail stop agents overwriting each other. Rules and decisions records can be searched, added and edited from the CLI, and a local 3D graph shows the knowledge structure, bound to 127.0.0.1.

The MCP server exposes 23 tools. Deletions default to dry-run and need explicit confirmation, items are archived to a trash folder so they can be restored, and per-tool rate limits are enforced server-side.

## Features

- **Single source of rules:** Author once in `.syncytium/` and sync to 10 built-in adapters.
- **Drift detection:** `diff --check` exits non-zero in CI when generated files differ.
- **Agent lock and handoff:** Leases, heartbeats and a handoff baton with an audit trail.
- **Safe MCP tools:** Destructive tools default to dry-run and need confirmation.
- **Reverse import:** Migrate existing CLAUDE.md or .cursorrules into the canonical folder.
- **Local knowledge graph:** A 3D graph and document reader served on loopback only.

## Good for

- Maintain one ruleset for Cursor, Claude Code and Copilot
- Fail CI when generated instruction files drift
- Pass work between agents with a recorded handoff
- Record architecture decisions the agents can read

## Install

### Claude Code (Terminal)

```sh
claude mcp add syncytiummd -- npx -y syncytium-md
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "syncytiummd": {
      "command": "npx",
      "args": [
        "-y",
        "syncytium-md"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "syncytiummd": {
      "command": "npx",
      "args": [
        "-y",
        "syncytium-md"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "syncytiummd": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "syncytium-md"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "syncytiummd": {
      "command": "npx",
      "args": [
        "-y",
        "syncytium-md"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "syncytiummd": {
      "command": "npx",
      "args": [
        "-y",
        "syncytium-md"
      ]
    }
  }
}
```

## Tools

- `syncytium_get_context`: Returns the project context.
- `syncytium_handoff`: Records or reads an agent handoff.
- `syncytium_create_rule`: Adds a canonical rule.
- `syncytium_update_rule`: Edits a rule.
- `syncytium_remove_rule`: Removes a rule, dry-run by default.
- `syncytium_record_decision`: Records an architecture decision.
- `syncytium_sync`: Regenerates bridge files.
- `syncytium_diff`: Shows drift.
- `syncytium_doctor`: Runs read-only health checks.
- `syncytium_validate`: Validates config and rules.
- `syncytium_validate_fix`: Fixes validation problems.
- `syncytium_lock_acquire`: Acquires the workspace lock.
- `syncytium_lock_release`: Releases the workspace lock.
- `syncytium_lock_status`: Shows lock status.
- `syncytium_get_graph`: Returns the knowledge graph.
- `syncytium_list_trash`: Lists archived deletions.
- `syncytium_restore`: Restores an archived item.

## FAQ

### Which tools does it generate files for?

Cursor, Claude Code, Copilot, Cline/Roo, Antigravity, Windsurf, Trae, OpenCode, AGENTS.md and GEMINI.md.

### What does it require?

Node.js 20 or later; npx is enough.

### Can the assistant delete rules by accident?

Deletion needs `dryRun: false` and `confirm: true`, and removed items are archived for restore.

### Is the graph exposed on the network?

No. It binds to 127.0.0.1 and rejects non-loopback hosts.

### Is SyncytiumMD free?

Yes. SyncytiumMD is open source, so you can use and self-host it for free.

### How do I add SyncytiumMD to Claude Code?

Run this command in your terminal: claude mcp add syncytiummd -- npx -y syncytium-md

### What are the best alternatives to SyncytiumMD?

The closest alternatives to SyncytiumMD are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/syncytiummd
