Facebook Marketplace MCP

A focused Model Context Protocol server for searching Facebook Marketplace from AI agents.

This repo is a hardened, Facebook-only variant inspired by jlsookiki/secondhand-mcp. It keeps the useful Facebook Marketplace search and details flow, removes the eBay/Depop/Poshmark paths, and avoids browser automation entirely.

What It Does

Search Facebook Marketplace listings by query, city, and price range
Get full listing details from a returned listing ID
Return listing title, price, location, seller name when available, URL, description, delivery type, and photo URLs
Prefer exact US city matches when Facebook returns ambiguous locations

Safety Defaults

No Facebook login
No Facebook cookies
No Chrome or headless browser automation
No browser profile access
No eBay API keys
No paid APIs

The server only calls Facebook public/internal Marketplace GraphQL endpoints. These endpoints can change, so the tool may need maintenance if Facebook updates its frontend operation IDs.

Install

Requires Node.js 20.18.1+.

npm install
npm run build

MCP Config

Claude Desktop

Add this to your Claude Desktop MCP config:

{
  "mcpServers": {
    "facebook-marketplace": {
      "command": "node",
      "args": ["/absolute/path/to/facebook-marketplace-mcp/dist/index.js"]
    }
  }
}

OpenClaw

openclaw mcp add facebook-marketplace \
  --command node \
  --arg dist/index.js \
  --cwd /absolute/path/to/facebook-marketplace-mcp \
  --include search_marketplace,get_listing_details,list_marketplaces

Tools

`search_marketplace`

Search Facebook Marketplace.

Parameters:

query required: search terms, for example go kart
location optional: city or area, default phoenix
maxPrice optional: maximum price
minPrice optional: minimum price
limit optional: maximum results, default 20, Facebook caps one request at 24
showSold optional: include sold/pending/unavailable listings
includeImages optional: include image URLs in search results

Example:

{
  "query": "go kart",
  "location": "phoenix",
  "maxPrice": 1500,
  "limit": 5
}

`get_listing_details`

Get full details for one listing.

Parameters:

listingId required: ID from search_marketplace

Example:

{
  "listingId": "999433246010406"
}

`list_marketplaces`

Returns the enabled adapter and auth status.

Development

npm install
npm run build
npm audit --omit=dev

Quick smoke test:

node dist/index.js

Use an MCP client to call search_marketplace with a small limit before increasing scan volume.

Limitations

Facebook can change its internal GraphQL doc_id values without notice.
Location matching depends on Facebook's location search results.
Search radius is currently fixed to the same local radius used by the upstream implementation.
Respect Facebook's terms and rate limits. Do not hammer the endpoint.

Attribution

Derived from the Facebook Marketplace implementation in:

https://github.com/jlsookiki/secondhand-mcp

Original project copyright belongs to its author. This repo keeps the MIT license.

License

MIT