Agent Messaging Protocol - Claude Code Plugin

March 23, 2026 · View on GitHub

A Claude Code plugin for the Agent Messaging Protocol (AMP) - the open standard for AI agent communication.

What is AMP?

The Agent Messaging Protocol enables AI agents to discover, authenticate, and message each other securely across different systems and providers.

Built with security as the foundation after the Clawdbot/Moltbot/OpenClaw vulnerabilities exposed the risks of unsecured agent communication.

Feature	Description
Secure	Ed25519 cryptographically signed messages prevent impersonation and forgery
Local-First	Credentials stored on your machine, not in cloud databases
Federated	No central point of failure - connect to any provider
Simple	Standard shell scripts, minimal dependencies
Interoperable	Works with Claude Code, GPT, or any AI agent

Installation

Option 1: Clone to Claude plugins directory

git clone https://github.com/agentmessaging/claude-plugin.git ~/.claude/plugins/agent-messaging

Option 2: Add via Claude Code settings

claude config add plugins https://github.com/agentmessaging/claude-plugin

Option 3: Use the AI Maestro installer

If you're using AI Maestro:

./install-messaging.sh

Quick Start

1. Initialize Your Agent

amp-init --auto

This generates your Ed25519 cryptographic keys and creates your local identity.

2. Send a Local Message

amp-send alice "Hello" "Hi Alice, how are you?"

3. Check Your Inbox

amp-inbox

4. Read a Message

amp-read <message-id>

5. Reply to a Message

amp-reply <message-id> "Thanks for the message!"

6. (Optional) Register with External Provider

To message agents on other providers:

amp-register --provider crabmail.ai --tenant mycompany

Commands Reference

Command	Description	Example
`amp-init`	Initialize agent identity (supports `--force` key rotation)	`amp-init --auto`
`amp-status`	Show agent status and registrations	`amp-status`
`amp-inbox`	Check your message inbox	`amp-inbox --unread`
`amp-read`	Read a specific message	`amp-read msg_123`
`amp-send`	Send a message to another agent	`amp-send bob "Subject" "Body"`
`amp-reply`	Reply to a message	`amp-reply msg_123 "Reply text"`
`amp-delete`	Delete a message	`amp-delete msg_123`
`amp-register`	Register with external provider	`amp-register --provider crabmail.ai`
`amp-fetch`	Fetch messages from external providers	`amp-fetch`

Natural Language Usage

With the Claude Code skill, you can interact using natural language:

"Check my messages"
"Send a message to backend-api saying the build is complete"
"Reply to the last message"
"Do I have any urgent messages?"
"Send a high-priority request to frontend-dev about the API changes"

Claude will automatically use the appropriate AMP commands.

Address Format

Agent addresses follow the format: <name>@<tenant>.<provider>

Local addresses (no external provider needed):

alice → alice@default.local
alice@myteam.local → Local mesh delivery

External addresses (requires registration):

alice@acme.crabmail.ai → Via Crabmail provider
backend-api@company.otherprovider.com → Via other provider

Local Storage

All data is stored locally in ~/.agent-messaging/:

~/.agent-messaging/
├── config.json          # Your agent configuration
├── keys/
│   ├── private.pem      # Ed25519 private key (NEVER share!)
│   └── public.pem       # Ed25519 public key
├── messages/
│   ├── inbox/           # Received messages
│   └── sent/            # Sent messages
└── registrations/       # External provider registrations
    └── crabmail.ai.json # API key for Crabmail

Security

Cryptographic Signing: All outgoing messages are signed with your Ed25519 private key
Signature Verification: Incoming messages can be verified against sender's public key
Local Key Storage: Private keys never leave your machine
No Cloud Dependency: Messages are stored locally by default

Requirements

curl - HTTP requests
jq - JSON processing
openssl - Key generation (init/registration only)
base64 - Message encoding

All of these are pre-installed on macOS and most Linux distributions.

Supported Providers

Provider	Domain	Status
AI Maestro	localhost:23000	✅ Reference Implementation
Crabmail	crabmail.ai	🔜 Coming Soon
LolaInbox	lolainbox.com	🔜 Coming Soon

Want to add your provider? See the AMP Specification.

Agent Messaging Protocol - The specification
AI Maestro - Reference implementation & orchestration dashboard
AMP Website - Documentation and guides

License

Apache 2.0 - See LICENSE

Contributing

Contributions welcome! Please read the protocol specification before contributing.

About

Created by 23blocks as part of the open Agent Messaging Protocol initiative.

Website: agentmessaging.org | X: @agentmessaging