Clearlist
ClearList ist ein KI-gestützter Wiederverkaufsmanager. Umzug, Verkleinerung oder einfach nur die Garage ausmisten: Fotos hochladen und fertig. Die KI erstellt jedes Inserat, recherchiert den Preis und ermittelt die Maße. Teile einen Link überall dort, wo Käufer bereits sind. Sie reservieren, planen ihre Abholung und erscheinen. Kein „Ist das noch verfügbar?“ mehr.
Dokumentation
ClearList — Developer & Agent Surface
ClearList is an AI resale manager: photograph your stuff, AI writes complete priced listings in about 30 seconds, and one shareable link runs an automatic buyer queue. Built for movers, downsizers, estate sales, and anyone clearing out more than a few things.
This repository is the public developer surface for ClearList — the Model Context Protocol (MCP) server and the documentation AI agents need to use ClearList programmatically. Every action a seller can take in the web UI is available here through the API and MCP server.
What's here
mcp-server/— the ClearList MCP server. Any MCP-compatible agent (Claude, ChatGPT, Gemini, Manus, custom agents) can onboard a seller, create listings, publish a sale page, and manage buyers. See its README for full setup.
Quick start
git clone https://github.com/Cuneiform-LLC/clearlist-mcp
cd clearlist-mcp/mcp-server
npm install
npm run build
Then point your agent at mcp-server/dist/index.js with CLEARLIST_API_URL=https://clearlist.me. The no-account "Grandma Flow" (the agent creates the account through conversation) and returning-user setup are both documented in the mcp-server README.
Live discovery documents
Agents can discover ClearList directly from the site, no clone required:
- Developer page: https://clearlist.me/developers
- API documentation: https://clearlist.me/docs/api
- OpenAPI 3.1 spec: https://clearlist.me/.well-known/openapi.json
- MCP server card (SEP-1649): https://clearlist.me/.well-known/mcp/server-card.json
- Agent card (A2A): https://clearlist.me/.well-known/agent-card.json
- Agent skills index: https://clearlist.me/.well-known/agent-skills/index.json
- API catalog (RFC 9727): https://clearlist.me/.well-known/api-catalog
- Authentication guide: https://clearlist.me/auth.md
- llms.txt: https://clearlist.me/llms.txt
Authentication
Agents authenticate with an API key (X-ClearList-API-Key: cl_<64-hex>) obtained through an email one-time-code flow — no OAuth redirect, no password. Details: https://clearlist.me/auth.md
About
Built by Cuneiform LLC. Product: https://clearlist.me
License
MIT — see LICENSE.