vinted-mcp-server

🛍️ 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.

⚡ 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):

{
  "mcpServers": {
    "vinted": {
      "command": "npx",
      "args": ["-y", "vinted-mcp-server"]
    }
  }
}

Cursor

Settings → MCP Servers → Add:

{
  "mcpServers": {
    "vinted": {
      "command": "npx",
      "args": ["-y", "vinted-mcp-server"]
    }
  }
}

🛠️ 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