Product C · multi‑agent coordination protocol

MACP

The protocol that lets many AI agents from different vendors work in parallel on the same repository without stepping on each other. Path claims, inboxes, handoffs and signed events instead of guesswork — in plain files that git already understands. No server, no cloud, no telemetry.

4 or 1024 agents — the same protocol
Every event signed (ed25519) · replay to any past instant
Claude Code · Codex · Gemini CLI · opencode · Warp · local models
Problem01

One agent is a tool.
Ten are traffic without lights.

Teams now run agents from several vendors at once: one writes code, another tests, a third documentation. Each has its own log and its own session memory. None of them knows what the others are doing right now — so they overwrite each other’s files, duplicate work and lose context at every handover.

MACP gives them a shared language and a shared memory: who holds what, who finished what, who handed what to whom. Recorded in the repository so it can be read in code review and checked after the fact.

Protocol02

Three ideas.
Files, MCP, signature.

files01/03

All state in .coord/

Agent cards, claims, event log, inboxes, handoffs, decisions — plain YAML, JSONL and Markdown inside the repository. No daemon, no database, no central server.

no server · git-native
mcp02/03

Anyone who speaks MCP can join

The MACP server exposes 60+ typed coordination tools. The same server serves Claude Code, Codex, Gemini CLI, opencode, Warp and clients that do not exist yet. About 4k tokens instead of a 40k prompt.

vendor-neutral · peer-to-peer
signed03/03

Every event signed

A log entry carries the identity [agent:session:model] and an ed25519 signature. From the same log MACP rebuilds the workspace state at any past instant.

ed25519 · replay
Agent conversation03

Five sentences
agents say to each other.

01
Claim
Before an agent touches a file, it reserves the path. A collision returns the owner and the TTL — not an overwritten file.
claim‑before‑handoff
02
Inbox
Short messages between agents: scope, question, warning. Read at session start, not after the damage.
peer‑to‑peer
03
Handoff
Work passed on with a task card, a summary and a validator trail. The next agent starts exactly where the previous one stopped.
atomic
04
Done
Closing goes through schema and signature validation. A task cannot be finished on a broken state.
validate‑before‑done
05
Decision
A vote on a protocol change or a human approval — also an event in the log, with a signature.
human‑in‑the‑loop
Scale04

4 or 1024.
The same protocol.

There is no central hub to scale. Agents talk to each other through files; every instance — including many sessions of the same model — has its own identity and its own key. Adding an agent means adding a card in .coord/agents/.

The cost of entry does not grow with the number of agents: MCP tools are shared and a per‑agent adapter weighs a few dozen tokens. While building MACP itself, agents from four vendors worked in parallel on one repository — without a single file ownership conflict.

▸ click the agent counter in the diagram above — and watch what happens to the log

Sovereignty05

Your repository.
Your keys. Your models.

local‑firstA

Works offline

The whole protocol lives inside the repository directory. No hosted service, no telemetry, no vendor account.

air‑gap · no telemetry
keysB

Customer‑held keys

Agent identity on ed25519 keys the organisation keeps. Signed releases, SBOM, build provenance.

ed25519 · SBOM · provenance
modelsC

Models that never leave

Adapters for local models — Ollama, llama.cpp, vLLM, LM Studio — for tasks that cannot leave the organisation’s network.

sovereign adapters

> Specification: handbook v1.0 (22 sections) as the single source of truth; reference implementation in TypeScript — seven packages, CLI, MCP server, terminal dashboard and a macOS app.
> Sovereignty Pack at release‑candidate stage (v1.12).

System description06

A separate product.
A shared proof.

MACP is a standalone product, developed independently of Coord Control. It runs without it — in the terminal, with a text dashboard and a macOS app. Coord Control is the local operations layer on top of MACP workspaces: oversight, decision gates and the evidence pack. War Room was built entirely by agents working over MACP.

Delivery covers initialising .coord/ in the client’s repository, wiring adapters to the agents in use, and handing the team the handbook and the signing policy.

Intellectual property07

Protecting
the technological edge.

Familycandidate

MACP chain of custody

A way of binding the events of many agents into one verifiable evidence chain — signature, order, reproducibility.

in preparation · details confidential
Specificationhandbook v1.0

Documentation as evidence

Every protocol change is a signed entry: postmortem, proposal, vote, ratification. The history of the spec is itself an evidence chain.

ratified · May 2026
RelatedP.456328

Proving the actual effects of agent actions

The Coord Control patent application. MACP supplies the event layer on which that proof is built.

application filed · UPRP · July 2026

> The “MACP chain of custody” family remains in preparation — number and priority date will follow filing.
> Filing an application does not equal a grant of protection.

Want to see how
your agents talk to each other?