vinted-mcp — Claude Code MCP server: use and install
This MCP server lets an AI client search Vinted listings, inspect items and sellers, and compare prices across countries.
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-mcpWhat vinted-mcp 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.
What it helps with
- 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 for the agent
- 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.
How to install vinted-mcp
Platform CLI
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-mcpReplace <…> with your own values. 3 more environment variables are in the server README
Platform CLI
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-mcpReplace <…> with your own values. 3 more environment variables are in the server README
Config file
{
"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
Config file
{
"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
Platform CLI
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-mcpReplace <…> with your own values. 3 more environment variables are in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about vinted-mcp
How do I install vinted-mcp in Claude Code?
Run `claude mcp add vinted-mcp -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> -- npx -y @andrijdavid/vinted-mcp`.
What does vinted-mcp do?
It connects Claude Code with Vinted search and analysis tools. The agent can find listings, read item data, inspect sellers, and compare prices across countries.
Do I need a Vinted login?
Anonymous search and price checks are supported. Account actions and a seller’s own listings require a Vinted session; browser sign-in needs Playwright and Chromium.
