secondhand

Secondhand MCP is an MCP server that enables AI assistants to search multiple secondhand marketplaces (Facebook Marketplace, eBay, Depop, and Poshmark) for used items. It supports filtering by price, category, condition, size, and color, and can return listings with photos, descriptions, and seller information. The server is designed to work with Claude Desktop, Claude Code, Cursor, and any MCP-compatible client. You can selectively enable marketplaces via environment variables and provide your own eBay API credentials to unlock the official eBay Browse API. To use the server, configure it in your MCP client to point at the secondhand-mcp package and supply required credentials if you want to use eBay.

Once configured, you can issue tools like search_marketplace to query across marketplaces, get_listing_details to fetch full details for a specific listing, and list_marketplaces to inspect which marketplaces are enabled. For Depop and Poshmark, a headless Chrome/Chromium is required; if Chrome isn’t installed, those marketplaces are skipped automatically. eBay requires valid API keys, and you can limit active marketplaces with the MARKETPLACES environment variable.

Prerequisites:

• Node.js and npm (recommended LTS)
• Git
• Optional: Google Chrome/Chromium for Depop and Poshmark (headless browser support)

Installation steps:

# 1) Ensure prerequisites are installed
# - Node.js and npm: https://nodejs.org/
# - Git: https://git-scm.com/

# 2) Clone the MCP server repository (or install via npm if published)
git clone https://github.com/jlsookiki/secondhand-mcp.git
cd secondhand-mcp

# 3) Install dependencies
npm install

# 4) Build the project (if required by the project setup)
npm run build

If you prefer to run directly via npx (as shown in the configuration), ensure the package is published as secondhand-mcp on npm and then enable it in your MCP client as described in the mcp_config section.

Tips and notes:

• By default, all marketplaces are enabled. To limit active marketplaces, set MARKETPLACES to a comma-separated list: e.g., {"env": {"MARKETPLACES": "facebook,ebay"}}.
• eBay requires a client ID and client secret from a developer account. These should be provided as EBAY_CLIENT_ID and EBAY_CLIENT_SECRET in your MCP config.
• Depop and Poshmark require a headless browser. If Chrome/Chromium is installed, they are automatically enabled; otherwise they are skipped. On macOS, you may be prompted to allow Node.js to control Chrome the first time you search Depop or Poshmark.
• Depop/Poshmark searches may be slower due to browser automation (~several seconds per search).
• The project includes guidance on adding new marketplaces by extending BaseMarketplace and updating index files. If you need to support additional marketplaces, follow the development steps in the README.