io.github.Cuneiform-LLC/clearlist
AI resale manager. Photograph an item, AI writes the listing, publish a sale page, manage pickups.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http clearlist 'https://clearlist.me/api/mcp'
{
"mcpServers": {
"clearlist": {
"type": "http",
"url": "https://clearlist.me/api/mcp"
}
}
}
@clearlist/mcp-serverclaude mcp add clearlist -e 'CLEARLIST_API_KEY=<your clearlist_api_key>' -e 'CLEARLIST_API_URL=https://clearlist.me' -- npx -y @clearlist/mcp-server@0.10.0
{
"mcpServers": {
"clearlist": {
"command": "npx",
"args": [
"-y",
"@clearlist/mcp-server@0.10.0"
],
"env": {
"CLEARLIST_API_KEY": "<your clearlist_api_key>",
"CLEARLIST_API_URL": "https://clearlist.me"
}
}
}
}
Variables d'environnement
CLEARLIST_API_KEYsecret ClearList API key (cl_<64-hex>). Optional — if omitted, an agent can acquire one at runtime via the email-verification onboarding tools.CLEARLIST_API_URLBase URL of the ClearList API. Defaults to https://clearlist.me.
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
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.skills/clearlist/— an Agent Skill that teaches an agent how to run a sale end to end with the MCP server above, including the one thing it must never do. Install withnpx skills add Cuneiform-LLC/clearlist-mcp.
Quick start
The fastest path is the Agent Skill. One command, no clone, no build, and it works across Claude Code, Codex, Gemini CLI, Copilot, Antigravity, and a dozen other hosts:
npx skills add Cuneiform-LLC/clearlist-mcp
That installs the clearlist skill, which teaches your agent the
whole flow: no-browser account setup, bulk photo intake, publishing, the buyer queue,
and the one capability it must never reach for. It also tells the agent to configure the
MCP server below, so this is the only step most people need.
If you would rather run the server from source:
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.
Questions fréquentes
Qu'est-ce que io.github.Cuneiform-LLC/clearlist ?
AI resale manager. Photograph an item, AI writes the listing, publish a sale page, manage pickups.
Comment installer io.github.Cuneiform-LLC/clearlist ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http clearlist 'https://clearlist.me/api/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.Cuneiform-LLC/clearlist ?
Oui. Il attend CLEARLIST_API_KEY, à renseigner dans sa configuration.
io.github.Cuneiform-LLC/clearlist est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient io.github.Cuneiform-LLC/clearlist ?
Il est publié par Cuneiform-LLC. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.