
vinted-mcp-server
from Doriandarko
First MCP server for Vinted marketplace. Search millions of second-hand items, compare prices across 19 countries (FR, DE, ES, IT, NL, BE, UK...), analyze seller profiles with ratings and verification status, detect cross-country arbitrage opportunities, and track trending products. 5 tools: search_items, get_item, get_seller, compare_prices, get_trending. 2 resources: countries list, categories. Works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible client. Zero config โ just npx.
๐๏ธ Vinted MCP Server โ Search, Compare Prices & Analyze Sellers
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.
๐ ๏ธ Tools (5)
search_items
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_item
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"
get_seller
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
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"
get_trending
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?"
๐ Resources (2)
vinted://countries
Returns the full list of 19 supported Vinted countries with domain, currency, and language info.
vinted://categories
Returns the Vinted category tree for filtering searches.
๐ Supported Countries (19)
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
๐ก Use Cases
-
๐ 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?"
๐ Related
Looking for programmatic scraping at scale? Check out the Vinted Smart Scraper on Apify โ same engine, cloud-scale.
๐ License
MIT ยฉ KazKN
โก Quick Start
Option 1: npx (zero install)
{ "mcpServers": { "vinted": { "command": "npx", "args": ["-y", "vinted-mcp-server"] } } }
Option 2: Global install
npm install -g vinted-mcp-server
Then add to your MCP client config:
{ "mcpServers": { "vinted": { "command": "vinted-mcp-server" } } }
๐ง Client Configuration
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
Cursor
Settings โ MCP Servers โ Add:
No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.