Facebook Marketplace MCP Server
Search and inspect Facebook Marketplace listings, look up locations, and manage saved search monitors for new listings.
Search listings by query, coordinates, radius, price range, category, and limit.
Fetch full details for a specific listing ID.
Resolve city/town names to coordinates.
Save searches as monitors with filters.
Check monitors for new listings since last check, list all monitors, or delete one.
Read-only: no messaging, listing creation, or other write operations.
Provides tools for accessing Facebook Marketplace, enabling AI agents to search listings by query, location, and filters (price range, category, radius), retrieve full details for specific listings, and save/manage/check monitors that track new listings matching a search over time. Read-only access with no messaging or listing creation.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Facebook Marketplace MCP Server search Marketplace for a used Herman Miller Aeron chair under $400"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Facebook Marketplace MCP Server
An MCP server that provides access to Facebook Marketplace via direct GraphQL API calls. No browser automation at runtime — speaks Facebook's internal protocol directly.
How It Works
Facebook's web client makes all Marketplace requests as POST /api/graphql/ with a doc_id (query hash) and variables. This server replays those requests using your existing Facebook session cookies from Chrome.
Related MCP server: Facebook Marketplace MCP
Prerequisites
macOS (cookie extraction uses Keychain)
Google Chrome with an active Facebook login
Node.js 20+
Installation
git clone <this-repo>
cd facebook-marketplace-mcp
npm install
npm run buildSetup with Claude Code
claude mcp add facebook-marketplace -- node /path/to/facebook-marketplace-mcp/dist/index.jsOr add to your Claude Code config manually:
{
"mcpServers": {
"facebook-marketplace": {
"command": "node",
"args": ["/path/to/facebook-marketplace-mcp/dist/index.js"],
"env": {
"CHROME_PROFILE": "Default"
}
}
}
}Tools
search_listings
Search Marketplace by query, location, and filters.
Parameter | Type | Required | Description |
| string | yes | Search term |
| number | yes | Latitude of search center |
| number | yes | Longitude of search center |
| number | no | Search radius (default: 50) |
| number | no | Min price in dollars |
| number | no | Max price in dollars |
| string | no | Category ID |
| number | no | Max results (default: 20) |
get_listing
Get full details for a specific listing.
Parameter | Type | Required | Description |
| string | yes | Marketplace listing ID |
monitor_search
Save a search as a monitor to track new listings over time.
Parameter | Type | Required | Description |
| string | yes | Monitor name |
| string | yes | Search term |
| number | yes | Search center lat |
| number | yes | Search center lng |
| number | no | Radius (default: 50) |
| number | no | Min price |
| number | no | Max price |
check_monitors
Check monitors for new listings since last check.
Parameter | Type | Required | Description |
| string | no | Check specific monitor, or omit for all |
list_monitors
List all saved monitors.
delete_monitor
Delete a saved monitor.
Configuration
Env Variable | Default | Description |
|
| Chrome profile directory name |
Updating GraphQL Queries
Facebook rotates their doc_id values on deploys. If searches stop working:
npm install -D playwright
npx playwright install chromium
npm run capture-queriesThis opens a browser, navigates Marketplace, and captures current query IDs. Update src/facebook/queries.ts with the new values.
Rate Limiting
The server self-rate-limits to 3 requests/minute with random jitter to avoid detection. This means searches take a few seconds.
Limitations
macOS only for automatic cookie extraction
Requires Chrome with active Facebook session
Facebook ToS automating Facebook violates their Terms of Service
Fragile —
doc_idvalues change on Facebook deploysRate limited aggressive use may trigger CAPTCHAs or account flags
No write operations — search/read only, no messaging or listing creation
Available Tools
7 toolscheck_monitorsB
Check saved monitors for new listings since last check
Inputs: monitor_name.
delete_monitorB
Delete a saved search monitor
Inputs: name (required).
get_listingB
Get full details for a specific Facebook Marketplace listing
Inputs: listing_id (required).
list_monitorsB
List all saved search monitors
Inputs: no named parameters.
monitor_searchB
Save a search query as a monitor to track new listings over time
Inputs: name (required), query (required), latitude (required), longitude (required), +4 more.
search_listingsC
Search Facebook Marketplace listings by query, location, and filters
Inputs: query (required), latitude (required), longitude (required), limit, +4 more.
search_locationA
Look up a city/town name to get coordinates for use with search_listings
Inputs: query (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool maps to a distinct resource/action: search_listings finds listings, get_listing fetches one, search_location resolves coordinates, and the monitor tools form a clean lifecycle. list_monitors vs check_monitors and monitor_search vs search_listings are clearly differentiated by their descriptions.
Most names follow a clean verb_noun pattern (list_monitors, search_listings, get_listing, check_monitors, delete_monitor). The one deviation is monitor_search, which inverts the pattern (should be something like create_monitor), but the meaning is still readable.
Seven tools is well-scoped for a Marketplace search-and-monitor server, with each tool earning its place across search, retrieval, location lookup, and monitor management.
The surface covers the full monitor lifecycle (create/list/check/delete) plus listing search and retrieval, which is comprehensive. The only minor gap is no way to update/edit an existing monitor's query or filters, requiring delete-and-recreate workarounds.
Maintenance
Related MCP Connectors
Search Facebook Marketplace, inspect listings and analyze deals. Paid Spottable Pro/Max required.
Facebook & Instagram data for AI agents: pages, posts, groups, ads, Marketplace, profiles, reels.
Search and browse global classifieds across 80 markets. No auth required for read-only access.
Shopify and eBay product scraper & extractor for fast market research. Pulls Shopify products.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI agents like claude.ai to search online marketplaces (e.g., Facebook Marketplace) through your own logged-in browser, returning structured listings and details.-
- FlicenseAqualityCmaintenanceEnables searching Facebook Marketplace listings from Claude using your existing Facebook session without a browser.72-
- AlicenseAqualityDmaintenanceA focused Model Context Protocol server that enables AI agents to search Facebook Marketplace and retrieve listing details using public GraphQL endpoints, without browser automation or login.34MIT
- AlicenseNot gradedqualityCmaintenanceEnables searching and browsing Facebook Marketplace listings, retrieving item details, nearby items, categories, and parsing listing URLs through MCP tools.1MIT