jlsookiki/secondhand-mcp

A Model Context Protocol (MCP) server that lets AI assistants search secondhand marketplaces. Search Facebook Marketplace, eBay, Depop, and Poshmark for used and secondhand items — filter by price, category, condition, size, and color, then get full listing details with photos, descriptions, and seller info.
Works with Claude Desktop, Claude Code, Cursor, and other clients that run MCP servers locally.
> [!TIP]
> **Using ChatGPT? This one won't work there.**
>
> It runs on your computer, so it only works where your computer is — Claude Desktop, Claude Code, Cursor. Secondhand MCP Cloud is the same search, always on, so whichever assistant you actually use can reach it. Free tier, no card.
| | This repo | Cloud |
|---|---|---|
| Claude Desktop, Code, Cursor | ✅ | ✅ |
| ChatGPT, Claude, and other assistants | — | ✅ |
| Searching from your phone | — | ✅ |
| Chrome running in the background | needed | not needed |
| Price | free, forever | free tier, then $4.99 |
Supported Marketplaces
| Marketplace | Auth Required | Notes |
|-------------|---------------|-------|
| Facebook Marketplace | No | Location-based search |
| eBay | Yes (API keys) | Official Browse API |
| Depop | No | Requires Chrome installed |
| Poshmark | No | Requires Chrome installed |
Setup
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
Claude Code
Add to ~/.claude/.mcp.json:
eBay, Depop, and Poshmark are all optional — if eBay API keys are missing or Chrome isn't installed, those marketplaces are automatically disabled and the rest still work.
Depop & Poshmark / Chrome Requirement
Depop and Poshmark require a headless browser. If **Google Chrome or Chromium** is installed on your system, both are automatically enabled — no config needed. If Chrome isn't found, they are silently skipped.
On macOS, the first time you search Depop or Poshmark, you may see a system prompt asking to allow Node.js to control Chrome. This is expected — puppeteer needs to launch Chrome in headless mode. Allow it once and it won't ask again.
The browser runs invisibly in the background and only launches when you actually search Depop or Poshmark.
Configuration
Choosing Marketplaces
By default all marketplaces are enabled. To limit which are active, set the MARKETPLACES env var (comma-separated):
Valid values: facebook, ebay, depop, poshmark
eBay API Keys
eBay uses the official Browse API. You need a free eBay developer account:
1. Create an account at developer.ebay.com
2. Create an application to get a Client ID and Client Secret
3. Add them to your MCP config as EBAY_CLIENT_ID and EBAY_CLIENT_SECRET
eBay Marketplace / Region
By default the server targets the **US** eBay site. To search a different regional marketplace, set the EBAY_MARKETPLACE_ID environment variable:
Common values:
| Value | Site |
|-------|------|
| EBAY_US | ebay.com (default) |
| EBAY_DE | ebay.de |
| EBAY_GB | ebay.co.uk |
| EBAY_AU | ebay.com.au |
| EBAY_FR | ebay.fr |
| EBAY_IT | ebay.it |
| EBAY_ES | ebay.es |
| EBAY_CA | ebay.ca |
The full list is available in the eBay API docs.
Tools
search_marketplace
Search for items across marketplaces.
| Parameter | Required | Default | Description |
|-----------|----------|---------|-------------|
| query | Yes | | Search terms |
| marketplace | No | facebook | facebook, ebay, depop, poshmark, or all |
| location | No | san francisco | City to search in (Facebook only) |
| radiusMiles | No | 25 | Search radius in miles, up to 500 (Facebook only) |
| maxPrice | No | | Maximum price |