AI resale manager. Photograph an item, AI writes the listing, publish a sale page, manage pickups.
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.
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 with npx skills add Cuneiform-LLC/clearlist-mcp.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.
Agents can discover ClearList directly from the site, no clone required:
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
Built by Cuneiform LLC. Product: https://clearlist.me
MIT — see LICENSE.
Source-derived launch command. Check the maintainer’s required arguments and credentials before running:
npx -y @clearlist/mcp-serverMerge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.
{
"mcpServers": {
"io-github-cuneiform-llc-clearlist": {
"command": "npx",
"args": [
"-y",
"@clearlist/mcp-server"
]
}
}
}Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.
Claude Desktop setup reference@clearlist/mcp-servernpmio.github.Cuneiform-LLC/clearlist works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.
~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.~/.cursor/mcp.jsonRestart Cursor for changes to take effect..vscode/mcp.jsonReload VS Code window for changes to take effect.~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect..mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.