{
  "markdown": "# ClearList — Developer & Agent Surface\n\n[ClearList](https://clearlist.me) 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.\n\nThis 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.\n\n## What's here\n\n- [`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](./mcp-server/README.md) for full setup.\n- [`skills/clearlist/`](./skills/clearlist) — an [Agent Skill](https://skills.sh) 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`.\n\n## Quick start\n\nThe fastest path is the Agent Skill. One command, no clone, no build, and it works\nacross Claude Code, Codex, Gemini CLI, Copilot, Antigravity, and a dozen other hosts:\n\n```bash\nnpx skills add Cuneiform-LLC/clearlist-mcp\n```\n\nThat installs the [`clearlist`](./skills/clearlist) skill, which teaches your agent the\nwhole flow: no-browser account setup, bulk photo intake, publishing, the buyer queue,\nand the one capability it must never reach for. It also tells the agent to configure the\nMCP server below, so this is the only step most people need.\n\nIf you would rather run the server from source:\n\n```bash\ngit clone https://github.com/Cuneiform-LLC/clearlist-mcp\ncd clearlist-mcp/mcp-server\nnpm install\nnpm run build\n```\n\nThen 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](./mcp-server/README.md).\n\n## Live discovery documents\n\nAgents can discover ClearList directly from the site, no clone required:\n\n- Developer page: https://clearlist.me/developers\n- API documentation: https://clearlist.me/docs/api\n- OpenAPI 3.1 spec: https://clearlist.me/.well-known/openapi.json\n- MCP server card (SEP-1649): https://clearlist.me/.well-known/mcp/server-card.json\n- Agent card (A2A): https://clearlist.me/.well-known/agent-card.json\n- Agent skills index: https://clearlist.me/.well-known/agent-skills/index.json\n- API catalog (RFC 9727): https://clearlist.me/.well-known/api-catalog\n- Authentication guide: https://clearlist.me/auth.md\n- llms.txt: https://clearlist.me/llms.txt\n\n## Authentication\n\nAgents 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\n\n## About\n\nBuilt by [Cuneiform LLC](https://github.com/Cuneiform-LLC). Product: https://clearlist.me\n\n## License\n\nMIT — see [LICENSE](./LICENSE).\n",
  "bytes": 3193,
  "sha": "9500b38392f48222f33ddc40b91eba514fca5d2661238eb49f0bf72c4615d271",
  "repo_slug": "cuneiform-llc/clearlist-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_cuneiform_llc_clearlist_22b01efe/readme"
}