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_projectinstall_precommit_guarduninstall_precommit_guard

Identity

Create or update persistent agent identities and profile metadata.

register_agentcreate_agent_identitywhoisresolve_pane_identitycleanup_pane_identitieslist_agents

Messaging

Coordinate work asynchronously with durable, threaded, auditable messages.

send_messagereply_messagefetch_inboxacknowledge_messagemark_message_read

Contacts

Control who can message whom across teams and projects.

request_contactrespond_contactlist_contactsset_contact_policy

File Reservations

Advertise file ownership intent and avoid stepping on parallel edits.

check_file_reservation_conflictsfile_reservation_pathsrenew_file_reservationsrelease_file_reservationsforce_release_file_reservation

Search

Recover context rapidly from message history and thread archives.

search_messagessummarize_thread

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_linksearch_messages_productfetch_inbox_productsummarize_thread_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/{slug}

Inspect active lease ownership and expiry windows.

resource://tooling/metrics

Expose throughput, error, and latency telemetry snapshots.

resource://tooling/diagnostics

Report storage, search, and tool diagnostics.

resource://tooling/capabilities/{agent}

Inspect an agent's advertised capability profile.

TUI Screens

Dashboard

Is the system healthy and active right now?

inbound message ratereservation conflictsservice health

Messages

Which coordination messages need attention?

importanceack requiredsender and project

Threads

How did this decision evolve over time?

participantsopen action itemsdecision checkpoints

Agents

Who is online and what are they doing?

last activetask descriptionprogram/model

Search

Which messages, agents, or projects match these facets?

cross-surface resultsfacet filtersthread and date scope

Reservations

Where are file ownership conflicts emerging?

path overlapsexclusive holdersTTL expiration

Tool Metrics

Which tools and transports are hot or failing?

call volumeerror ratetail latency

System Health

Are the database, queues, and connections healthy?

database healthqueue pressureconnection probes

Timeline

What happened, and in what order?

message lifecyclereservation changesevent timestamps

Projects

Which projects are carrying the coordination load?

message countsagent countsreservation counts

Contacts

Can this agent message that agent right now?

approval statepolicy modecross-project links

Explorer

Which inbound or outbound messages match this operational slice?

directiongroupingack status

Analytics

Which anomalies deserve investigation next?

confidence scoreactionable next stepdeep-linked evidence

Attachments

Which attachment should I inspect, and where did it come from?

inline previewsource provenancesender context

Archive Browser

What does the canonical Git archive contain?

directory treefile previewaudit trail

ATC

Are agents live, conflicting, and backed by decision evidence?

agent livenessconflict decisionsevidence ledger

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