Clearlist

io.github.Cuneiform-LLC由 GitHub 账号 Cuneiform-LLC 发布v0.10.0更新于 Oct 30, 2026

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

已验证Streamable HTTP可网页运行效率与工作流网页搜索与抓取商业与电商

概览

AI 生成的概览

ClearList MCP 服务器让 AI 助手代为经营二手转卖：把照片变成商品信息、发布售卖页面并处理买家预约。

可以做什么
  • 创建与管理商品：用 1-5 张照片生成商品信息，或批量处理最多 50 张照片，并可编辑或删除商品
  • 发布与管理售卖页：按城市发布、下线页面，查看浏览量与预约统计
  • 处理买家：查看预约与消息记录、回复买家、确认取货并将商品标记为已售
  • 配置售卖：设置取货时间段、生成用于 Craigslist 或 Facebook 的跨平台发布文案、查看账户资料与订阅等级
  • 发现附近售卖：按关键词、城市、类别或价格搜索商品，查找某地点附近或某城市的进行中售卖
  • 开通账户：发送邮箱验证码并校验，创建账户并获取 API 密钥
适用场景
适合想通过对话出售家中闲置物品或办一场庭院售卖的人，包括批量上传照片、定价、发布可分享的售卖页以及与买家协调取货。也适合浏览附近的售卖活动。
运行要求
可作为 clearlist.me 的远程端点使用，也可作为本地 npm 包（@clearlist/mcp-server）通过 stdio 运行，后者需要 Node.js 并执行构建。认证使用 OAuth 或 CLEARLIST_API_KEY 中的 API 密钥；没有密钥时助手可通过邮箱验证创建账户。CLEARLIST_API_URL 可覆盖 API 基础地址。
安装前请注意
服务器会代用户创建账户和 API 密钥，密钥在会话期间保存在内存中。工具会写入和删除数据：商品会被永久删除，页面会公开发布，消息会发送给买家。它还会为付费订阅升级生成 Stripe 支付链接。照片和商品数据会发送到 ClearList 服务及其 AI 后端。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Clearlist，将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.Cuneiform-LLC%2Fclearlist/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。

{
  "mcpServers": {
    "clearlist": {
      "type": "http",
      "url": "https://clearlist.me/api/mcp"
    }
  }
}

README

ClearList MCP Server

[LightNow capabilities]

AI agent interface to ClearList, an AI resale manager. Any MCP-compatible agent (Claude, ChatGPT, Gemini, Manus, custom agents) can create listings, publish sale pages, and manage reservations — all through the same API routes the web UI uses.

Users never need to visit clearlist.me. The agent handles account creation, photo processing, listing generation, and publishing entirely through conversation.

Quick Start

bash
cd mcp-servernpm installnpm run build

CLI

The package also ships a clearlist command-line tool for scripting seller actions directly against the REST API — no MCP host required:

bash
npm install -g @clearlist/mcp-server
clearlist login [email protected]        # send a 6-digit sign-in codeclearlist verify [email protected] 123456  # store the API key in ~/.clearlist/config.jsonclearlist items                        # list your listingsclearlist publish --city "Austin"      # publish the sale page, get the URLclearlist reservations                 # who reserved whatclearlist reply <conversationId> "Yes, still available"clearlist picked-up <itemId>           # mark an item soldclearlist status                       # plan, capacity, expiry

Every command prints JSON (pipe to jq for scripting). CLEARLIST_API_KEY overrides the stored key; CLEARLIST_API_URL overrides the default https://clearlist.me. Run clearlist help for the full reference.

MCP Apps (interactive UI)

get_listings, publish_page, and get_reservations declare an MCP Apps view (ui://clearlist/app.html) via _meta.ui.resourceUri. Hosts that render MCP Apps (ChatGPT, Claude.ai) show a listings gallery, a publish success card, or a reservations summary inline; hosts without UI support ignore the metadata and get the same JSON as before. View sources live in src/ui/views/ and are bundled into src/ui/generated-views.ts with npm run build:ui.

Two Ways to Connect

Option A: New user (no account yet)

No API key needed. The agent creates the account through conversation:

json
{  "mcpServers": {    "clearlist": {      "command": "node",      "args": ["/absolute/path/to/mcp-server/dist/index.js"],      "env": {        "CLEARLIST_API_URL": "https://clearlist.me"      }    }  }}

The agent uses send_verification_code + verify_code to authenticate. An API key is generated automatically and stored in memory for the session.

Option B: Returning user (has API key)

If the agent already has a key from a previous session:

json
{  "mcpServers": {    "clearlist": {      "command": "node",      "args": ["/absolute/path/to/mcp-server/dist/index.js"],      "env": {        "CLEARLIST_API_URL": "https://clearlist.me",        "CLEARLIST_API_KEY": "cl_your_api_key_here"      }    }  }}

All tools work immediately — no onboarding needed.

How It Works (The Grandma Flow)

Grandma → ChatGPT: "I'm moving, help me sell my stuff"ChatGPT: "Sure! What's your email?"Grandma: "[email protected]"
    [agent calls send_verification_code({ email: "[email protected]" })]
ChatGPT: "I sent you a 6-digit code. Check your email."Grandma: "482019"
    [agent calls verify_code({ email: "[email protected]", code: "482019" })]    → account created, API key returned, all tools unlocked
ChatGPT: "Account created! Now send me photos of everything you want to sell."Grandma: [sends 20 photos]
    [agent calls bulk_create_listings({ photos: [...20 photos] })]    → AI groups by item, generates listings, researches prices, validates
ChatGPT: "I found 12 items. Here's what I got:          1. IKEA Kallax Shelf — $45 (Good condition)          2. KitchenAid Mixer — $120 (Like New)          ...          Want me to publish your sale page?"
Grandma: "Yes! I'm in Austin."
    [agent calls publish_page({ city: "Austin", state: "TX" })]
ChatGPT: "Done! Your sale page is live at clearlist.me/grandmas-sale          Share this link on Facebook or Nextdoor."

Grandma never visited a website. Never generated an API key. Never created an account manually.

Available Tools (24)

Onboarding Tools (2) — No API key required

ToolDescription
send_verification_codeSend a 6-digit code to an email address
verify_codeVerify the code, create account if new, get API key

Seller Tools (19)

ToolDescription
create_listingSend 1-5 photos → AI generates listing → saves to account
bulk_create_listingsSend up to 50 photos → AI groups, generates, prices, QA-checks → saves all
edit_listingUpdate any field on a listing
delete_listingPermanently remove a listing
publish_pagePublish sale page with city, get shareable URL
unpublish_pageTake sale page offline
get_listingsList all items with status, price, queue count
get_reservationsSee buyer reservations, messages, timer status
get_conversationGet full message thread with a specific buyer
reply_to_buyerSend message to a buyer
mark_picked_upMark item as sold
confirm_pickupConfirm a scheduled pickup
get_page_statsPage views, item count, reservation stats
prepare_crosspostGenerate cross-posting content for Craigslist/Facebook
set_availabilityConfigure pickup scheduling windows
get_profileGet account profile and tier info
check_tier_statusCheck subscription tier and limits
generate_payment_linkGenerate Stripe payment link for upgrades

Discovery Tools (3) — Phase 14

ToolDescription
search_itemsSearch items across all sales by keyword, city, category, price
get_sales_nearFind active sales near a location
get_city_salesBrowse all sales in a city

Architecture

User (via any AI agent)  │  ▼Agent (ChatGPT, Claude, Gemini, Manus, etc.)  │  ▼ClearList MCP Server (this package)  │  stdio transport  │  ▼ClearList API Routes (/api/*)  │  HTTP + X-ClearList-API-Key header  │  ▼Firebase (Firestore, Auth, Storage) + Gemini AI

The MCP server is a thin protocol adapter. Zero business logic — everything lives in the API routes.

Authentication Flow

                    ┌─────────────────────────────────┐                    │   Agent starts (no API key)      │                    └─────────────┬───────────────────┘                                  │                    ┌─────────────▼───────────────────┐                    │  send_verification_code          │                    │  POST /api/auth/send-code        │                    │  { email: "[email protected]" }     │                    └─────────────┬───────────────────┘                                  │  ← email sent with 6-digit code                    ┌─────────────▼───────────────────┐                    │  verify_code                     │                    │  POST /api/auth/verify-code      │                    │  { email, code, agent: true }    │                    └─────────────┬───────────────────┘                                  │  ← creates account + returns API key                    ┌─────────────▼───────────────────┐                    │  API key stored in memory        │                    │  All subsequent calls use it     │                    │  X-ClearList-API-Key: cl_xxx     │                    └─────────────────────────────────┘

Development

bash
# Type-checknpm run type-check
# Buildnpm run build
# Run directly (for testing)CLEARLIST_API_URL=http://localhost:3000 npm run dev

来源：mcp-server/README.md，提交 bc7274c

工具

0
该服务器需要登录，因此 SourceWeft 无法在没有账号的情况下读取其工具，也未收录。已连接账号所能看到的内容可能因账号及其权限而异。

版本历史

4
  1. v0.10.0最新Oct 15, 2026
  2. v0.9.24Sep 23, 2026
  3. v0.9.22Sep 17, 2026
  4. v0.9.21Sep 16, 2026

评分

已满足适用检查项的 85%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分