English Français العربية

io.github.Cuneiform-LLC/clearlist

السجل الرسمي الوسائط والتصميم

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http clearlist 'https://clearlist.me/api/mcp'
إعداد JSON (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 (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"
            }
        }
    }
}

متغيرات البيئة

  • CLEARLIST_API_KEY سري 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.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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.

الأسئلة الشائعة

ما هو io.github.Cuneiform-LLC/clearlist؟

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

كيف أثبّت io.github.Cuneiform-LLC/clearlist؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http clearlist 'https://clearlist.me/api/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.Cuneiform-LLC/clearlist إلى مفتاح API؟

نعم. يتطلب CLEARLIST_API_KEY، وتضبطها في إعداداته.

هل io.github.Cuneiform-LLC/clearlist مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.Cuneiform-LLC/clearlist؟

ينشره Cuneiform-LLC. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.