{
  "name": "FineMail Agent Email Service",
  "description": "Lists and operates email inboxes belonging to an authenticated Fine Structure agent team.",
  "url": "https://finemail.app/api/a2a",
  "preferredTransport": "JSONRPC",
  "additionalInterfaces": [
    {
      "url": "https://finemail.app/api/a2a",
      "transport": "JSONRPC"
    }
  ],
  "supportedInterfaces": [
    {
      "url": "https://finemail.app/api/a2a",
      "protocolBinding": "JSONRPC",
      "protocolVersion": "1.0"
    },
    {
      "url": "https://finemail.app/api/a2a",
      "protocolBinding": "JSONRPC",
      "protocolVersion": "0.3"
    }
  ],
  "provider": {
    "url": "https://finestructure.ai/",
    "organization": "Fine Structure"
  },
  "version": "1.0.0",
  "documentationUrl": "https://finemail.app/for-ai-agents/",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "extendedAgentCard": false
  },
  "securitySchemes": {
    "fineStructureToken": {
      "httpAuthSecurityScheme": {
        "description": "Scoped MCP/A2A token created by the Fine Structure account owner.",
        "scheme": "Bearer",
        "bearerFormat": "fse2_mcp_*"
      }
    }
  },
  "securityRequirements": [
    {
      "fineStructureToken": []
    }
  ],
  "defaultInputModes": ["text/plain", "application/json"],
  "defaultOutputModes": ["application/json"],
  "skills": [
    {
      "id": "finemail-list-inboxes",
      "name": "List agent inboxes",
      "description": "List FineMail identities owned by the authenticated account.",
      "tags": ["email", "agent-inbox", "identity"],
      "examples": ["List my agent inboxes and their current FineMail addresses."],
      "inputModes": ["text/plain", "application/json"],
      "outputModes": ["application/json"]
    },
    {
      "id": "finemail-list-messages",
      "name": "Search agent email",
      "description": "Search and filter inbound and outbound messages belonging to the authenticated account.",
      "tags": ["email", "search", "inbox"],
      "examples": ["{\"skill\":\"finemail-list-messages\",\"arguments\":{\"agent_id\":\"agent_123\",\"folder\":\"unread\"}}"],
      "inputModes": ["application/json"],
      "outputModes": ["application/json"]
    },
    {
      "id": "finemail-get-message",
      "name": "Read an email message",
      "description": "Retrieve one owner-scoped FineMail message by ID.",
      "tags": ["email", "message", "read"],
      "examples": ["{\"skill\":\"finemail-get-message\",\"arguments\":{\"message_id\":\"agem_123\"}}"],
      "inputModes": ["application/json"],
      "outputModes": ["application/json"]
    },
    {
      "id": "finemail-mark-read",
      "name": "Update message read state",
      "description": "Mark an owned FineMail message read or unread.",
      "tags": ["email", "read-state", "inbox"],
      "examples": ["{\"skill\":\"finemail-mark-read\",\"arguments\":{\"message_id\":\"agem_123\",\"is_read\":true}}"],
      "inputModes": ["application/json"],
      "outputModes": ["application/json"]
    },
    {
      "id": "finemail-archive-message",
      "name": "Archive or restore a message",
      "description": "Archive or restore an owned FineMail message.",
      "tags": ["email", "archive", "state"],
      "examples": ["{\"skill\":\"finemail-archive-message\",\"arguments\":{\"message_id\":\"agem_123\",\"is_archived\":true}}"],
      "inputModes": ["application/json"],
      "outputModes": ["application/json"]
    },
    {
      "id": "finemail-send-message",
      "name": "Send agent email",
      "description": "Send an authorized message from an owned FineMail agent identity and record it in that mailbox.",
      "tags": ["email", "send", "agent-identity"],
      "examples": ["{\"skill\":\"finemail-send-message\",\"arguments\":{\"agent_id\":\"agent_123\",\"to\":\"customer@example.com\",\"subject\":\"Approved reply\",\"body\":\"Hello\"}}"],
      "inputModes": ["application/json"],
      "outputModes": ["application/json"]
    },
    {
      "id": "finemail-check-address-availability",
      "name": "Check FineMail address availability",
      "description": "Validate a requested FineMail address and check whether it is globally available.",
      "tags": ["email", "address", "identity"],
      "examples": ["{\"skill\":\"finemail-check-address-availability\",\"arguments\":{\"local_part\":\"maya.sales\"}}"],
      "inputModes": ["application/json"],
      "outputModes": ["application/json"]
    },
    {
      "id": "finemail-get-configuration",
      "name": "Inspect FineMail readiness",
      "description": "Read domain and provider readiness without exposing credentials.",
      "tags": ["email", "configuration", "readiness"],
      "examples": ["{\"skill\":\"finemail-get-configuration\",\"arguments\":{}}"],
      "inputModes": ["application/json"],
      "outputModes": ["application/json"]
    }
  ],
  "iconUrl": "https://finemail.app/favicon.svg"
}
