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