mcp-fanout-sync (premium)

Single source of truth for MCP server registration across every coding agent. Edit ~/.aria/mcp.json once → fans out to Claude / Cursor / Cline / Codex / OpenCode in each one's native format.

Install

git clone git@github.com:iansteitz1-eng/aria-skills-premium.git
pip install pyyaml tomli tomli-w
mkdir -p ~/.aria
touch ~/.aria/mcp.json   # if you don't have one

Author your canonical config

~/.aria/mcp.json:

{
  "mcpServers": {
    "aria-tools": {
      "url": "https://mcp.ariacode.io/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Dry-run (default — see what would change)

python3 script.py

Reports per-target diff without writing.

Apply

python3 script.py --apply

Writes to every detected agent config. Pre-existing entries in target configs that didn't come from ~/.aria/mcp.json are preserved (additive sync).

Strict mode (overwrite target configs)

python3 script.py --apply --strict

Replaces each target config entirely with the rendering of ~/.aria/mcp.json. Use with care — preserves a backup.

Restore from backup

Every write creates a <path>.aria-backup-<timestamp>. To roll back:

python3 script.py --restore-from 2026-05-26T18-30Z

Extending — add a new agent

1. Add a row to targets.yaml with the agent name, config path, and schema module.
2. Drop a transformer at schemas/<agent>.py exposing from_canonical(canonical: dict) → str and to_canonical(raw: str) → dict.
3. Re-run python3 script.py — the new agent auto-detects if its config dir exists.

License

Proprietary — premium tier. Included in Aria Partner subscription.