mess-server

Deploy a self-hosted REST API for the MESS Exchange protocol.

Updated Feb 1, 2026
One-click install
npx skills add https://github.com/teaguesterling/git-messe-af --skill mess-server
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mess-server
Source: https://github.com/teaguesterling/git-messe-af/tree/main/server
Command: npx skills add https://github.com/teaguesterling/git-messe-af --skill mess-server

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a self-hosted, robust API for managing physical-world tasks dispatched from AI agents to human executors, offering more control and flexibility than direct GitHub integration.

Core Features & Use Cases

  • Multi-deployment Options: Deploy as Docker containers, Kubernetes clusters, or Cloudflare Workers.
  • Event-Sourced Storage: All operations are logged as events, making data queryable with tools like DuckDB.
  • Custom Integrations: Supports various notification channels (Slack, ntfy, webhooks) and lifecycle hooks for external service integration (Todoist, Linear, Google Tasks).
  • Use Case: An AI assistant needs to check if a smart home device is online. It sends a request to the MESS server, which dispatches it to a nearby executor (e.g., a phone). The executor confirms the device status and the result is logged and reported back.

Quick Start

Deploy the MESS Exchange Server using Docker by running docker compose -f deploy/docker/docker-compose.yml up -d in the server directory.

Frequently Asked Questions about mess-server

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I dispatch physical-world tasks from an AI agent to a human executor?

You can deploy a self-hosted REST API to dispatch physical-world tasks from AI agents to human executors via the MESS Exchange protocol. It logs operations as events and reports results back to the agent.

What deployment options are available for a self-hosted task management API?

This self-hosted task management API supports multiple deployment options including Docker containers, Kubernetes clusters, and Cloudflare Workers. You can quickly start a local instance using the provided docker-compose file.

Can I send task notifications to Slack or integrate with external task managers?

Yes, you can send task notifications to Slack, ntfy, or webhooks, and integrate with external task managers like Todoist, Linear, and Google Tasks. This is achieved using custom notification channels and lifecycle hooks for external service automation.

How is task execution data stored and queried in a human-in-the-loop API?

Task execution data in this human-in-the-loop API is stored using an event-sourced architecture, logging all operations as events. This makes the data fully queryable using analytical tools like DuckDB.

Does the physical task dispatch protocol work without direct GitHub integration?

Yes, the physical task dispatch protocol works without direct GitHub integration by providing a self-hosted REST API. This offers more control and flexibility for managing human-in-the-loop tasks dispatched from AI agents.