Wallapop MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| WALLAPOP_EMAIL | No | Enable auth tools (favorites, saved searches, chat, offers). May fail for accounts with MFA or Keycloak flows. | |
| WALLAPOP_BROWSER | No | Browser fallback mode: auto (default), chrome, msedge, chromium, or off. | auto |
| WALLAPOP_PASSWORD | No | Password for the Wallapop account, used with WALLAPOP_EMAIL for authentication. | |
| WALLAPOP_RADIUS_KM | No | Your pickup radius in kilometers. make_offer refuses in-person-only listings outside this radius. | |
| WALLAPOP_PICKUP_LAT | No | Your pickup latitude. make_offer refuses in-person-only listings outside this radius. | |
| WALLAPOP_PICKUP_LNG | No | Your pickup longitude. make_offer refuses in-person-only listings outside this radius. | |
| WALLAPOP_DEFAULT_LAT | No | Default search latitude (Barcelona center). | 41.3874 |
| WALLAPOP_DEFAULT_LNG | No | Default search longitude (Barcelona center). | 2.1686 |
| WALLAPOP_DISTANCE_KM | No | Default search radius in kilometers. | |
| WALLAPOP_MAX_RESULTS | No | Search results cap, 1–200. | 200 |
| WALLAPOP_COOKIES_FILE | No | Optional JSON array of browser cookies ([{ name, value }]) exported from a logged-in session. The most reliable authenticated path. | |
| WALLAPOP_SESSION_FILE | No | Token/cookie persistence file path. | ./wallapop-session.json |
| WALLAPOP_RATE_DELAY_MS | No | Minimum delay between API calls in milliseconds. | 600 |
| WALLAPOP_PROTECTION_PCT | No | Wallapop protection fee percentage (≈8–10) used to report the real total of an offer. | 8 |
| WALLAPOP_SHIPPING_FEE_EUR | No | Wallapop shipping fee in EUR (≈3–5) used to report the real total of an offer. | 4 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| server_statusA | Returns whether the server is configured for public or authenticated use, whether a session is loaded, and whether browser fallback is available. |
| search_productsA | Search Wallapop for products with optional filters: category, price range, location (latitude/longitude), radius, sort order. Paginate with the nextPage cursor returned. Reserved listings are filtered out. Returns up to maxResults listings (default 40, capped at 200). |
| get_listingA | Get detailed information about a single Wallapop listing: description, condition, price, images, location, views, favorites, seller id, shipping options. Accepts the numeric listing id, a web slug, or a full item URL. Falls back to server-side rendering when the API fails. |
| get_sellerA | Get a Wallapop seller profile by numeric user id (from a listing) or by web slug (e.g. 'sergiof-462579195'): rating, review count, sold/published counts, registration date, location. |
| list_categoriesA | List all marketplace top-level categories with ids and subcategories. |
| scan_productsA | Runs several keyword searches (default nationwide radius) and dedupes results, keeping only in-range, shippable listings and flagging suspicious ones (scam wording or book-slug retitled listings). Returns compact candidate list, ready for get_listing/verify. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
Most tools are clearly distinct: search_products, get_listing, get_seller, list_categories, and server_status each target a different resource or action. The main ambiguity is between search_products and scan_products, though scan_products is clearly positioned as a specialized multi-keyword search with deduplication.
The naming pattern is largely consistent: search_products, get_listing, get_seller, list_categories, and scan_products all follow verb_noun naming. server_status breaks the pattern slightly by using a noun phrase instead of a get_ or status_ verb, but it is still readable and predictable.
Six tools is well-scoped for a marketplace browsing/searching MCP server. Each tool covers a meaningful capability without bloat, and the count feels appropriate for the server's purpose.
The core browsing flow is covered: search listings, get listing details, get seller profiles, and list categories. Minor gaps exist such as not being able to list a seller's active listings or perform authenticated actions, but those are not necessarily core to this server's stated scope.