Spec Index

Spec Explorer

Read the full MCP Agent Mail technical corpus with fast search, category filters, and an optimized split-pane reader built for real implementation work.

Documents

Technical Surface Map

An at-a-glance reference for every tool cluster, resource URI, TUI screen, and robot command track in Agent Mail.

Tool Clusters

Infrastructure

Bootstrap project context, health checks, and server lifecycle visibility.

health_checkensure_projectmacro_start_session

Identity

Create or update persistent agent identities and profile metadata.

register_agentcreate_agent_identitywhois

Messaging

Coordinate work asynchronously with durable, threaded, auditable messages.

send_messagereply_messagefetch_inboxacknowledge_message

Contacts

Control who can message whom across teams and projects.

request_contactrespond_contactset_contact_policy

File Reservations

Advertise file ownership intent and avoid stepping on parallel edits.

file_reservation_pathsrenew_file_reservationsrelease_file_reservations

Search

Recover context rapidly from message history and thread archives.

search_messagessummarize_threadsearch_messages_product

Macros

Collapse common multi-step workflows into one predictable tool call.

macro_start_sessionmacro_prepare_threadmacro_file_reservation_cyclemacro_contact_handshake

Product Bus

Link multiple repos under one product-level coordination surface.

ensure_productproducts_linkfetch_inbox_product

Build Slots

Throttle expensive builds/tests to prevent CI or machine contention.

acquire_build_slotrenew_build_slotrelease_build_slot

Resource URIs

resource://inbox/{agent}

Read latest inbox messages without issuing tool calls.

resource://thread/{thread_id}

Retrieve thread history in one structured snapshot.

resource://agents/{project_key}

Enumerate known agents and their contactable identities.

resource://file_reservations/{project_key}

Inspect active lease ownership and expiry windows.

resource://contacts/{agent}

Show contact graph and approval state.

resource://metrics/{project_key}

Expose throughput/error/latency telemetry snapshots.

resource://health

Report service readiness and degraded-mode signals.

TUI Screens

Dashboard

Is the system healthy and active right now?

inbound message ratereservation conflictsservice health

Inbox Browser

What requires my immediate response?

importanceack_requiredthread continuity

Thread Explorer

How did this decision evolve over time?

participantsopen action itemsdecision checkpoints

Agent Roster

Who is online and what are they doing?

last activetask descriptionprogram/model

Reservation Manager

Where are file ownership conflicts emerging?

path overlapsexclusive holdersTTL expiration

Unified Search

Where is the prior context for this topic?

query relevancethread_idsender filters

Contact Graph

Can this agent message that agent right now?

approval statepolicy modecross-project links

Macro Inspector

Which high-level workflows are available and safe?

macro preconditionsside effectsresult payload shape

Build Slots

Are build leases saturating shared infrastructure?

active holdersexpiryexclusive contention

Product Bus

How are projects linked under shared products?

linked reposcross-project trafficsearch scope

Audit Timeline

What happened and when?

message lifecyclereservation changesidentity updates

System Health

Which subsystem is degraded?

DB pool pressuresearch fallbacktransport status

Human Overseer

How can an operator redirect execution quickly?

compose pathrecipient targetingimportance overrides

Tool Metrics

Which tools are hot or failing?

call volumeerror ratetail latency

Theme + Session Status

Is this session readable and context-aligned?

active themeconnection statustime windows

Robot Command Tracks

Situational Awareness

Get fast status before taking action.

am robot status --format toonam robot health --format json

Message Triage

Prioritize and acknowledge inbound coordination tasks.

am robot inbox --format json --agent GreenCastleam robot thread --format md bd-123

History Retrieval

Recover past decisions before proposing changes.

am robot search --format json "auth refactor"am robot thread --format md bd-123

Edit Safety

Inspect ownership and avoid reservation collisions.

am robot reservations --format jsonam robot health --format json

Operator Reporting

Produce machine-readable snapshots for automation and dashboards.

am robot status --format json > status.snapshot.jsonam robot health --format json > health.snapshot.json