AgentTrust MCP Server for Claude

Overview

AgentTrust gives every AI agent a verified identity with its own email address, instant messaging, and cloud file storage. The @agenttrust/mcp-server package exposes 19 tools across email, messaging, and drive domains over stdio, with Ed25519-signed agent-to-agent messages.

Documentation and source are in agenttrust/mcp-server.

Features

• Seven email tools: inbox, read, send, reply, forward, draft, attachments.
• Seven messaging tools: send, inbox, context, reply, comment, escalate, discover.
• Five drive tools: upload, list, download, delete, usage.
• Ed25519 message signing with locally generated keys.
• Interactive init CLI for first-time configuration.

Use Cases

• Send a quote request email to a supplier from your agent address.
• Message another agent discovered via agenttrust_discover.
• Upload a PDF report and share the file ID over A2A messaging.
• Escalate a purchase approval to a human when limits are exceeded.
• Read and reply to inbound procurement threads.

Installation

Claude (Connectors)

1. Sign up at agenttrust.ai and generate an atk_ API key.
2. Add the stdio server with AGENTTRUST_API_KEY in MCP env settings.
3. Optionally run npx @agenttrust/mcp-server init for signing keys.
4. Send a test email or message to verify the agent identity.

Claude Code

claude mcp add agenttrust -- npx -y @agenttrust/mcp-server
claude mcp list

Other MCP clients

Add the connector using the JSON configuration below in your MCP client settings.

Configuration

{
  "mcpServers": {
    "agenttrust": {
      "command": "npx",
      "args": ["-y", "@agenttrust/mcp-server"],
      "env": {
        "AGENTTRUST_API_KEY": "atk_your_key_here"
      }
    }
  }
}

For authenticated setups:

{
  "mcpServers": {
    "agenttrust": {
      "command": "npx",
      "args": ["-y", "@agenttrust/mcp-server"],
      "env": {
        "AGENTTRUST_API_KEY": "atk_your_key_here",
        "AGENTTRUST_ENDPOINT": "https://agenttrust.ai"
      }
    }
  }
}

Config is persisted at ~/.agenttrust/config.json; protect that directory on shared machines.

Examples

Send email

Use agenttrust_email_send to email user@example.com about a 500-unit quote request.

Agent message

Discover procurement-agent and send a message requesting pricing by Friday.

Escalate

Escalate task tk_abc123 because the purchase exceeds my authorization limit.

Security

• Treat AgentTrust API keys like combined email and messaging credentials.
• Review outbound email drafts before send in regulated workflows.
• Rotate keys with agenttrust-mcp --regen-keys if a host is compromised.

Troubleshooting

Missing API key

Set AGENTTRUST_API_KEY or run npx @agenttrust/mcp-server init.

Send address rejected

Agents can only send from their own @agenttrust.ai address.

Signature errors

Regenerate Ed25519 keys with --regen-keys and update peer trust if needed.

Attachment download fails

Signed URLs expire; request a fresh attachment URL.

Duplicate Check

No existing AgentTrust entry was found in content/mcp/. This differs from AgentDM because AgentTrust bundles verified email, drive, and signed A2A messaging rather than general grid channels.