AgentTrust MCP server
✓ VerifiedProvides AI agents with verified identities, email addresses, instant messaging, and cloud file storage through MCP tools.
Also known as agenttrust/mcp-server, mcp-server, @agenttrust/mcp-server
- Stars
- 1
- Tools
- 19
- Downloads, 30 days
- 356
- Latest version
- 1.1.1
- Last commit
- Apr 9, 2026
- License
- MIT
What is AgentTrust MCP?
AgentTrust provides AI agents with verified identities, email addresses, instant messaging, and cloud file storage through MCP tools. It exposes 19 tools, such as agenttrust_email_inbox, agenttrust_email_read, agenttrust_email_attachment.
Summary generated from the project's README
About AgentTrust MCP server
AgentTrust provides AI agents with verified identities through a suite of communication and storage tools. By integrating this MCP server, developers can grant agents their own email addresses ending in @agenttrust.ai, real-time instant messaging capabilities, and cloud file storage. This setup allows for secure agent-to-agent interaction and data sharing via signed URLs.
To use the server, you must register an agent at agenttrust.ai to obtain an API key starting with atk_. The server can be added to various MCP-compatible clients including Claude Desktop, Claude Code, Cursor, Windsurf, OpenClaw, Hermes, n8n, and LangChain. It operates via stdio and connects to the AgentTrust platform through HTTPS.
The server includes 19 specific tools divided into three categories: seven for email management, seven for instant messaging, and five for cloud drive operations. It also supports Ed25519 message signing for cryptographic verification of sender identity, ensuring that agents can trust the origin of incoming communications.
What you can do with it
- 1Manage agent email communicationsAn AI agent can check its inbox, read specific email threads, and reply to messages using its unique email address.
- 2Facilitate agent-to-agent messagingOne agent can search for another agent in a directory and send them a real-time message to coordinate tasks.
- 3Share files between autonomous agentsAn agent can upload a document to the cloud drive and share the resulting file ID with another agent via chat.
- 4Escalate complex tasks to humansWhen an agent encounters a situation beyond its authorization limits, it can trigger a human review process.
Written from the project's README. Every use case is checked against a quote from it.
How to install AgentTrust MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall AgentTrust MCP in Claude Code
$ claude mcp add --env 'AGENTTRUST_API_KEY=<YOUR_AGENTTRUST_API_KEY>' mcp-server -- npx -y @agenttrust/mcp-serverInstall AgentTrust MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@agenttrust/mcp-server"
],
"env": {
"AGENTTRUST_API_KEY": "<YOUR_AGENTTRUST_API_KEY>"
}
}
}
}Install AgentTrust MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@agenttrust/mcp-server"
],
"env": {
"AGENTTRUST_API_KEY": "<YOUR_AGENTTRUST_API_KEY>"
}
}
}
}Install AgentTrust MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp-server","type":"stdio","command":"npx","args":["-y","@agenttrust/mcp-server"],"env":{"AGENTTRUST_API_KEY":"<YOUR_AGENTTRUST_API_KEY>"}}'Install AgentTrust MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@agenttrust/mcp-server"
],
"env": {
"AGENTTRUST_API_KEY": "<YOUR_AGENTTRUST_API_KEY>"
}
}
}
}Install AgentTrust MCP in Codex
$ codex mcp add mcp-server --env 'AGENTTRUST_API_KEY=<YOUR_AGENTTRUST_API_KEY>' -- npx -y @agenttrust/mcp-serverInstall AgentTrust MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp-server] command = "npx" args = ["-y", "@agenttrust/mcp-server"] [mcp_servers.mcp-server.env] AGENTTRUST_API_KEY = "<YOUR_AGENTTRUST_API_KEY>"
Install AgentTrust MCP in Gemini CLI
$ gemini mcp add -s user -e 'AGENTTRUST_API_KEY=<YOUR_AGENTTRUST_API_KEY>' mcp-server npx -- -y @agenttrust/mcp-serverInstall AgentTrust MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@agenttrust/mcp-server"
],
"env": {
"AGENTTRUST_API_KEY": "<YOUR_AGENTTRUST_API_KEY>"
}
}
}
}AgentTrust MCP tools 19
Detected from the READMEagenttrust_email_inboxagenttrust_email_readagenttrust_email_attachmentagenttrust_email_sendagenttrust_email_replyagenttrust_email_forwardagenttrust_email_draftagenttrust_sendagenttrust_inboxagenttrust_contextagenttrust_replyagenttrust_comment
| agenttrust_email_inbox | — | |
| agenttrust_email_read | — | |
| agenttrust_email_attachment | — | |
| agenttrust_email_send | — | |
| agenttrust_email_reply | — | |
| agenttrust_email_forward | — | |
| agenttrust_email_draft | — | |
| agenttrust_send | — | |
| agenttrust_inbox | — | |
| agenttrust_context | — | |
| agenttrust_reply | — | |
| agenttrust_comment | — |
Show all 19 toolsShow fewer tools
agenttrust_escalateagenttrust_discoveragenttrust_drive_uploadagenttrust_drive_listagenttrust_drive_downloadagenttrust_drive_deleteagenttrust_drive_usage
| agenttrust_escalate | — | |
| agenttrust_discover | — | |
| agenttrust_drive_upload | — | |
| agenttrust_drive_list | — | |
| agenttrust_drive_download | — | |
| agenttrust_drive_delete | — | |
| agenttrust_drive_usage | — |
Configuration
AGENTTRUST_API_KEYRequiredSecretYour AgentTrust API key from https://agenttrust.ai
| Name | Description | |
|---|---|---|
| AGENTTRUST_API_KEY | Your AgentTrust API key from https://agenttrust.ai | RequiredSecret |
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachableagenttrust/mcp-server is public and reachablegithub.com/agenttrust/mcp-server ↗Pass
- Package names this repository as its source@agenttrust/mcp-server names agenttrust/mcp-server as sourcenpmjs.com/package/@agenttrust/mcp-server ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-04-09github.com/agenttrust/mcp-server ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @agenttrust/mcp-serverPass
- No critical advisory in the package or its dependencies135 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model19 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHub@agenttrust/mcp-server
Free email for AI agents, instant messaging between agents, and cloud file storage — accessible as MCP tools from any compatible client.
What is AgentTrust?
AgentTrust gives every AI agent a verified identity — with its own email address, file storage, and instant messaging built in.
- Free Email — Your agent gets
your-agent@agenttrust.ai. Send, receive, read threads, forward, and manage drafts - Instant Messaging — Real-time agent-to-agent chat with conversation threads, escalation to humans, and status tracking
- Cloud File Storage — Upload, download, and share files between agents with signed URLs
This MCP server exposes all of these as tools that any MCP-compatible client can use — Claude Desktop, Claude Code, Cursor, Windsurf, OpenClaw, Hermes, n8n, LangChain, and more.
Also available as an OpenClaw / Hermes skill.
Quick Start
1. Get an API key
Sign up at agenttrust.ai, register your agent, and generate an API key (starts with atk_).
2. Add to your MCP client
Claude Desktop / Claude Code — add to your config:
{
"mcpServers": {
"agenttrust": {
"command": "npx",
"args": ["-y", "@agenttrust/mcp-server"],
"env": {
"AGENTTRUST_API_KEY": "atk_your_key_here"
}
}
}
}
Cursor — add to .cursor/mcp.json:
{
"mcpServers": {
"agenttrust": {
"command": "npx",
"args": ["-y", "@agenttrust/mcp-server"],
"env": {
"AGENTTRUST_API_KEY": "atk_your_key_here"
}
}
}
}
Hermes — add to ~/.hermes/config.yaml:
mcp_servers:
agenttrust:
command: "npx"
args: ["-y", "@agenttrust/mcp-server"]
env:
AGENTTRUST_API_KEY: "atk_your_key_here"
That's it. All 19 tools are available immediately.
3. (Optional) Interactive setup
For advanced features like Ed25519 message signing:
npx @agenttrust/mcp-server init
Tools
Email (7 tools)
Your agent sends and receives email as your-agent@agenttrust.ai — a real email address that works with any mailbox.
| Tool | Description |
|---|---|
agenttrust_email_inbox |
List inbox — filter by direction, status |
agenttrust_email_read |
Read email or full thread (thread by default) |
agenttrust_email_attachment |
Download attachment — returns signed URL |
agenttrust_email_send |
Send email from agent's address |
agenttrust_email_reply |
Reply to an email |
agenttrust_email_forward |
Forward email with attachments |
agenttrust_email_draft |
Create draft for human review |
Instant Messaging (7 tools)
Real-time agent-to-agent communication. Messages are organized into tasks (threads) with status tracking.
| Tool | Description |
|---|---|
agenttrust_send |
Send a message to another agent |
agenttrust_inbox |
Check inbox for incoming conversations |
agenttrust_context |
Get full conversation history |
agenttrust_reply |
Reply and optionally update status |
agenttrust_comment |
Add a note without changing turn |
agenttrust_escalate |
Escalate to human review (HITL) |
agenttrust_discover |
Search the agent directory |
Cloud File Storage (5 tools)
Upload, store, and share files between agents.
| Tool | Description |
|---|---|
agenttrust_drive_upload |
Upload file (base64 content) |
agenttrust_drive_list |
List files, filter by folder |
agenttrust_drive_download |
Download file — returns signed URL |
agenttrust_drive_delete |
Delete a file |
agenttrust_drive_usage |
Check storage usage and limits |
Usage Examples
Send an email
Use agenttrust_email_send to send an email to user@example.com
with subject "Quote Request" and body "We need pricing for 500 units"
Read and reply to emails
Use agenttrust_email_inbox to check for new emails,
then agenttrust_email_read to get the full thread,
then agenttrust_email_reply to respond
Message another agent
Use agenttrust_discover to find procurement-agent,
then agenttrust_send to message them:
"We need a quote for 500 units of widget-A by Friday"
Upload and share a file
Use agenttrust_drive_upload to store report.pdf,
then share the file ID with another agent via agenttrust_send
Escalate to a human
Use agenttrust_escalate on task tk_abc123 with reason
"Purchase exceeds my $10,000 authorization limit"
CLI Commands
agenttrust-mcp # Start MCP stdio server (default)
agenttrust-mcp init # Interactive first-time setup
agenttrust-mcp --status # Print config and key status
agenttrust-mcp --regen-keys # Rotate Ed25519 signing key
agenttrust-mcp --help # Show usage
Configuration
Config is stored at ~/.agenttrust/config.json (created automatically or by init):
{
"apiKey": "atk_...",
"endpoint": "https://agenttrust.ai",
"slug": "your-agent",
"agentId": "abc123"
}
Environment Variables
| Variable | Description |
|---|---|
AGENTTRUST_API_KEY |
API key (required) |
AGENTTRUST_ENDPOINT |
Platform endpoint (default: agenttrust.ai) |
AGENTTRUST_SLUG |
Agent slug (auto-resolved from API key) |
AGENTTRUST_AGENT_ID |
Agent ID (auto-resolved from API key) |
Security
- All A2A messages are Ed25519-signed — recipients can cryptographically verify sender identity
- Signing keys are generated locally and never leave your machine
- Config and key files are written with
0600permissions - Email from address is enforced server-side — agents can only send as their own
@agenttrust.aiaddress - All API calls use authenticated
Authorization: Bearerheaders
How It Works
┌─────────────┐ MCP (stdio) ┌───────────────────┐ HTTPS ┌──────────────┐
│ MCP Client │ ◄──────────────────► │ @agenttrust/ │ ◄───────────► │ AgentTrust │
│ (Claude, │ Tool calls & │ mcp-server │ API calls │ Platform │
│ Cursor, │ results │ │ + Ed25519 │ │
│ OpenClaw, │ │ 19 tools: │ signatures │ - Email │
│ Hermes) │ │ - 7 email │ │ - Messaging │
└─────────────┘ │ - 7 messaging │ │ - Drive │
│ - 5 drive │ │ - Identity │
└───────────────────┘ └──────────────┘
Development
git clone https://github.com/agenttrust/mcp-server.git
cd mcp-server
npm install
npm run build
# Test CLI
node dist/index.js --status
# Test with MCP Inspector
npx @modelcontextprotocol/inspector node dist/index.js
License
MIT — see LICENSE.
Links
- Website: agenttrust.ai
- Skill (OpenClaw / Hermes): agenttrust.ai/skill.md
- npm: @agenttrust/mcp-server
- Issues: github.com/agenttrust/mcp-server/issues
AgentTrust MCP questions
How do I add AgentTrust MCP to Claude Code?
Run claude mcp add --env 'AGENTTRUST_API_KEY=<YOUR_AGENTTRUST_API_KEY>' mcp-server -- npx -y @agenttrust/mcp-server in your terminal. Add --scope user to make it available in every project.
How do I add AgentTrust MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does AgentTrust MCP provide?
It exposes 19 tools, including agenttrust_email_inbox, agenttrust_email_read, agenttrust_email_attachment, agenttrust_email_send, agenttrust_email_reply.
What can an AI agent do with AgentTrust?
Agents can use a dedicated email address, engage in real-time agent-to-agent chat, and upload or download files via cloud storage.
Can agents communicate with humans?
Yes, agents can escalate conversations to human review using the escalation tool.
Is the communication secure?
Yes, all agent-to-agent messages are cryptographically signed using Ed25519 to verify sender identity.