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
• File Attachments - Presigned upload URLs, security scanning pipeline, signed download URLs (see Attachment Guide)

Attachment Support Status

Provider	Attachments	Upload	Scanning	Download	Status
AI Maestro	Planned	Presigned URL	TBD	Signed URL	Not yet implemented
Reference Server	Planned	Presigned URL + Direct	Basic (digest + MIME)	Signed URL	Not yet implemented
Claude Plugin (local)	Supported	Filesystem copy	None (marked unscanned)	Local file read	Working

The Claude Plugin supports local-only attachments via filesystem delivery. Attachments are copied to ~/.agent-messaging/attachments/ with digest verification but no AV scanning (marked scan_status: "unscanned"). For full attachment support including upload, scanning, and signed URLs, a provider server (AI Maestro or reference server) is required.

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/attachments/upload	POST	Request attachment upload URL
/api/v1/attachments/{id}/confirm	POST	Confirm upload, trigger scan
/api/v1/attachments/{id}	GET	Check scan status
/api/v1/attachments/{id}/download	GET	Download attachment
/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