agent-mail

name	agent-mail
description	MCP Agent Mail for multi-agent coordination. Use when agents need file locks, messaging, inboxes, or conflict prevention. Handles macro_start_session, file_reservation_paths, send_message, threading, pre-commit guards.

Using MCP Agent Mail

Core Insight: Without coordination, multiple agents overwrite each other's work. Agent Mail provides identities, messaging, and file reservations to prevent conflicts.

When to Use What

Situation	Action
Starting any agent session	macro_start_session
About to edit files	file_reservation_paths → edit → release_file_reservations
Need to tell another agent something	send_message with thread_id
Picking up someone else's work	macro_prepare_thread
Can't message an agent	request_contact → wait for approval
Server seems broken	Use health_check() first; CLI-only: doctor check --verbose → doctor repair --yes

---

THE EXACT PROMPT — Session Bootstrap

Call this at the start of every agent session:

macro_start_session(
  human_key="/abs/path/to/project",
  program="claude-code",
  model="YOUR_MODEL",
  task_description="Working on auth module"
)

Returns: {project, agent, file_reservations, inbox}

This single call: ensures project exists → registers your identity → fetches inbox.