Vinted MCP Server on npm: Setup in Under 5 Minutes

You want to connect your AI to live Vinted marketplace data. You don't want to spend hours configuring tools, managing APIs, or writing scrapers. Good news: the Vinted MCP Server on npm gets you from zero to live Vinted data in under 5 minutes.

Here's the complete guide.

Prerequisites

• Node.js 18+ installed (download)
• One of these AI clients: Claude Desktop, Cursor IDE, or any MCP-compatible client
• 5 minutes of your time

That's it. No API keys. No accounts to create. No proxies to configure.

Minute 1: Install

Open your terminal:

npm install -g vinted-mcp-server

This installs the package globally. You can verify:

npx vinted-mcp-server --help

Alternatively, skip the global install — npx will download it on-demand when your AI client starts.

Package: npmjs.com/package/vinted-mcp-server
Source: GitHub

Minute 2: Configure Claude Desktop

Find your config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Add this:

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

Country Codes

Change VINTED_COUNTRY to your target market:

Code	Country
fr	France
de	Germany
nl	Netherlands
es	Spain
it	Italy
be	Belgium
pl	Poland
lt	Lithuania
cz	Czech Republic
pt	Portugal
at	Austria
lu	Luxembourg

Minute 3: Configure Cursor IDE (Alternative)

If you prefer Cursor:

1. Open Settings → MCP Servers
2. Click "Add New"
3. Paste the same config:

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

Both clients work identically with MCP.

Minute 4: Restart and Verify

Restart your AI client. You should see "vinted" listed as an available tool/MCP server.

In Claude Desktop, look for the hammer 🔨 icon — it should show Vinted tools.

In Cursor, check the MCP panel — the vinted server should show a green status.

Minute 5: Your First Query

Type in your AI client:

Search Vinted for "Nike Air Max" under €50

You should see real, live listings from Vinted with:

• Titles
• Prices
• Conditions
• Sizes
• URLs (clickable links to buy)

That's it. You're set up.

What You Can Do Now

Search Listings

"Find vintage Levi's jackets in size L"
"Search for PS5 games under €15"
"What MacBook Pros are available on Vinted Germany?"

Analyze Prices

"What's the average price for a Patagonia fleece on Vinted?"
"Compare Nike Dunk prices between France and Germany"

Find Deals

"Which listings are priced below average for Nike Air Force 1?"
"Find new-with-tags designer items under €30"

Research Markets

"How many listings are there for vintage watches on Vinted France?"
"What are the most popular brands in men's streetwear?"

Configuration Options

Multiple Countries

Run multiple instances for cross-market analysis:

{
  "mcpServers": {
    "vinted-fr": {
      "command": "npx",
      "args": ["-y", "vinted-mcp-server"],
      "env": { "VINTED_COUNTRY": "fr" }
    },
    "vinted-de": {
      "command": "npx",
      "args": ["-y", "vinted-mcp-server"],
      "env": { "VINTED_COUNTRY": "de" }
    },
    "vinted-nl": {
      "command": "npx",
      "args": ["-y", "vinted-mcp-server"],
      "env": { "VINTED_COUNTRY": "nl" }
    }
  }
}

Now ask: "Compare prices for X across France, Germany, and Netherlands."

Environment Variables

Variable	Description	Default
VINTED_COUNTRY	Default Vinted country	fr

Troubleshooting

"Server not found" in Claude Desktop

• Make sure you restarted Claude Desktop after editing config
• Check JSON syntax — use a validator if unsure
• Verify Node.js is installed: node --version

"Command not found: npx"

• Install Node.js 18+ from nodejs.org
• Make sure npm/npx is in your PATH

Slow first query

• Normal. First run downloads the package via npx (~5 seconds)
• Subsequent queries are fast (<2 seconds)

No results returned

• Check your country code — make sure it's a valid Vinted market
• Try a broader search query
• Verify internet connection

Upgrading

When new versions release:

npm update -g vinted-mcp-server

Or if using npx, it automatically uses the latest version.

Alternative: Apify Hosted Version

Don't want to install anything locally? Use the Apify Vinted MCP Server — zero setup, runs in the cloud.

For bulk data collection, the Vinted Smart Scraper is your best option.

Explore more tools: Apify Store

What People Build With It

• Price trackers: Monitor specific items and get alerts when prices drop
• Reselling tools: Find underpriced items automatically
• Market dashboards: Track brand performance in the second-hand market
• Shopping assistants: Natural language Vinted search for end users
• Research tools: Academic and business analysis of second-hand markets

FAQ

Is vinted-mcp-server free?

Yes. Completely open source, MIT licensed. Free on npm, free on GitHub.

Does it work on Windows?

Yes. Works on macOS, Windows, and Linux — anywhere Node.js runs.

Do I need a Vinted account?

No. The server accesses publicly available listing data.

Can I use it in my own app?

Yes. Import the package and use it programmatically, or connect via the MCP protocol.

How often is it updated?

Check the GitHub repo for release history. The maintainers actively update it.

You're Ready

5 minutes. That's all it took. You now have an AI-powered Vinted assistant that can search, analyze, and research the entire marketplace.

👉 npm package
👉 GitHub source
👉 Apify hosted version
👉 Vinted Smart Scraper

Now go find some deals. 🔍