# vinted-mcp

This MCP server lets an AI client search Vinted listings, inspect items and sellers, and compare prices across countries.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 25
- Author: andrijdavid
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/andrijdavid/vinted-mcp
- Updated: 2026-10-01
- HTML: https://affpapa.org/en/nevibecode/mcp/vinted-mcp

## What it does

vinted-mcp gives the agent Vinted search with filters for country, price range, brand, category, condition, sorting, and result count. It can retrieve item information, examine seller profiles, compare offers between countries, and surface popular listings. The server also exposes country and category resources.

It runs as a local `stdio` MCP process and can be launched with `npx`. Search and price checks work without signing in, while account-related actions need an authenticated Vinted session. Browser login requires Playwright with Chromium; headless setups can provide cookies and a CSRF token through environment variables. Keep those session values secret.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `VINTED_AUTH_MODE`, `VINTED_AUTH_COOKIES`, `VINTED_AUTH_CSRF_TOKEN`, `VINTED_AUTH_ACCESS_TOKEN`, `VINTED_PROXY_URL`, `VINTED_MAX_CONCURRENCY`, `VINTED_REQUEST_DELAY_MS`, `VINTED_MAX_RETRIES` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env VINTED_AUTH_MODE=<VINTED_AUTH_MODE> --env VINTED_AUTH_COOKIES=<VINTED_AUTH_COOKIES> --env VINTED_AUTH_CSRF_TOKEN=<VINTED_AUTH_CSRF_TOKEN> --env VINTED_AUTH_ACCESS_TOKEN=<VINTED_AUTH_ACCESS_TOKEN> --env VINTED_PROXY_URL=<VINTED_PROXY_URL> --transport stdio vinted-mcp -- npx -y @andrijdavid/vinted-mcp
```
Replace <…> with your own values. 3 more environment variables are in the server README

### Codex

**Platform CLI**
```bash
codex mcp add vinted-mcp --env VINTED_AUTH_MODE=<VINTED_AUTH_MODE> --env VINTED_AUTH_COOKIES=<VINTED_AUTH_COOKIES> --env VINTED_AUTH_CSRF_TOKEN=<VINTED_AUTH_CSRF_TOKEN> --env VINTED_AUTH_ACCESS_TOKEN=<VINTED_AUTH_ACCESS_TOKEN> --env VINTED_PROXY_URL=<VINTED_PROXY_URL> -- npx -y @andrijdavid/vinted-mcp
```
Replace <…> with your own values. 3 more environment variables are in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "vinted-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@andrijdavid/vinted-mcp"
            ],
            "env": {
                "VINTED_AUTH_MODE": "<VINTED_AUTH_MODE>",
                "VINTED_AUTH_COOKIES": "<VINTED_AUTH_COOKIES>",
                "VINTED_AUTH_CSRF_TOKEN": "<VINTED_AUTH_CSRF_TOKEN>",
                "VINTED_AUTH_ACCESS_TOKEN": "<VINTED_AUTH_ACCESS_TOKEN>",
                "VINTED_PROXY_URL": "<VINTED_PROXY_URL>"
            }
        }
    }
}
```
Replace <…> with your own values. 3 more environment variables are in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "vinted-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@andrijdavid/vinted-mcp"
            ],
            "env": {
                "VINTED_AUTH_MODE": "<VINTED_AUTH_MODE>",
                "VINTED_AUTH_COOKIES": "<VINTED_AUTH_COOKIES>",
                "VINTED_AUTH_CSRF_TOKEN": "<VINTED_AUTH_CSRF_TOKEN>",
                "VINTED_AUTH_ACCESS_TOKEN": "<VINTED_AUTH_ACCESS_TOKEN>",
                "VINTED_PROXY_URL": "<VINTED_PROXY_URL>"
            }
        }
    }
}
```
Replace <…> with your own values. 3 more environment variables are in the server README

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e VINTED_AUTH_MODE=<VINTED_AUTH_MODE> -e VINTED_AUTH_COOKIES=<VINTED_AUTH_COOKIES> -e VINTED_AUTH_CSRF_TOKEN=<VINTED_AUTH_CSRF_TOKEN> -e VINTED_AUTH_ACCESS_TOKEN=<VINTED_AUTH_ACCESS_TOKEN> -e VINTED_PROXY_URL=<VINTED_PROXY_URL> vinted-mcp npx -y @andrijdavid/vinted-mcp
```
Replace <…> with your own values. 3 more environment variables are in the server README

## When to use it
- search Vinted listings with filters
- retrieve an item from its ID or URL
- compare prices between countries
- inspect a seller profile
- spot popular listings

## Example prompts
- Search Vinted for items in this category, country, and price range.
- Open this item URL, return its details, and compare it with similar offers.
- Compare this brand across several Vinted countries and point out the price differences.

## Similar
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [AIHawk](https://affpapa.org/en/nevibecode/mcp/aihawk.md) — MCP server · ★ 32221
- [Skyvern](https://affpapa.org/en/nevibecode/mcp/skyvern.md) — MCP server · ★ 23263
- [SeleniumBase MCP](https://affpapa.org/en/nevibecode/mcp/seleniumbase-mcp.md) — MCP server · ★ 13169
- [apify-mcp-server](https://affpapa.org/en/nevibecode/mcp/apify-mcp-server.md) — MCP server · ★ 12927

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md