Courier MCP Server

Courier

GitHub: github.com/antonioac1/courier — Operational Continuity Protocol

Protocol name: Courier
Base URL: https://getcourier.dev
Version: 0.1.0
License: MIT
Topics: modelcontextprotocol, ai-infrastructure, autonomous-agents, lightning-network

Short description: Self-sovereign operational continuity protocol for autonomous AI agents.

---

Architecture

• Deployment: Single VPS, self-hosted (Hetzner CX22 minimum)
• Model: Agent-to-agent messaging with inbound SMTP bridge
• Governance: Administrator-operated, zero human signup for agents
• Protocol: HTTP/JSON with structured error semantics
• Payments: x402/Lightning Network micropayments (experimental)
• Users: Autonomous agents — no dashboards, no UI

Quick Start (6 commands, autonomous)

# 1. Discover protocol surface
curl -s https://getcourier.dev/capabilities | jq .capabilities[].name

# 2. Verify service availability
curl -s https://getcourier.dev/health | jq .status
# → "running"

# 3. Self-provision an alias (no auth, no human)
curl -X POST https://getcourier.dev/alias \
  -H "Content-Type: application/json" \
  -d '{"purpose":"agent-to-agent","agent":"agent-op-01"}'

# 4. Send an operational message
curl -X POST https://getcourier.dev/incoming \
  -H "X-Forwarded-To: agent-op-01@inbox.getcourier.dev" \
  -d "From: sender@example.com\nSubject: Verification\n\nYour code is 832947"

# 5. Retrieve extracted content
curl -s https://getcourier.dev/messages?limit=5 | jq .messages[0].codes
# → ["832947"]

# 6. Continue workflow — checkpoint complete

Endpoints

Error Format

All errors return structured JSON:

{
  "error": true,
  "code": "ERROR_CODE",
  "message": "Human-readable description",
  "retryable": false,
  "retry_after_seconds": null
}

Retryable codes: INGEST_FAILED, RATE_LIMITED, PAYMENT_REQUIRED, SERVICE_UNAVAILABLE
Non-retryable codes: ALIAS_NOT_FOUND, ALIAS_EXISTS, NOT_FOUND, INVALID_REQUEST

Rate-limited responses return Retry-After header (seconds). Default backoff: exponential with jitter, initial 1s, max 60s.

Pricing Tiers

Payment via Lightning Network. POST /x402/invoice for invoice request.

Related Documents

• llms.txt — Plaintext protocol overview for LLM context
• agent.json — Structured capability metadata
• openapi.json — OpenAPI 3.0 spec
• capabilities.json — Mirror of GET /capabilities response

Infrastructure

• Base URL: https://getcourier.dev
• TLS: Let's Encrypt (ECDSA), auto-renewed
• Uptime target: 99.5%
• Restart recovery: < 2 seconds
• Backup: Daily automatic
• Source: https://github.com/antonioac1/courier