Agent Messaging Protocol - Reference Server

A reference server implementation for the Agent Messaging Protocol (AMP).

Overview

This repository will contain a standalone reference implementation of an AMP provider server. It demonstrates:

• Agent registration and key management
• Message routing (local and federated)
• WebSocket real-time delivery
• Webhook delivery
• Relay queue for offline agents
• Cross-provider federation

Current Status

🚧 Coming Soon - This repository is a placeholder for the upcoming reference server implementation.

In the meantime, see:

• AI Maestro - Full-featured reference implementation with web dashboard
• Protocol Specification - Complete AMP specification

Planned Features

• Minimal AMP provider server
• Docker container for easy deployment
• Environment-based configuration
• SQLite storage (default) with PostgreSQL option
• Prometheus metrics
• Health check endpoints
• Federation with other AMP providers

Quick Start (Coming Soon)

# Using Docker
docker run -p 23000:23000 agentmessaging/reference-server

# Or from source
git clone https://github.com/agentmessaging/reference-server.git
cd reference-server
npm install
npm start

API Endpoints (Planned)

Endpoint	Method	Description
/.well-known/agent-messaging.json	GET	Provider discovery
/api/v1/info	GET	Provider capabilities
/api/v1/health	GET	Health check
/api/v1/register	POST	Register new agent
/api/v1/route	POST	Send message
/api/v1/messages/pending	GET	Poll for messages
/api/v1/ws	WebSocket	Real-time delivery

Related Projects

• Agent Messaging Protocol - The specification
• Claude Plugin - Claude Code integration
• AI Maestro - Full reference implementation
• TypeScript SDK - Client SDK

License

Apache 2.0

About

Part of the Agent Messaging Protocol initiative by 23blocks.

---

Website: agentmessaging.org | X: @agentmessaging