About Vinted
Vinted is a read-only MCP server for anonymous searches of second-hand listings on Vinted. It supports keyword and EUR price filters, sorting and pagination, and returns listing and seller details.
Key features
- 01Search Vinted listings anonymously
- 02Filter by EUR price range
- 03Sort by relevance, price or recency
- 04Browse results with pagination
- 05Return listing and seller details
Use cases
- 01Check current asking prices for second-hand items
- 02Filter a product search to a budget
- 03Compare listings by brand, size and condition
- 04Search listings on another Vinted country site
MCP support
It exposes a search tool to MCP clients that returns Vinted listings with details such as price, brand, size, condition and link.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
1Saved tool list · updated 1w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| page | integer | No | |
| sort | string | No | |
| query | string | Yes | |
| per_page | integer | No | |
| price_max | any | No | |
| price_min | any | No |
Details
From the project READMEvinted-mcp
MCP server for searching second-hand listings on Vinted, so Claude (or any MCP client) can answer "what does a used X go for?".
Anonymous and read-only. No login, no account, no writes: it only searches. Not affiliated with Vinted.
Tool
search
Search listings, with optional filters. Returns the total number of matches and the listings for one page.
Parameters:
query— search keywords (e.g."nike air max 90","vestido zara")price_min/price_max— price range in EURsort—"relevance"(default) |"cheap"|"expensive"|"newest"page— page number (default 1)per_page— results per page (default 24, max 96)
Each listing has: title, price, price with Vinted's buyer protection fee (shipping is extra), brand, size, condition, link, photo, whether the seller is a business, and favourites.
Tip: "cheap" also pulls in loosely related listings. For "the cheapest X", use the default relevance sort with price_max.
Install
Quickest (needs uv): no clone needed, it runs straight from PyPI.
claude mcp add vinted -- uvx vinted-search-mcp
For Claude Desktop, use "command": "uvx", "args": ["vinted-search-mcp"].
From source:
Requires Python 3.10+.
git clone https://github.com/ThiagoJacobLannes/vinted-mcp
cd vinted-mcp
python -m pip install -e .
On Windows, if you keep code in a cloud-synced folder (Google Drive, OneDrive), create the virtual environment outside it: sync clients drop desktop.ini files into folders, which can crash packages on startup.
Add to Claude Code
claude mcp add vinted -- python -m vinted_mcp.server
Add to Claude Desktop
Merge claude_desktop_config.snippet.json into your Claude Desktop claude_desktop_config.json, then restart Claude Desktop:
{
"mcpServers": {
"vinted": {
"command": "python",
"args": ["-m", "vinted_mcp.server"]
}
}
}
Other countries
Portugal is the default. Set VINTED_BASE_URL to another Vinted domain (for example https://www.vinted.fr or https://www.vinted.es) to search there.
How it works
Vinted has no official API. The server loads Vinted's public catalog page for your search and reads the results the page already contains (they arrive as React Server Component data). If Vinted changes its page, the tool fails with a clear {"error": ...} instead of returning wrong data.
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.