Mcp_agent_mail_rust

data-ai MCP Server

Rust MCP server for multi-agent coordination: 34 tools, Git-backed archive, SQLite indexing, advisory file locks, and an interactive TUI console

Verified
data-aidata-ai
5 views89 stars23 forksNOASSERTION

Why This Matters

Discovered via github-topic:mcp and last synced 3mo ago.

Verified
Source
github-topic:mcp
Stars
89
Last synced
3mo ago
Install
Check source

Install

Install instructions not detected yet

Check the source repository for the latest setup steps.

View source instructions
127
Tools
0
Resources
0
Prompts
Standard I/O
Transport

Available Tools (127)

Windows

x86_64

reproduce

detect`

import

status`, `upgrade`, `migrate`, `self-update`, `am-run`, `guard ...`

acks

`pending`, `remind`, `overdue`

macros

`start-session`, `prepare-thread`, `file-reservation-cycle`, `contact-handshake`

legacy

`detect`, `import`, `status`

4

Agents

2

Messages

9

Timeline

16

ATC

HTTP_HOST

`127.0.0.1`

LOG_LEVEL

`info`

AM_TUI_TOAST_INFO_DISMISS_SECS

`5`

AM_TUI_AMBIENT

`subtle`

Agent

Registered worker identity with name, program, model, policy, and task metadata

Crate

Purpose

Startup

`help`

Test

Result

macOS

Apple Silicon

logs

restart`, `check-inbox`

archive-normalize

repair

guard

`install`, `uninstall`, `status`, `check`

agents

`register`, `create`, `list`, `show`, `detect`

flake-triage

`scan`, `reproduce`, `detect`

Messaging

5

Screen

Shows

7

Tool Metrics

14

Attachments

Variable

Default

STORAGE_ROOT

XDG-aware (see below)

AM_TUI_TOAST_POSITION

`top-right`

AM_TUI_COACH_HINTS_ENABLED

`true`

Project

Stable identity for one codebase, keyed by absolute path and slug

BuildSlot

Named lease used to serialize build-heavy work on a shared checkout

Platform

Architecture

am

Recommended CLI entry point.

decrypt

wizard

Family

Current subcommands / modes

mail

`status`, `send`, `reply`, `inbox`, `read`, `ack`, `search`, `summarize-thread`

beads

`ready`, `list`, `show`, `status`

Cluster

Count

Macros

4

11

Contacts

Area

Current modules

HTTP_PATH

`/mcp/`

TUI_HIGH_CONTRAST

`false`

AM_TUI_TOAST_ERROR_DISMISS_SECS

`15`

Path

Purpose

Recipient

Delivery metadata for `to`/`cc`/`bcc`, read state, and acknowledgement state

Depends

Chat logs (if saved)

frankentui

TUI rendering (widgets, themes, accessibility, markdown, syntax highlighting)

Operational

`mail_inbox`, `mail_send`, `mail_search`, `mail_threads`, `doctor_check`, `message_count`, `agents_list`

Problem

Fix

Linux

aarch64

Surface

Best for

tooling

`directory`, `schemas`, `metrics`, `metrics-core`, `diagnostics`, `locks`, `decommission-fts`

share

`export`, `update`, `preview`, `verify`, `decrypt`, `wizard`, `static-export`, `deploy validate`, `deploy tooling`, `deploy verify`, `deploy verify-live`

products

`ensure`, `link`, `status`, `search`, `inbox`, `summarize-thread`

setup

`run`, `status`

Infrastructure

4

5

Search

12

Explorer

TUI

Live human operations and triage

HTTP_BEARER_TOKEN

(from `.env` file)

AM_TUI_TOAST_ENABLED

`true`

AM_TUI_THREAD_PAGE_SIZE

`20`

Thread

Logical conversation identifier spanning replies and summaries

Manual

Build yourself

frankensearch

Hybrid search engine (lexical + semantic, two-tier fusion, reranking)

Feature

MCP Agent Mail

Runtime

`serve-http`, `serve-stdio`, `service install

list

restore`, `doctor check

archive

`save`, `list`, `restore`

doctor

`check`, `archive-scan`, `archive-normalize`, `repair`, `backups`, `restore`, `reconstruct`, `fix`

golden

`capture`, `verify`, `list`

Identity

6

3

Threads

6

Reservations

13

Analytics

Route

What You See

DATABASE_URL

`sqlite:///./storage.sqlite3`

AM_TUI_TOAST_SEVERITY

`info`

AM_TUI_THREAD_GUIDES

`rounded` (theme default)

Type

Role

FileReservation

Advisory lease over file paths/globs with TTL, exclusivity, and reason

beads_rust

Issue tracking integration

457ms

< 1000ms

PASS

150 sends + 300 reads, 0 errors

run

show`, `golden capture

restore

reconstruct

file_reservations

`list`, `active`, `soon`, `reserve`, `renew`, `release`, `conflicts`

robot

`status`, `inbox`, `timeline`, `overview`, `thread`, `search`, `message`, `navigate`, `reservations`, `metrics`, `health`, `analytics`, `agents`, `contacts`, `projects`, `attachments`, `atc`

Contacts

4

1

Dashboard

8

System Health

15

Archive Browser

AM_INTERFACE_MODE

(unset = MCP)

ALLOW_EPHEMERAL_PROJECTS_IN_DEFAULT_STORAGE

`false`

AM_TUI_TOAST_MAX_VISIBLE

`3`

AM_TUI_EFFECTS

`true`

Product

Cross-project grouping for search, inbox aggregation, and routing

ToolMetrics

Per-tool latency, error, and call-count telemetry used by TUI, CLI, and diagnostics

Varies

All in context

Category

Built-in cases

Operation

Baseline p50

Document

Purpose

mcp-agent-mail

Default: MCP stdio transport. HTTP: `serve`.

update

preview

clear-and-reset-everything

Fully reset local state after optional archival. Use sparingly.

projects

`mark-identity`, `discovery-init`, `adopt`

contacts

`request`, `respond`, `list`, `policy`

service

`install`, `uninstall`, `status`, `logs`, `restart`

Search

Search V3 (lexical + semantic + hybrid)

10

Projects

Command

Baseline mean

HTTP_PORT

`8765`

TUI_ENABLED

`true`

AM_TUI_TOAST_WARN_DISMISS_SECS

`8`

WORKTREES_ENABLED

`false`

Message

Canonical envelope for subject, body, importance, thread, attachments, and recipients

None

None

asupersync

Structured async runtime (channels, sync, regions, HTTP, testing)

Analysis

`lint`, `typecheck`

Check

Detects

toon

Token-efficient compact encoding for robot mode output

399ms

< 800ms

attachments

project overview