Secondhand MCP server
io.github.jlsookiki/secondhand-mcp·v0.6.0·96 starsSearch Facebook Marketplace, eBay, Depop, and Poshmark from AI — filters, photos, full listings.
96 stars161 downloads/wk
Reviews
Write oneNobody has reviewed Secondhand yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Secondhand tools (5)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
fetchFetch full listing details for a result ID returned by the search tool. ID format: marketplace:listingId (e.g., "facebook:12345" or "ebay:v1|123|456").
get_listing_detailsGet full details for a specific listing using an ID from search results: description, all photos, location, seller info, and shipping. Photos: by default (imageMode:"urls") you get direct full-resolution CDN image URLs to fetch yourself — most reliable, since some CDNs block server-side fetches. Set imageMode:"inline" (or includeImages:true) to have the server fetch the photos and return them as b
list_marketplacesList all available marketplaces and their status
searchSearch all available secondhand marketplaces at once (deep research). Returns results whose IDs (marketplace:listingId) can be passed to the fetch tool for full listing details.
search_marketplaceSearch for items on secondary marketplaces. Supports: …. Returns listing ID, title, price, location, and photo count. Facebook: location-based search, no auth. eBay: keyword search with condition filter, requires API keys. Depop: keyword search with filters for sort, condition, category, brands, sizes, colors (requires Chrome). Poshmark: keyword search with filters for sort, condition, sizes, colo
Public scan report
scanner v0.1.10 · 2026-10-29 · same rubric, same numbers if you re-run it
- Code scan21 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 23 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Secondhand compares
Against every graded E-commerce MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 83/100
- higher than 77% of 2,170 E-commerce servers
- Tools
- 5
- the typical E-commerce server has 6
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 96
- more than 95% of 1,049 E-commerce servers
- Downloads a week
- 161
- more than 75% of 412 E-commerce servers with a package
What its tools let an agent do: 5 read
Install Secondhand in Claude Code, Cursor or VS Code
Runs npx -y secondhand-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add secondhand-mcp -- npx -y secondhand-mcp
What the publisher says
From the Secondhand repository's README, as published. We do not edit it. Read it on GitHub
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.
Supported Marketplaces
Setup
Claude Desktop
Add to ~/Library/Application Support/Claude/claudedesktopconfig.json:
{
"mcpServers": {
"secondhand": {
"command": "npx",
"args": ["-y", "secondhand-mcp"],
"env": {
"EBAY_CLIENT_ID": "your-ebay-client-id",
"EBAY_CLIENT_SECRET": "your-ebay-client-secret",
"EBAY_MARKETPLACE_ID": "EBAY_US"
}
}
}
}Claude Code
Add to ~/.claude/.mcp.json:
{
"mcpServers": {
"secondhand": {
"command": "npx",
"args": ["-y", "secondhand-mcp"],
"env": {
"EBAY_CLIENT_ID": "your-ebay-client-id",
"EBAY_CLIENT_SECRET": "your-ebay-client-secret",
"EBAY_MARKETPLACE_ID": "EBAY_US"
}
}
}
}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):
{
"env": {
"MARKETPLACES": "facebook,ebay"
}
}Valid values: facebook, ebay, depop, poshmark
eBay API Keys
eBay uses the official Browse API. You need a free eBay developer account:
- Create an account at developer.ebay.com
- Create an application to get a Client ID and Client Secret
- Add them to your MCP config as EBAYCLIENTID and EBAYCLIENTSECRET
eBay Marketplace / Region
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Secondhand: common questions
- Is Secondhand MCP server safe?
- Mostly: it is graded B (83/100). Read the Secondhand safety report
- How do I install Secondhand?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Secondhand need an API key?
- Yes. The registry entry asks for
EBAY_CLIENT_ID,EBAY_CLIENT_SECRET. - Is Secondhand maintained?
- The last commit was 31 days ago (2026-10-05). The latest release is v0.6.0.
- What can I use instead of Secondhand?
- Servers from other publishers that do the same job: Seerxo MCP server, Apiguru Amazon Data MCP server and Avito MCP server.
- How does Secondhand compare with other E-commerce MCP servers?
- safety score 83/100 (higher than 77% of 2,170 E-commerce servers); tools 5 (the typical E-commerce server has 6); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Secondhand
Same job from other publishers: the closest match first, then the best rated.
- SeerxoGenerate SEO-optimized Etsy listings — title, description, and 13 tags — from your AI assistant.not reviewedEstablishedA
Apiguru Amazon DataLive Amazon product, review, search, deal, offer/stock and seller data across 23 marketplaces.not reviewedGrowingA- AvitoMCP server for Avito: chats, listings, orders and analytics, with previews and confirmations.not reviewedGrowingB
- ShopeeMCP server for Shopee — LatAm marketplace Partner API v2 (orders, products, shipping, returns)not reviewedGrowingB
InstantClipsCreate branded vertical video ads from ecommerce product URLs or product photos.not reviewedGrowingA