{
  "protocolVersion": "0.2.0",
  "name": "Lumbox",
  "description": "Email infrastructure for AI agents. Create email inboxes, extract OTPs and verification links, wait for codes with no polling, and send/reply/forward - over a REST API and a hosted MCP server.",
  "url": "https://mcp.lumbox.co/mcp",
  "preferredTransport": "streamable-http",
  "supportedInterfaces": [
    { "url": "https://mcp.lumbox.co/mcp", "transport": "streamable-http" },
    { "url": "https://api.lumbox.co/v1", "transport": "rest" }
  ],
  "additionalInterfaces": [
    { "url": "https://mcp.lumbox.co/mcp", "transport": "streamable-http" },
    { "url": "https://api.lumbox.co/v1", "transport": "rest" }
  ],
  "provider": {
    "organization": "Lumbox",
    "url": "https://lumbox.co"
  },
  "version": "1.0.0",
  "documentationUrl": "https://lumbox.co/docs/api-reference",
  "iconUrl": "https://lumbox.co/logo-512.png",
  "capabilities": {
    "streaming": false,
    "pushNotifications": true,
    "stateTransitionHistory": false
  },
  "defaultInputModes": ["application/json", "text/plain"],
  "defaultOutputModes": ["application/json", "text/plain"],
  "securitySchemes": {
    "apiKey": { "type": "apiKey", "in": "header", "name": "X-API-Key" },
    "oauth2": {
      "type": "oauth2",
      "flows": {
        "authorizationCode": {
          "authorizationUrl": "https://api.lumbox.co/oauth/authorize",
          "tokenUrl": "https://api.lumbox.co/oauth/token",
          "scopes": {
            "inboxes:read": "Read inbox metadata",
            "inboxes:write": "Create, update, delete inboxes",
            "emails:read": "Read received email and parsed data",
            "emails:send": "Send, reply, forward email",
            "domains:write": "Add and verify custom domains"
          }
        }
      }
    }
  },
  "security": [{ "apiKey": [] }, { "oauth2": ["inboxes:write", "emails:read", "emails:send"] }],
  "skills": [
    {
      "id": "create-inbox",
      "name": "Create email inbox",
      "description": "Create a real email address the agent owns, usable for signups and verification.",
      "tags": ["email", "inbox", "provisioning"],
      "examples": ["Create an inbox named github-bot", "Give my agent an email address"]
    },
    {
      "id": "extract-otp",
      "name": "Extract OTP / verification code",
      "description": "Long-poll an inbox and return the parsed OTP, verification link, or magic link as JSON - no polling loop.",
      "tags": ["otp", "2fa", "verification", "login"],
      "examples": ["Wait for the OTP and return the code", "Get the verification link from the latest email"]
    },
    {
      "id": "send-email",
      "name": "Send / reply / forward",
      "description": "Send a new email or reply with correct threading headers from an agent inbox.",
      "tags": ["email", "send", "reply"],
      "examples": ["Reply to the last support email", "Send a confirmation to user@example.com"]
    },
    {
      "id": "search-email",
      "name": "Search and read email",
      "description": "List, search, and read received email with structured parsed fields and AI categories.",
      "tags": ["email", "search", "read"],
      "examples": ["List unread verification emails", "Find emails from stripe.com"]
    }
  ]
}