English Français العربية

io.github.Cuneiform-LLC/clearlist

Official registry Media and design

AI resale manager. Photograph an item, AI writes the listing, publish a sale page, manage pickups.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http clearlist 'https://clearlist.me/api/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "clearlist": {
            "type": "http",
            "url": "https://clearlist.me/api/mcp"
        }
    }
}
NPM package @clearlist/mcp-server
Claude Code 
claude 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
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "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"
            }
        }
    }
}

Environment variables

  • CLEARLIST_API_KEY secret ClearList API key (cl_<64-hex>). Optional — if omitted, an agent can acquire one at runtime via the email-verification onboarding tools.
  • CLEARLIST_API_URL Base URL of the ClearList API. Defaults to https://clearlist.me.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. ClearList — Developer & Agent Surface
  2. What's here
  3. Quick start
  4. Live discovery documents
  5. Authentication
  6. About
  7. License

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 with npx 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:

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.

Frequently asked questions

What is io.github.Cuneiform-LLC/clearlist?

AI resale manager. Photograph an item, AI writes the listing, publish a sale page, manage pickups.

How do I install io.github.Cuneiform-LLC/clearlist?

It runs as a remote server. In Claude Code: claude mcp add --transport http clearlist 'https://clearlist.me/api/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.Cuneiform-LLC/clearlist need an API key?

Yes. It expects CLEARLIST_API_KEY, which you set in its configuration.

Is io.github.Cuneiform-LLC/clearlist open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.Cuneiform-LLC/clearlist?

It is published by Cuneiform-LLC. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.