ClearList

ClearList is an AI resale manager. Photograph what you are selling and it writes the listing, prices it, and publishes one shareable page. Buyers reserve items, queue up behind each other, and book their own pickup slots, so nobody has to ask "is this still available?" or negotiate a Saturday over text.

This package ships two things:

• clearlist, a command line tool for scripting seller actions against the REST API.
• clearlist-mcp-server, a Model Context Protocol server so Claude or any other MCP client can run a sale end to end.

This is the unscoped alias of @clearlist/mcp-server. Both packages are published from the same source at the same version. Install whichever name you prefer.

Install

npm install -g clearlist

Or run it without installing:

npx clearlist login [email protected]

CLI

Authentication is passwordless. You get a six digit code by email, and the CLI stores the resulting API key in ~/.clearlist/config.json. Every command prints JSON, so output pipes cleanly into scripts.

clearlist login [email protected]          # send a sign-in code
clearlist verify [email protected] 123456  # exchange the code for an API key
clearlist items                          # list your listings
clearlist publish --city "Austin"        # publish the sale page, get the URL
clearlist reservations                   # who reserved what
clearlist reply <conversationId> "Yes, still available"
clearlist picked-up <itemId>             # mark an item sold
clearlist status                         # plan, capacity, expiry

MCP server

Remote endpoint (no install)

Most hosts can connect straight to the hosted endpoint. Sign-in happens in your browser.

https://clearlist.me/api/mcp

In Claude, go to Settings, then Connectors, then add a custom connector with that URL. This works on the free plan.

ChatGPT cannot do this on a personal account. As of August 2026 custom connectors are a Business and Enterprise/Edu feature that a workspace admin enables, on the web only, so Plus and Pro have no way to add one. Consumer access is coming via the ChatGPT Plugin Directory, where our listing is in progress. Until then, use the local stdio path below, which works with Codex and any other MCP client that runs a local server.

Local stdio

{
  "mcpServers": {
    "clearlist": {
      "command": "npx",
      "args": ["-y", "clearlist-mcp-server"],
      "env": {
        "CLEARLIST_API_KEY": "cl_your_key_or_omit_for_onboarding"
      }
    }
  }
}

CLEARLIST_API_KEY is optional. Without it, an agent can create the account and obtain a key at runtime through the email verification tools, which means someone can run an entire sale without ever opening clearlist.me.

Tools

28 tools: 2 onboarding, 23 seller actions, and 3 discovery stubs. The seller tools cover listing creation (single and bulk), page publishing, reservations, buyer messaging, pickup scheduling, cross posting, payment links, and the two-step address share. The discovery three return NOT_IMPLEMENTED pending a future release.

The MCP server is a thin protocol adapter over the same REST routes the web UI calls. It cannot share your pickup address on its own, and no flag makes it possible. Sharing takes two calls with your answer in between: the first names who would receive it and discloses nothing to them, and only after you agree does the second send it. Only a buyer who verified their email by reserving can receive one, and you get an email recording every share. Disclosing where you live is a physical-safety decision, so it stays yours to make.

Documentation

• Developer docs: https://clearlist.me/developers
• OpenAPI 3.1 spec: https://clearlist.me/.well-known/openapi.json
• MCP server card: https://clearlist.me/.well-known/mcp/server-card.json
• Source: https://github.com/Cuneiform-LLC/clearlist-mcp

License

MIT