Skip to content
Back to Commune

Card snapshot

api.commune.email · 2026-06-22 16:47:20 UTC · 9acea2eff17b089c1e711f36f87f08e4810beb2c20f4227c3905e8f197cb5b3d

This is a frozen copy of the agent's agent-card.json as we observed it at the timestamp above. We capture a new snapshot every time the card's content hash changes. Useful for: forensic drift analysis, verifying downstream callers see the right version, reproducing routing decisions made historically.

{
  "name": "Commune",
  "description": "Email infrastructure for AI agents. Send emails, read threads, search inboxes, track deliveries, and manage email identities \u2014 all designed for programmatic agent use.",
  "url": "https://api.commune.email/a2a",
  "version": "1.0.0",
  "protocolVersion": "0.3.0",
  "capabilities": {
    "streaming": true,
    "pushNotifications": false,
    "stateTransitionHistory": true
  },
  "defaultInputModes": [
    "application/json",
    "text/plain"
  ],
  "defaultOutputModes": [
    "application/json",
    "text/plain"
  ],
  "skills": [
    {
      "id": "send_email",
      "name": "Send Email",
      "description": "Compose and send an email. Supports HTML/text body, attachments, CC/BCC, and threading (reply to existing conversations by providing a thread_id). Returns message ID and thread ID for tracking.",
      "tags": [
        "email",
        "send",
        "compose",
        "reply"
      ],
      "examples": [
        "Send an email to john@example.com about the meeting tomorrow",
        "Reply to thread_abc123 saying we accept the proposal",
        "Send a follow-up email to the sales thread with the attached contract"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "read_thread",
      "name": "Read Thread",
      "description": "Get all messages in an email conversation thread. Returns the full history: sender, recipients, subject, body, timestamps, and delivery status for each message. Use this to understand context before replying.",
      "tags": [
        "email",
        "read",
        "thread",
        "conversation",
        "history"
      ],
      "examples": [
        "Read the thread with ID thread_abc123",
        "Get all messages in the conversation about the contract",
        "Show me the email thread I had with jane@example.com"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "search_inbox",
      "name": "Search Inbox",
      "description": "Search across all emails using natural language or keywords. Uses semantic search (meaning-based) with regex fallback. Filter by inbox, domain, or sender. Returns matching threads with relevance scores.",
      "tags": [
        "email",
        "search",
        "find",
        "query",
        "lookup"
      ],
      "examples": [
        "Find all emails from investors about the Series A",
        "Search for messages mentioning the product launch date",
        "Look up any emails from @stripe.com in the last week"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "list_threads",
      "name": "List Threads",
      "description": "List recent email conversation threads. Returns thread ID, subject, participants, last message timestamp, and message count. Supports cursor pagination and filtering by inbox or domain.",
      "tags": [
        "email",
        "list",
        "inbox",
        "threads",
        "recent"
      ],
      "examples": [
        "Show me my recent email threads",
        "List all threads in the support inbox",
        "What conversations happened today?"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "get_delivery_status",
      "name": "Check Delivery Status",
      "description": "Check whether emails were successfully delivered, bounced, or failed. Returns delivery metrics (sent, delivered, bounced, complained, failed counts) and recent delivery events with timestamps.",
      "tags": [
        "email",
        "delivery",
        "status",
        "bounce",
        "tracking"
      ],
      "examples": [
        "Did my email to john@example.com get delivered?",
        "Check delivery metrics for the marketing inbox",
        "Show me any bounced emails from today"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "create_inbox",
      "name": "Create Inbox",
      "description": "Provision a new email address (inbox). Each inbox gets a unique address for sending and receiving. Useful for creating per-campaign or per-agent email identities.",
      "tags": [
        "email",
        "inbox",
        "create",
        "provision",
        "identity"
      ],
      "examples": [
        "Create a new inbox called outreach on my domain",
        "Set up a support@mydomain.com inbox",
        "Provision an email identity for my sales agent"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "list_inboxes",
      "name": "List Inboxes",
      "description": "List all email inboxes (addresses) available in the organization. Returns inbox ID, email address, display name, and domain info.",
      "tags": [
        "email",
        "inbox",
        "list",
        "addresses"
      ],
      "examples": [
        "What email addresses do I have?",
        "List all my inboxes",
        "Show available sending identities"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    }
  ],
  "security": [
    {
      "apiKey": []
    }
  ],
  "securitySchemes": {
    "apiKey": {
      "type": "apiKey",
      "in": "header",
      "name": "Authorization",
      "description": "Commune API key. Format: Bearer comm_xxx..."
    }
  },
  "supportsAuthenticatedExtendedCard": false
}