Log inSubmit server
Secondhand MCP logo

Secondhand MCP

Search Facebook Marketplace, eBay, Depop, and Poshmark with filters, listing details, photos, and seller information.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Secondhand MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "secondhand-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "secondhand-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

The secondhand-mcp MCP server lets local AI clients search Facebook Marketplace, eBay, Depop, and Poshmark. Its tools support marketplace-wide searches, price and item filters, listing detail retrieval, and marketplace status checks. Facebook searches use location and radius, eBay uses its Browse API, and Depop and Poshmark require Chrome for browser-based searches. Use it when an agent needs to compare secondhand listings from several marketplaces on a local computer.

Use cases

  • Search local Facebook Marketplace listings within a price range
  • Compare used clothing across Depop and Poshmark
  • Retrieve photos and seller details for a listing
  • Search regional eBay marketplaces with API credentials
  • Check which marketplace connectors are available

Key features

  • Cross-marketplace secondhand item search
  • Price, condition, category, size, and color filters
  • Location and radius filtering for Facebook Marketplace
  • Full listing details with photos and seller data
  • Optional eBay regional marketplace selection
  • Marketplace availability reporting

Tools3

What Secondhand MCP lets your agent do. Expand a tool for its parameters.

Self-reported~53 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

8/8 checks healthy over the last 40d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 13d ago via OSV.dev · secondhand-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars92Stargazers on the source repository.
npm downloads775Package downloads in the last 30 days.
Last commit17d agoMost recent push to the default branch.
Tools exposed3Callable tools this server registers over MCP.

How Secondhand MCP works

What secondhand-mcp MCP server does

The secondhand-mcp MCP server exposes secondhand shopping searches to MCP-compatible AI assistants. It can query Facebook Marketplace, eBay, Depop, and Poshmark, then return search results or fuller information for a selected listing. Search criteria can include query text, price bounds, marketplace, result count, condition, category, size, and color. Some filters are marketplace-specific: Facebook supports location, radius, and sold-item settings; Poshmark supports brand and department; Depop and Poshmark support clothing-oriented categories and sizes.

Search results provide core listing information such as title and price. Depending on the marketplace, results can also include location, condition, seller data, and a thumbnail. A second request can retrieve the description, complete photo set, seller identity, location, delivery information, and shipping details available for that marketplace.

How it works

Facebook Marketplace searches use a city and radius, with a default location of San Francisco and a default radius of 25 miles. The server resolves the city to coordinates and does not require a login or browser. If Facebook limits its non-browser search response, the server falls back to reading the logged-out search page.

eBay searches use the official Browse API and OAuth 2.0 client credentials. Access tokens are cached and refreshed automatically. The selected regional eBay site is controlled by EBAY_MARKETPLACE_ID, which defaults to the US marketplace.

Depop and Poshmark searches run through a shared headless Chrome or Chromium browser. The browser is launched only for those searches. On macOS, Node.js may need permission to control Chrome the first time one of these marketplaces is used.

Setup and configuration

Run the server locally through npx -y secondhand-mcp and add that command to an MCP client configuration. The README provides configurations for Claude Desktop and Claude Code, and identifies Cursor as supported. eBay access requires an eBay developer application with a client ID and client secret. The EBAY_MARKETPLACE_ID setting can select regional sites such as EBAY_DE, EBAY_GB, or EBAY_CA.

All marketplaces are enabled by default when available. Set MARKETPLACES to a comma-separated list such as facebook,ebay to restrict the active sources. Missing eBay credentials disable eBay, while missing Chrome disables Depop and Poshmark; the remaining sources continue to operate. This makes the secondhand-mcp MCP server usable without configuring every marketplace.

Tools and capabilities

  • search_marketplace searches one marketplace or all enabled marketplaces. It supports price limits, result limits, optional image URLs, marketplace-specific sorting, and supported condition or product filters.
  • get_listing_details retrieves full information using a listing ID returned by a search.
  • list_marketplaces reports which marketplaces are enabled and their status.
  • search and fetch provide a simpler pair for research clients that expect the ChatGPT Deep Research tool contract. search returns normalized result records, while fetch returns normalized listing details.

Limitations and notes

Facebook location filtering applies only to Facebook. Brand and department filters apply only to Poshmark, while category, size, and color support varies across Depop and Poshmark. Depop and Poshmark are not location-based in the documented behavior. The local setup is intended for desktop clients and requires the computer running the server to remain available; the README specifically says it does not work with ChatGPT’s hosted experience. The secondhand-mcp MCP server is therefore a fit for local MCP workflows rather than phone-based or always-on searching.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Secondhand MCP

secondhand-mcp is an MCP server that connects AI assistants to Facebook Marketplace, eBay, Depop, and Poshmark. Its main tools search listings, retrieve full listing details with photos and seller information, and report enabled marketplace status. It runs locally through an MCP client such as Claude Desktop, Claude Code, or Cursor.

Install it by configuring an MCP client to run `npx -y secondhand-mcp`. The README includes JSON examples for Claude Desktop and Claude Code. Add eBay credentials if eBay searches are needed, and install Chrome or Chromium if Depop or Poshmark searches are needed.

Configure Cursor to start the local server with `npx -y secondhand-mcp`; optional eBay credentials and a Chrome installation control which marketplace connectors are available.

eBay searches need an eBay developer application with `EBAY_CLIENT_ID` and `EBAY_CLIENT_SECRET`. `EBAY_MARKETPLACE_ID` selects the regional site and defaults to `EBAY_US`. Facebook, Depop, and Poshmark do not require eBay credentials.

No, Depop and Poshmark require Google Chrome or Chromium for their headless browser searches. If Chrome is unavailable, those marketplaces are automatically skipped while other available marketplaces continue to work.

Related MCP servers

All in Social Media All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewSecondhand MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/secondhand-mcp?style=directory)](https://allmcps.com/mcp/secondhand-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/secondhand-mcp"><img src="https://allmcps.com/api/badge/secondhand-mcp?style=directory" alt="Secondhand MCP on AllMCPs" /></a>