ClearList

{
  "protocolVersion": "0.2.0",
  "name": "ClearList",
  "description": "AI resale manager. Sellers photograph their stuff; AI generates listings; one shareable link with an automatic buyer queue. ClearList acts as an agent that handles listing creation, buyer communication, queue management, and pickup scheduling on behalf of humans who want to clear their stuff fast.",
  "version": "0.3.0",
  "url": "https://clearlist.me/api",
  "documentationUrl": "https://clearlist.me/docs/api",
  "provider": {
    "organization": "ClearList",
    "url": "https://clearlist.me"
  },
  "supportedInterfaces": [
    {
      "url": "https://clearlist.me/api",
      "transport": "https",
      "description": "Direct HTTPS API. Authenticate via X-ClearList-API-Key header. Same endpoints the MCP server wraps. See /.well-known/api-catalog for the full route inventory."
    }
  ],
  "defaultInputModes": [
    "application/json",
    "image/jpeg",
    "image/png",
    "image/webp"
  ],
  "defaultOutputModes": [
    "application/json",
    "text/markdown"
  ],
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false,
    "x-tool-count": 19,
    "x-supports-bulk-upload": true,
    "x-supports-async-jobs": true
  },
  "securitySchemes": {
    "apiKey": {
      "type": "apiKey",
      "in": "header",
      "name": "X-ClearList-API-Key",
      "description": "API key acquired via the email-OTP flow. POST /api/auth/send-code, then POST /api/auth/verify-code with { email, code, agent: true }. See /.well-known/oauth-authorization-server for the full flow."
    }
  },
  "security": [
    {
      "apiKey": []
    }
  ],
  "skills": [
    {
      "id": "create-and-publish-sale",
      "name": "Create and publish a sale",
      "description": "End-to-end flow for creating a ClearList sale: onboard, upload photos, generate AI listings, publish a shareable sale page.",
      "tags": [
        "onboarding",
        "listings",
        "ai-generation",
        "publishing"
      ],
      "examples": [
        "Create a sale for John with 5 items: a sofa, a desk, two chairs, and a lamp.",
        "Onboard sarah@example.com, list these 12 photos, publish at clearlist.me/sarahs-sale."
      ],
      "skillDocumentUrl": "https://clearlist.me/.well-known/agent-skills/create-and-publish-sale/SKILL.md",
      "inputModes": [
        "application/json",
        "image/jpeg",
        "image/png"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "manage-reservations",
      "name": "Manage buyer reservations and conversations",
      "description": "View the buyer queue, communicate with buyers, and confirm pickups. The seller\u2019s address is never available to agents \u2014 only the signed-in seller can share it, from the ClearList inbox.",
      "tags": [
        "inbox",
        "reservations",
        "queue",
        "pickup",
        "privacy"
      ],
      "examples": [
        "Show me who's in the queue for the sofa.",
        "Reply to the first buyer asking what time they want to pick up.",
        "Tell buyer #2 the sofa is ready and ask what time works for pickup tomorrow."
      ],
      "skillDocumentUrl": "https://clearlist.me/.well-known/agent-skills/manage-reservations/SKILL.md",
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "bulk-upload",
      "name": "Bulk-upload photos and generate listings",
      "description": "Upload up to 50 photos at once. AI groups photos by item (handling multiple angles per item) and generates a complete listing for each. Designed for sellers clearing a whole garage or moving an entire household.",
      "tags": [
        "bulk",
        "listings",
        "ai-generation",
        "photo-grouping"
      ],
      "examples": [
        "Here are 30 photos from my garage. Generate listings for everything.",
        "Process this batch of moving-sale photos and group them into items."
      ],
      "skillDocumentUrl": "https://clearlist.me/.well-known/agent-skills/bulk-upload/SKILL.md",
      "inputModes": [
        "image/jpeg",
        "image/png",
        "image/webp"
      ],
      "outputModes": [
        "application/json"
      ]
    }
  ],
  "x-related-endpoints": {
    "mcp_server_card": "https://clearlist.me/.well-known/mcp/server-card.json",
    "api_catalog": "https://clearlist.me/.well-known/api-catalog",
    "agent_skills_index": "https://clearlist.me/.well-known/agent-skills/index.json",
    "oauth_authorization_server": "https://clearlist.me/.well-known/oauth-authorization-server",
    "oauth_protected_resource_root": "https://clearlist.me/.well-known/oauth-protected-resource",
    "oauth_protected_resource_api": "https://clearlist.me/.well-known/oauth-protected-resource/api",
    "health": "https://clearlist.me/api/status"
  }
}