What can you do with clearlist?

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:

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.

Install

Add clearlist to your client. Pick the one you use.

{
  "servers": {
    "mcp-server": {
      "type": "http",
      "url": "https://clearlist.me/api/mcp"
    }
  }
}

Add to `.vscode/mcp.json` in your workspace.

claude mcp add mcp-server -- npx -y @clearlist/mcp-server

codex mcp add mcp-server -- npx -y @clearlist/mcp-server

amp mcp add mcp-server -- npx -y @clearlist/mcp-server

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@clearlist/mcp-server"
      ]
    }
  }
}

Add to `claude_desktop_config.json`, then restart Claude Desktop.

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@clearlist/mcp-server"
      ]
    }
  }
}

Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@clearlist/mcp-server"
      ]
    }
  }
}

Add to `~/.codeium/windsurf/mcp_config.json`.

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@clearlist/mcp-server"
      ]
    }
  }
}

Add to `cline_mcp_settings.json` via the MCP Servers panel.

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@clearlist/mcp-server"
      ]
    }
  }
}

Add to `~/.gemini/settings.json`.

{
  "mcpServers": {
    "mcp-server": {
      "type": "local",
      "command": "npx",
      "args": [
        "-y",
        "@clearlist/mcp-server"
      ],
      "tools": [
        "*"
      ]
    }
  }
}

Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.

{
  "context_servers": {
    "mcp-server": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@clearlist/mcp-server"
        ]
      }
    }
  }
}

Add to your Zed `settings.json`.

npx -y @clearlist/mcp-server

Run `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.

Score

39 / 100

Incomplete

Documentation22/25
Maintenance25/25
Trust16/20
Capability0/15
Install experience15/15

Documents what it does and how to connect
Has a resolvable package or endpoint
Exposes at least one tool, prompt or resource
README has substantive content
Includes a code example
Documents its configuration
Mentions credentials or security posture
Last commit 4 days ago
Has a release history
Repository is not archived
Licensed MIT
Namespace verified in the official MCP registry
Claimed by its owner
Published under an organisation
0 tool(s) documented
Provides prompt templates
Provides resources
18 documented install method(s)
Published to a package registry
Offers a hosted endpoint — no local install

Read the full rubric →

Version history

Versions	Published
0.9.19Latest	Aug 28, 2026
0.9.18	Aug 26, 2026
0.9.12	Aug 21, 2026
0.9.11	Aug 20, 2026
0.9.4	Aug 15, 2026
0.9.3	Aug 12, 2026
0.9.2	Aug 12, 2026
0.9.1	Aug 8, 2026
0.9.0	Aug 8, 2026
0.7.0	Aug 7, 2026
0.6.1	Aug 5, 2026
0.6.0	Aug 3, 2026
0.5.0	Jul 31, 2026
0.4.2	Jul 29, 2026
0.4.1	Jul 28, 2026