The first MCP server for the Vinted marketplace. Give your AI assistant the power to search 800M+ listings, compare prices across 19 countries, and analyze seller profiles โ all through the Model Context Protocol.
Works with Claude Desktop, Cursor, Windsurf, Cline, and any MCP-compatible client.
{
"mcpServers": {
"vinted": {
"command": "npx",
"args": ["-y", "vinted-mcp-server"]
}
}
}npm install -g vinted-mcp-serverThen add to your MCP client config:
{
"mcpServers": {
"vinted": {
"command": "vinted-mcp-server"
}
}
}Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"vinted": {
"command": "npx",
"args": ["-y", "vinted-mcp-server"]
}
}
}Settings โ MCP Servers โ Add:
{
"mcpServers": {
"vinted": {
"command": "npx",
"args": ["-y", "vinted-mcp-server"]
}
}
}Search Vinted listings with powerful filters.
| Parameter | Type | Description |
|---|---|---|
query | string | Search keywords (required) |
country | string | Country code โ fr, de, uk, it, es, nl, pl, pt, be, at, lt, cz, sk, hu, ro, hr, fi, dk, se
|
priceMin | number | Minimum price |
priceMax | number | Maximum price |
brandIds | number[] | Filter by brand IDs |
categoryId | number | Vinted category ID |
condition | string[] |
new_with_tags, new_without_tags, very_good, good, satisfactory
|
sortBy | string |
relevance, price_low_to_high, price_high_to_low, newest_first
|
limit | number | Max results (up to 100) |
Example prompt: "Search for Nike Air Max on Vinted France under 50โฌ, sort by price"
Get full details for a specific Vinted item by ID.
| Parameter | Type | Description |
|---|---|---|
itemId | number | Vinted item ID (required) |
country | string | Country code |
Example prompt: "Get details for Vinted item 4283719503"
Analyze a Vinted seller's profile, ratings, and recent items.
| Parameter | Type | Description |
|---|---|---|
sellerId | number | Vinted seller ID (required) |
country | string | Country code |
Example prompt: "Show me the profile of seller 12345678 on Vinted Germany"
Compare prices for an item across multiple Vinted countries.
| Parameter | Type | Description |
|---|---|---|
query | string | Search keywords (required) |
countries | string[] | Countries to compare (default: all) |
limit | number | Items per country |
Example prompt: "Compare prices for 'Levi's 501' across France, Germany, and Italy"
Discover trending items on Vinted.
| Parameter | Type | Description |
|---|---|---|
country | string | Country code |
categoryId | number | Optional category filter |
limit | number | Number of trending items |
Example prompt: "What's trending on Vinted Netherlands right now?"
Returns the full list of 19 supported Vinted countries with domain, currency, and language info.
Returns the Vinted category tree for filtering searches.
| Code | Country | Currency |
|---|---|---|
fr | France | EUR |
de | Germany | EUR |
uk | United Kingdom | GBP |
it | Italy | EUR |
es | Spain | EUR |
nl | Netherlands | EUR |
be | Belgium | EUR |
at | Austria | EUR |
pl | Poland | PLN |
pt | Portugal | EUR |
lt | Lithuania | EUR |
cz | Czech Republic | CZK |
sk | Slovakia | EUR |
hu | Hungary | HUF |
ro | Romania | RON |
hr | Croatia | EUR |
fi | Finland | EUR |
dk | Denmark | DKK |
se | Sweden | SEK |
- ๐ AI Shopping Assistant โ "Find me a winter jacket under 30โฌ in good condition"
- ๐ Price Analysis โ "What's the average price for PS5 controllers across Europe?"
- ๐ฐ Arbitrage โ "Find items priced lower in Poland that I can buy from France"
- ๐ค Seller Research โ "Is this seller trustworthy? Show me their ratings and history"
- ๐ Trend Watching โ "What's trending in fashion on Vinted Germany?"
Looking for programmatic scraping at scale? Check out the Vinted Smart Scraper on Apify โ same engine, cloud-scale.
MIT ยฉ KazKN