How to Use Vinted Data in Claude, Cursor, and Any AI Tool (MCP Server Guide)
Last updated: February 2026 | Reading time: 15 min
18 browser tabs. That's what my screen looked like every time I tried to compare Vinted prices across countries. One tab per country, switching back and forth, copy-pasting prices into a spreadsheet. After an hour, I had data for maybe 3 products across 6 countries. I knew the price gaps were there — our scraping data proved it — but finding them manually was soul-crushing.
Then I thought: what if I could just ask Claude to do this? "Compare PS5 prices across Germany, Netherlands, and France." One sentence, instant results. That's the moment I decided to build the Vinted MCP Server — the world's first and only MCP server for second-hand marketplace data.
Ever wished you could talk to Vinted like you talk to a colleague? Ask questions in plain English and get real answers backed by real listings? If you nodded, keep reading.
What you'll learn in this guide:
- What MCP (Model Context Protocol) is and why it's a game-changer for marketplace data
- How to install and configure the Vinted MCP Server in under 5 minutes —
npm installand you're done - All 5 tools available with real conversation examples from Claude
- A cross-country arbitrage strategy backed by data from 960+ listings
Table of Contents
- What Is MCP (Model Context Protocol)?
- Why Connect Vinted to AI Tools?
- The Vinted MCP Server — World's First and Only
- 5 Tools Available in the Vinted MCP Server
- Setup Guide: Install in Under 5 Minutes
- Real Conversations with Claude Using Vinted MCP
- Cross-Country Arbitrage: Real Price Data
- Comparison: MCP vs Manual Browsing vs V-Tools
- Pricing: Transparent Breakdown
- FAQ
- Get Started Now
What Is MCP (Model Context Protocol)?
Model Context Protocol (MCP) is an open standard developed by Anthropic that allows AI assistants like Claude, Cursor, and Windsurf to connect directly to external data sources and tools. Think of MCP as a USB port for AI — it provides a standardized way for language models to read data from APIs, databases, and services without custom integration code.
According to the Anthropic MCP documentation, MCP follows a client-server architecture where AI applications (clients) connect to specialized servers that expose specific capabilities. As of early 2026, MCP has been adopted by 30+ AI tools including Claude Desktop, Cursor, Windsurf, Cline, and Continue.
Before MCP, connecting an AI tool to an external service meant writing custom API wrappers, managing authentication, and handling data formatting. MCP eliminates that friction entirely. You install a server, point your AI client at it, and start asking questions in natural language.
Why Connect Vinted to AI Tools?
Vinted operates across 19 European countries, each with its own domain, listings, and pricing. A PS5 listed at €153 in Germany might sell for €224 in the Netherlands. An iPhone 15 at €420 in Spain goes for €1,100 in the Netherlands. These price gaps exist because most sellers only see their local market — and most buyers never think to check across borders.
The problem? Finding these opportunities manually means:
- Opening 18-19 different Vinted country sites
- Searching the same query on each one
- Converting currencies and comparing results
- Repeating this process for every product category
- Doing it again tomorrow because prices change daily
With a Vinted MCP server connected to Claude or Cursor, that entire workflow collapses into a single sentence: "Find me the cheapest PS5 listings across all European Vinted markets and compare them."
According to Vinted's 2024 annual report, the platform processes over 900 million items listed with 65+ million active users across Europe. That's a massive dataset that becomes genuinely useful only when you can query it intelligently — which is exactly what MCP enables.
💡 Why this matters for resellers: V-Tools charges €80/month for basic Vinted automation — a browser extension with a 3.4/5 Trustpilot rating, weekend support delays, and DGCCRF complaints. The Vinted MCP Server is free and open source, gives you AI-powered analysis, and covers all 19 countries. Not a fair fight.
The Vinted MCP Server — World's First and Only
The Vinted MCP Server is the only MCP server in the world built specifically for second-hand marketplace data. It's available as an npm package (187 downloads/week) and as an Apify Actor for cloud-based usage.
This server wraps Vinted's marketplace data into 5 structured tools that any MCP-compatible AI client can call. No API key from Vinted is needed — the server handles data retrieval through Apify's infrastructure, which means reliable access without rate limiting concerns.
The source code is fully open on GitHub under MIT license. Inspect it, fork it, contribute — it's yours.
For the backstory on why this was built and the arbitrage opportunities discovered during development, read the original deep-dive article.
5 Tools Available in the Vinted MCP Server
The Vinted MCP server exposes five tools, each designed for a specific marketplace query pattern:
1. search_items — Find Listings Fast
Search Vinted listings across any supported country with filters for price, size, condition, brand, and more.
{
"tool": "search_items",
"parameters": {
"query": "Nike Air Max 90",
"country": "de",
"priceFrom": 20,
"priceTo": 80,
"order": "price_low_to_high"
}
}
Returns structured listing data: title, price, condition, seller rating, photos, and direct links.
2. compare_prices — The Killer Feature
Compare prices for the same item across multiple Vinted country domains simultaneously. This is what makes cross-border arbitrage possible at scale.
{
"tool": "compare_prices",
"parameters": {
"query": "PlayStation 5",
"countries": ["de", "nl", "fr", "es", "it", "be"]
}
}
Returns a price comparison matrix showing minimum, maximum, and average prices per country — the foundation of every arbitrage deal.
3. get_trending — Spot Demand
Discover trending items in a specific country. Useful for identifying high-demand products where price premiums exist.
{
"tool": "get_trending",
"parameters": {
"country": "fr",
"category": "electronics"
}
}
4. get_seller — Vet Before You Buy
Pull detailed seller profiles including rating, number of sales, active listings, and response time. Essential for vetting sellers before purchasing.
{
"tool": "get_seller",
"parameters": {
"sellerId": "12345678",
"country": "de"
}
}
5. get_item — Full Listing Details
Get full details on a specific listing including all photos, description, measurements, condition notes, and shipping options.
{
"tool": "get_item",
"parameters": {
"itemId": "987654321",
"country": "es"
}
}
One honest note: get_item can be flaky for some listing URLs due to Vinted's dynamic page rendering. It works reliably for ~90% of listings. For bulk data extraction where you need 100% reliability, use the Vinted Smart Scraper instead — it's built specifically for high-volume, reliable data collection. Read our full scraper guide here.
Setup Guide: Install in Under 5 Minutes
Prerequisites
- Node.js 18 or higher
- Claude Desktop, Cursor, or any MCP-compatible AI client
- Apify API token (free tier available at apify.com)
Step 1: Install the Package
npm install -g vinted-mcp-server
That's it. One command. The package is available on npm with 187 downloads/week and growing.
Step 2: Get Your Apify API Token
- Create a free account at apify.com — 30 seconds, no credit card
- Navigate to Settings → Integrations → API Tokens
- Copy your Personal API Token
You get $5 free monthly credits — enough for hundreds of Vinted searches. Free to try. Pay per result. No subscription.
Step 3: Configure Claude Desktop
Open your Claude Desktop configuration file:
-
macOS:
~/Library/Application Support/Claude/claude_desktop_config.json -
Windows:
%APPDATA%\Claude\claude_desktop_config.json
Add the Vinted MCP server configuration:
{
"mcpServers": {
"vinted": {
"command": "npx",
"args": ["-y", "vinted-mcp-server"],
"env": {
"APIFY_API_TOKEN": "your_apify_token_here"
}
}
}
}
Step 4: Restart Claude Desktop
Close and reopen Claude Desktop. You should see a hammer icon (🔨) indicating the MCP server is connected. Click it to verify the 5 Vinted tools are available.
Step 5: Start Querying
Type a natural language query like:
"Search for Dyson V15 vacuum cleaners under €100 on Vinted Germany and compare prices with France and Italy."
Claude will automatically call the appropriate MCP tools and return structured results. No code. No manual browsing. Just conversation.
Cursor & Other Editors
For Cursor IDE, add the same config to your Cursor MCP settings. This also works with Windsurf, Cline, Continue, and any other tool implementing the MCP standard.
🎯 Ready to try? Install the Vinted MCP Server right now — or keep reading for real conversation examples and arbitrage strategies.
Real Conversations with Claude Using Vinted MCP
Here are actual conversation examples showing the Vinted MCP server in action with Claude:
Example 1: Quick Price Check
You: "What's the cheapest iPhone 15 Pro on Vinted right now in Spain?"
Claude: Calls search_items with query "iPhone 15 Pro", country "es", order "price_low_to_high"
I found 47 iPhone 15 Pro listings on Vinted Spain. The cheapest is listed at €420 in "Very Good" condition from a seller with 4.8★ rating and 23 completed sales. Here are the top 5 cheapest listings...
Example 2: Cross-Border Arbitrage Scan
You: "Compare PS5 prices across Germany, Netherlands, France, Spain, Italy, and Belgium. Show me the biggest price gaps."
Claude: Calls compare_prices across 6 countries
Here's the PS5 price comparison across 6 Vinted markets:
Country Min Price Avg Price Listings 🇩🇪 Germany €153 €198 234 🇪🇸 Spain €170 €210 89 🇫🇷 France €185 €225 312 🇮🇹 Italy €190 €230 145 🇧🇪 Belgium €200 €245 67 🇳🇱 Netherlands €224 €268 178 Biggest gap: Germany → Netherlands = 46% spread (€153 vs €224). After Vinted's buyer protection (~5%) and shipping (~€15), you'd net approximately €45-50 per unit.
Example 3: Seller Vetting
You: "Check if seller #12345678 on Vinted Germany is trustworthy. What's their history?"
Claude: Calls get_seller then search_items for that seller's listings
This seller has been active for 3 years with 156 completed sales and a 4.9★ rating. Average response time is under 2 hours. They primarily sell electronics and have 12 active listings. No negative reviews in the last 6 months.
Example 4: AI-Powered Deal Hunting
Imagine asking Claude: "Find me Nike Air Force 1 under €30 in Italy, check the seller ratings, and compare with prices in France and Germany." Three tools chained together, results in seconds. That's the power of MCP — AI reasoning applied to real marketplace data.
Cross-Country Arbitrage: Real Price Data
This is where the Vinted MCP server becomes a genuine money-making tool. Cross-border price gaps on Vinted are consistent, significant, and largely unexploited because most users only browse their local market.
Based on our analysis of 960+ listings collected via the Vinted Smart Scraper:
PlayStation 5 (Disc Edition)
| Buy In | Price | Sell In | Price | Spread | Est. Profit |
|---|---|---|---|---|---|
| 🇩🇪 Germany | €153 | 🇳🇱 Netherlands | €224 | 46% | ~€45/unit |
| 🇩🇪 Germany | €153 | 🇧🇪 Belgium | €200 | 31% | ~€25/unit |
| 🇪🇸 Spain | €170 | 🇳🇱 Netherlands | €224 | 32% | ~€30/unit |
iPhone 15 (128GB)
| Buy In | Price | Sell In | Price | Spread | Est. Profit |
|---|---|---|---|---|---|
| 🇪🇸 Spain | €420 | 🇳🇱 Netherlands | €1,100 | 162% | ~€600/unit |
| 🇮🇹 Italy | €450 | 🇳🇱 Netherlands | €1,100 | 144% | ~€570/unit |
| 🇩🇪 Germany | €480 | 🇳🇱 Netherlands | €1,100 | 129% | ~€540/unit |
Dyson V15 Detect
| Buy In | Price | Sell In | Price | Spread |
|---|---|---|---|---|
| 🇮🇹 Italy | €45 | 🇧🇪 Belgium | €85 | 90% |
| 🇪🇸 Spain | €50 | 🇳🇱 Netherlands | €85 | 70% |
| 🇩🇪 Germany | €55 | 🇧🇪 Belgium | €85 | 55% |
Louis Vuitton Neverfull
| Buy In | Price | Sell In | Price | Spread |
|---|---|---|---|---|
| 🇪🇸 Spain | €180 | 🇳🇱 Netherlands | €290 | 61% |
| 🇮🇹 Italy | €195 | 🇳🇱 Netherlands | €290 | 49% |
| 🇩🇪 Germany | €200 | 🇳🇱 Netherlands | €290 | 45% |
⚠️ A word of caution: these spreads account for listing prices only. Factor in Vinted's buyer protection fee (~5%), shipping costs (€10-20 within Europe), and your time. Net margins still range from 25% to over 100% on many items — but do your own math for each deal. This arbitrage opportunity shrinks as more resellers discover it.
For bulk data collection and historical price tracking beyond real-time MCP queries, use the Vinted Smart Scraper. And for similar marketplace intelligence techniques applied to app markets, check out our App Store Scraper guide.
Comparison: MCP vs Manual Browsing vs V-Tools
| Feature | Manual Browsing | V-Tools (€80/mo) | Vinted MCP Server |
|---|---|---|---|
| Price | Free (but your time) | €80/month | Free (Apify free tier) |
| Cross-country search | 1 country at a time | Multi-country (limited) | All 19 countries |
| AI integration | ❌ None | ❌ None | ✅ Claude, Cursor, any MCP client |
| Natural language queries | ❌ | ❌ | ✅ Ask in plain English |
| Price comparison | Manual spreadsheet | Basic | Automated with AI analysis |
| Seller analysis | Click through profiles | Limited | ✅ Full profile data |
| Trending items | Browse manually | ❌ | ✅ Built-in tool |
| Setup time | 0 min | 10 min | 5 min |
| Automation | None | Limited | Unlimited (MCP + scripting) |
| Data export | Copy/paste | CSV | Structured JSON |
| Trustpilot | N/A | 3.4/5 ⭐ | N/A (open source) |
| Open source | N/A | ❌ Closed | ✅ MIT License |
The MCP approach is uniquely powerful because it combines data access with AI reasoning. You don't just get raw data — you get analysis, insights, and recommendations from Claude's reasoning applied to real-time Vinted data.
Pricing: Transparent Breakdown
| What | Cost |
|---|---|
| Vinted MCP Server (npm package) | Free, open source |
| Apify free tier | $0/month ($5 credits = hundreds of queries) |
| Apify per query | ~$0.007 per MCP tool call |
| Apify Starter (heavy usage) | $49/month |
| V-Tools (competitor) | €80/month, closed source |
Free to try. Pay per result. No subscription required. No commitment. If the free tier covers your needs, you never pay a cent.
FAQ
What is an MCP server?
An MCP (Model Context Protocol) server is a lightweight service that exposes data and functionality to AI assistants through a standardized protocol developed by Anthropic. It acts as a bridge between AI tools like Claude or Cursor and external data sources. The Vinted MCP server specifically connects Vinted marketplace data to any MCP-compatible AI client, enabling natural language queries against real listing data.
Can I use the Vinted MCP Server with Cursor?
Yes. Cursor fully supports MCP servers. Add the same configuration block to your Cursor MCP settings, and you'll have access to all 5 Vinted tools directly within your AI chat. This also works with Windsurf, Cline, Continue, and any editor implementing the MCP standard.
Is the Vinted MCP Server free?
The server itself is free and open source — available via npm install vinted-mcp-server and on GitHub under MIT license. It runs on Apify's infrastructure, which offers a free tier ($5/month credits) sufficient for hundreds of Vinted searches. Heavy usage may require Apify's paid plans starting at $49/month — still less than V-Tools' €80/month.
Do I need a Vinted API key?
No. The Vinted MCP server does not require any Vinted API credentials. It uses Apify's web scraping infrastructure to retrieve listing data. You only need a free Apify API token, which takes 30 seconds to generate.
Is web scraping Vinted legal?
Web scraping publicly available data is generally legal in the EU under the GDPR framework, as confirmed by multiple court rulings including hiQ Labs v. LinkedIn. The Vinted MCP server only accesses publicly visible listing information — the same data any user sees when browsing the site. It does not access private accounts, bypass authentication, or collect personal data beyond what's publicly displayed.
How accurate is the pricing data?
The Vinted MCP server retrieves real-time listing data directly from Vinted's platform. Prices reflect current active listings at the time of query. For historical price analysis and large-scale data collection, use the Vinted Smart Scraper which can process thousands of listings for trend analysis. See our complete scraper guide for details.
What countries does the Vinted MCP Server support?
The server supports all 19 Vinted markets: France, Germany, Spain, Italy, Netherlands, Belgium, Luxembourg, Austria, Portugal, Czech Republic, Poland, Lithuania, Hungary, Romania, Denmark, Finland, Sweden, and the UK. Search any single market or compare prices across all of them simultaneously using the compare_prices tool.
Can I build automations on top of the MCP server?
Yes. Because MCP is a protocol, you can chain multiple tool calls together, build scheduled queries using Apify's scheduling features, or integrate with n8n/Make/Zapier workflows. Some users combine the MCP server with the Vinted Smart Scraper for a complete pipeline: MCP for real-time queries, scraper for bulk historical data.
How does this compare to building my own Vinted bot?
Building a custom Vinted bot requires handling TLS fingerprinting, residential proxies, anti-bot evasion, and ongoing maintenance every time Vinted updates their platform. The MCP server handles all of that through Apify's infrastructure. You get the same data access in a fraction of the time. For the technical details of what makes Vinted scraping hard, read our Vinted Scraper guide.
Get Started Now
The Vinted MCP server transforms how you interact with Europe's largest second-hand marketplace. Instead of manually browsing country by country, you ask Claude or Cursor a question and get instant, cross-border insights backed by real listing data.
Install it in one command:
npm install -g vinted-mcp-server
Configure it in your claude_desktop_config.json, and start finding price gaps that 99% of Vinted users never see.
Resources:
- 🤖 Vinted MCP Server on Apify — cloud-hosted version
- 📦 npm: vinted-mcp-server — 187 downloads/week
- 💻 GitHub: vinted-mcp-server — open source, MIT license
- 🔍 Vinted Smart Scraper — bulk data extraction
- 📱 App Store Scraper — similar techniques for app markets
- 📚 Apify Documentation — full API reference
- 📖 MCP Protocol Documentation — learn the standard
- 📖 Original article: Cross-border price gaps on Vinted
Built with data from the Vinted Smart Scraper — 960+ listings analyzed across 6 EU countries, February 2026.
Top comments (0)