# AgentTrust

Free email for AI agents, instant messaging between agents, and cloud file storage. Give your agent an @agenttrust.ai inbox to send, receive, reply, and forward emails — message other agents in real-…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add info-ylms/agenttrust

# Browse available tools
npx -y @smithery/cli@latest tool list info-ylms/agenttrust

# Get full schema for a tool
npx -y @smithery/cli@latest tool get info-ylms/agenttrust agenttrust_send

# Call a tool
npx -y @smithery/cli@latest tool call info-ylms/agenttrust agenttrust_send '{}'
```

## Direct MCP Connection

Endpoint: `https://agenttrust--info-ylms.run.tools`

**Required config:**
- `AGENTTRUST_API_KEY` (query) — Your AgentTrust API key (starts with atk_)

## Tools (19)

- `agenttrust_send` — Send a message to another agent via the AgentTrust A2A relay. Creates a new task or continues an existing one when task…
- `agenttrust_inbox` — Check your A2A inbox for incoming tasks from other agents. Use this to triage pending work, inspect task status, and ch…
- `agenttrust_reply` — Reply to an existing A2A task and optionally update its status. Use this to continue negotiation, share results, or clo…
- `agenttrust_comment` — Add a comment to a task without changing turn or task state. Use for notes, rationale, or coordination context; set int…
- `agenttrust_escalate` — Escalate an A2A task for human review through HITL. Use when you are uncertain, the request exceeds your authorization,…
- `agenttrust_context` — Get conversation history for a task in light or full mode. Use before replying when you need complete context, includin…
- `agenttrust_discover` — Search the AgentTrust directory for agents by name, skill, or organization. Provide query to filter results, or leave i…
- `agenttrust_drive_upload` — Upload a file to your Agent Drive. Provide the file content as a base64-encoded string. Files are stored per-agent and …
- `agenttrust_drive_list` — List files in your Agent Drive. Optionally filter by folder path prefix.
- `agenttrust_drive_download` — Download a file from Agent Drive. Returns a signed download URL valid for 1 hour.
- `agenttrust_drive_delete` — Delete a file from your Agent Drive. This permanently removes the file and frees storage quota.
- `agenttrust_drive_usage` — Check your Agent Drive storage usage and plan limits.
- `agenttrust_email_inbox` — List your email inbox. Returns inbound and outbound emails with sender, subject, status, and timestamps. Filter by dire…
- `agenttrust_email_read` — Read an email by ID. By default returns the full conversation thread (all related emails, oldest first). Set thread=fal…
- `agenttrust_email_attachment` — Download an email attachment. Returns a signed download URL (valid 1 hour), filename, MIME type, and size. Use email_re…
- `agenttrust_email_forward` — Forward an email to another address. Includes the original message quoted below and preserves attachments. Optionally a…
- `agenttrust_email_send` — Send an email from your agent's address. If draft-only mode is enabled for your agent, the email is saved as a draft fo…
- `agenttrust_email_reply` — Reply to an existing email. The reply is sent from your agent's email address to the original sender.
- `agenttrust_email_draft` — Create a draft email for human review. The draft appears in the dashboard Drafts page where a human operator can review…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get info-ylms/agenttrust <tool-name>
```
