Vinted MCP Server: Search Vinted With Claude AI in 2026
Last updated: February 15, 2026 | Reading time: 13 min
What if you could type "find me Nike Air Max 90 under €40 in size 43 across France and Germany" — and get a structured table of matching Vinted listings back in seconds? No scripts. No API calls. No browser tabs. Just a conversation with your AI assistant.
That's exactly what the Vinted MCP Server enables. It bridges Vinted's marketplace data with Claude, Cursor, Windsurf, and any AI tool that supports the Model Context Protocol (MCP). You ask questions in plain English, and the server translates them into Vinted searches, returning real-time marketplace data directly in your AI conversation.
According to Anthropic's MCP ecosystem report, over 3,000 MCP servers have been published since the protocol launched in late 2024. The Vinted MCP Server is the only MCP server worldwide that connects AI tools directly to Vinted marketplace data — giving you a first-mover advantage in AI-powered reselling.
In this guide, you'll learn:
- What the Vinted MCP Server does and how it works
- How to install and configure it with Claude Desktop
- Real queries you can run for market research and deal-finding
- How it compares to manual search and API-based scraping
Table of Contents
- What Is the Vinted MCP Server?
- How MCP Connects AI to Vinted
- Installation Guide
- Real Queries and Use Cases
- Advanced: Multi-Market Research
- MCP Server vs Smart Scraper: When to Use Which
- FAQ
What Is the Vinted MCP Server? {#what-is-it}
The Vinted MCP Server is an open-source tool that gives AI assistants like Claude the ability to search Vinted's marketplace in real time. Built on the Model Context Protocol (MCP), it acts as a bridge between natural language AI interfaces and Vinted's search infrastructure.
Instead of writing code or navigating Vinted's website, you type what you want in English (or any language your AI supports), and the MCP server handles:
- Translating your query into Vinted search parameters
- Executing the search across specified country domains
- Returning structured results (title, price, brand, size, condition, URL)
- Enabling follow-up analysis in the same conversation
It's available as an npm package (vinted-mcp-server) and on GitHub. Both are free and open-source.
Who it's for:
- Resellers who want quick market checks without leaving their AI workflow
- Developers integrating Vinted data into AI-powered applications
- Researchers who need ad-hoc marketplace queries without building custom scrapers
- Anyone who prefers conversational interfaces over web browsing
How MCP Connects AI to Vinted {#how-mcp-works}
The Model Context Protocol (MCP) is a standard created by Anthropic that lets AI models interact with external data sources through defined "tools." When you install an MCP server, your AI gains new capabilities — in this case, the ability to search Vinted.
Here's the flow:
You (natural language) → Claude → MCP Server → Vinted Search → Results → Claude → Analysis
- You type a query: "Find Adidas Samba under €30 in Germany"
- Claude recognizes this as a Vinted search request
- Claude calls the MCP server's
search_vintedtool with parsed parameters - The MCP server queries Vinted and returns JSON results
- Claude formats the results as a readable table
- You ask follow-up questions: "Which of these have the best seller ratings?"
The entire interaction happens within your Claude conversation. No tab-switching, no copy-pasting, no manual data wrangling.
This is fundamentally different from traditional scraping. The Vinted Smart Scraper is built for batch extraction — thousands of listings at once, scheduled runs, data pipelines. The MCP server is built for interactive queries — quick questions, ad-hoc research, conversational analysis.
Installation Guide {#installation}
Prerequisites
- Node.js 18+ installed on your machine
- Claude Desktop (or another MCP-compatible AI tool)
Step 1: Install the Package
npm install -g vinted-mcp-server
That's it. One command. The server is installed globally and ready to configure.
Step 2: Configure Claude Desktop
Open Claude Desktop's settings and navigate to the MCP configuration file. Add the Vinted MCP Server:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"vinted": {
"command": "npx",
"args": ["vinted-mcp-server"]
}
}
}
Step 3: Restart Claude Desktop
Close and reopen Claude Desktop. You should see the Vinted tools available in Claude's tool menu (the hammer icon).
Step 4: Test It
Type in Claude:
"Search for Nike sneakers under €50 on Vinted France"
Claude should call the Vinted MCP Server and return matching listings. If you see results, the setup is complete.
Alternative: Use With Cursor IDE
For developers using Cursor, add the MCP server to your Cursor configuration:
{
"mcp": {
"servers": {
"vinted": {
"command": "npx",
"args": ["vinted-mcp-server"]
}
}
}
}
Now you can query Vinted data while coding — useful for building price comparison tools, testing scraping logic, or analyzing market data inline.
🎯 Install the Vinted MCP Server in under 5 minutes. Available on npm and GitHub. Free and open-source.
Real Queries and Use Cases {#queries}
Basic Search
You: "Find me Levi's 501 jeans in size 32/32, good condition, on Vinted Germany, under €25"
Claude returns:
| Title | Price | Condition | Seller Rating | URL |
|---|---|---|---|---|
| Levi's 501 Original Fit 32/32 | €18 | Very Good | 4.8 ⭐ | vinted.de/items/... |
| Levi's 501 dunkelblau W32 L32 | €22 | Good | 4.6 ⭐ | vinted.de/items/... |
| 501 Levi's Jeans 32x32 wie neu | €15 | Very Good | 4.9 ⭐ | vinted.de/items/... |
Price Comparison Across Countries
You: "Compare the average price of Nike Dunk Low in size 42 across France, Germany, Poland, and Italy"
Claude returns: A comparison table with average prices, listing counts, and price ranges per country — the same data that powers our cross-border arbitrage analysis.
Market Research
You: "What are the 5 most listed sneaker brands on Vinted France right now? Show average price for each."
Claude returns: Brand rankings with listing volumes and average prices. This is the kind of category analysis that would take hours manually.
Seller Vetting
You: "Find Gucci belts under €50 on Vinted Italy. Only show listings from sellers with 4.8+ rating and 50+ reviews."
Claude returns: Filtered results from trusted sellers — combining the price search with seller profile trust scoring.
Trend Detection
You: "Search for 'vintage Versace' on Vinted France and Vinted Italy. Which market has more listings and lower prices?"
Claude returns: Side-by-side market comparison with insights about supply-demand dynamics.
Arbitrage Identification
You: "Find Nike Air Force 1 listings priced under €25 on Vinted Poland. Then show me the average selling price for the same model on Vinted France."
Claude returns: Source market deals alongside destination market pricing — instant arbitrage calculation.
Advanced: Multi-Market Research {#advanced}
Batch Queries for Weekly Reports
Ask Claude to generate a complete market report:
You: "I'm tracking 5 products across 4 countries for my weekly Vinted reselling report. For each, find the average price and cheapest listing:
Products: Nike Air Force 1 (42), Adidas Samba (43), New Balance 550 (44), Nike Dunk Low (42), Converse Chuck 70 (43)
Countries: France, Germany, Poland, Italy"
Claude queries the MCP server multiple times and compiles a structured report — a 20-item comparison matrix that would take hours of manual research.
Integration With Scraper Data
The MCP server is perfect for ad-hoc follow-up queries after batch scraping. For example:
- Run the Vinted Smart Scraper weekly to collect 10,000 listings
- Analyze the data in Google Sheets
- When you spot an interesting pattern in your spreadsheet, ask Claude via MCP: "Search for [specific item] on Vinted [country] — is this price anomaly real or an outlier?"
The scraper handles bulk data; the MCP server handles interactive exploration.
Building AI Agents
Developers can chain the Vinted MCP Server with other MCP servers to build autonomous AI agents:
Vinted MCP (search data) + Calculator MCP (margin math) + Sheets MCP (log deals) + Slack MCP (alert team)
An agent could: search for underpriced items → calculate margins → log profitable finds → notify your team — all in a single Claude conversation.
MCP Server vs Smart Scraper: When to Use Which {#comparison}
| Feature | Vinted MCP Server | Vinted Smart Scraper |
|---|---|---|
| Best for | Interactive research, ad-hoc queries | Bulk extraction, data pipelines |
| Interface | Natural language (AI conversation) | Web UI or API |
| Volume per query | 10-50 results | Up to 50,000 results |
| Scheduling | Not designed for it | Built-in cron scheduling |
| Cross-country | One country per query | Multiple countries per run |
| Cost | Free (open-source) | Apify compute costs (~$0.007/run) |
| Export formats | Within AI conversation | JSON, CSV, Excel, Google Sheets |
| Setup time | 5 minutes (npm install) | 3 minutes (Apify account) |
| Code required | None | None |
Use the MCP Server when: You want quick answers, are doing exploratory research, or prefer conversational interfaces.
Use the Smart Scraper when: You need thousands of listings, scheduled data pipelines, or structured exports for analysis.
Use both together: Scraper for daily data collection → MCP server for ad-hoc investigation of patterns you discover.
FAQ {#faq}
What is the Vinted MCP Server?
The Vinted MCP Server is an open-source tool that lets AI assistants (Claude, Cursor, Windsurf) search Vinted's marketplace in real time. You ask questions in natural language and get structured listing data back. It uses the Model Context Protocol (MCP) standard created by Anthropic. Available free on npm and GitHub.
How do I install the Vinted MCP Server?
Run npm install -g vinted-mcp-server, then add the server configuration to your Claude Desktop config file. Restart Claude Desktop. The entire process takes under 5 minutes. Detailed setup instructions are on the GitHub page.
Does the Vinted MCP Server cost anything?
No. The MCP server is free and open-source. It runs locally on your machine. The only cost is if you choose to use the Apify-hosted version, which runs on Apify's infrastructure with the standard free tier ($5/month).
Can I use the MCP Server with Cursor or other AI tools?
Yes. Any AI tool that supports MCP can use the Vinted MCP Server. This includes Claude Desktop, Cursor IDE, Windsurf, and other MCP-compatible interfaces. Configuration varies by tool but follows the same pattern: point to the vinted-mcp-server npm package.
How many results does the MCP Server return per query?
The MCP server is designed for interactive use, typically returning 10-50 results per query. For bulk extraction (hundreds or thousands of listings), use the Vinted Smart Scraper instead. The two tools complement each other.
Can I search multiple Vinted countries with the MCP Server?
Yes. Specify the country in your query: "Search Vinted France for...", "Search Vinted Poland for...". For cross-country comparison, ask Claude to run multiple queries and compare results. The MCP server supports all 19 Vinted country domains.
Is the Vinted MCP Server the only one for Vinted?
As of February 2026, yes. The Vinted MCP Server is the only MCP server worldwide that provides direct access to Vinted marketplace data. This gives early adopters an advantage in AI-powered market research and reselling.
How does this compare to scraping Vinted manually?
The MCP server eliminates the need to open Vinted in a browser, apply filters manually, and copy-paste data. Instead, you describe what you want in natural language and get structured results instantly. For detailed comparison, see our Vinted scraping guide.
Can I build applications on top of the MCP Server?
Yes. The MCP server exposes Vinted search as tools that any MCP client can call programmatically. Developers can build AI agents, chatbots, or automated workflows that query Vinted data as part of larger systems. See the GitHub repository for the API documentation. For mobile market intelligence, pair it with the App Store Scraper.
Start Searching Vinted With AI Today
Manual Vinted browsing is a 2024 workflow. In 2026, you ask your AI assistant to find deals, compare prices, and analyze markets — in seconds, from a single conversation.
Install Vinted MCP Server → npm install -g vinted-mcp-server
Source code and docs: GitHub | Hosted version: Apify
For bulk data extraction, use the Vinted Smart Scraper alongside the MCP server.
Related reading:
Top comments (0)