Kiro Agent-Mailbox
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| AGENT_MAILBOX_DIR | No | Directory used to store Agent-Mailbox state. Optional; defaults to ~/.agent-mailbox. | ~/.agent-mailbox |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| registerA | Registriert die aktuelle Session unter einem frei waehlbaren Namen im Agent-Mailbox-System, damit andere Sessions ihr Nachrichten schicken koennen. Args: name: Gewuenschter Anzeigename der Session (z.B. "devops", "backend-dev"). Muss aktuell nicht bereits von einer anderen AKTIVEN Session belegt sein. |
| list_agentsA | Listet alle registrierten Agent-Sessions mit Namen, Arbeitsverzeichnis und Aktivitaetsstatus auf. Vor dem Senden einer Nachricht aufrufen, um zu sehen, welche Namen aktuell verfuegbar sind. Args: include_inactive: Wenn True, werden auch Sessions angezeigt, deren Heartbeat laenger als 30 Minuten zurueckliegt (als "inactive" markiert statt ausgefiltert). |
| send_messageA | Sendet eine Nachricht an eine andere registrierte Agent-Session. Die Zielsession sieht die Nachricht beim naechsten Aufruf von check_inbox (typischerweise automatisch zu Beginn ihres naechsten Turns). Args: to: Name der Zielsession, wie in list_agents angezeigt. text: Inhalt der Nachricht (Aufgabe, Frage, Information). |
| check_inboxA | Prueft die eigene Inbox auf neue, noch offene Nachrichten und aktualisiert gleichzeitig den eigenen Heartbeat (haelt die Registrierung aktiv). Sollte am Anfang jedes Turns aufgerufen werden. |
| replyA | Beantwortet eine erhaltene Nachricht und markiert sie als bearbeitet. Die Antwort wird dem urspruenglichen Absender in dessen Inbox zugestellt. Args: message_id: Die id der Nachricht aus check_inbox, die beantwortet wird. status: Kurzer Status, z.B. "erledigt", "issue_angelegt", "abgelehnt". text: Freitext der Antwort (z.B. was gemacht wurde oder Issue-Link). |
| check_repliesA | Prueft, ob auf eigene gesendete Nachrichten geantwortet wurde. Antworten liegen als Eintraege mit type="reply" in der eigenen Inbox und werden hierueber separat von normalen Nachrichten ausgewertet. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
register, list_agents, send_message, and reply each target a distinct action. However, check_inbox and check_replies overlap conceptually, since replies are described as arriving in the same inbox with type="reply", making it unclear why they require separate tools.
Four tools follow a clear verb_noun pattern (list_agents, send_message, check_inbox, check_replies), while register and reply are bare verbs. Minor deviation but overall predictable and readable.
Six tools is well-scoped for an agent messaging system, covering registration, discovery, sending, receiving, replying, and reply-checking without redundancy.
The core message lifecycle (register, list, send, receive, reply, check replies) is well covered. Minor gaps exist: no deregistration, no broadcast/multi-recipient send, and no way to mark a message handled besides replying.