Vinted MCP Server

An MCP server for Vinted search and analysis that provides tools to search listings, fetch item details, inspect seller profiles, compare prices across countries, and surface trending items.

It also exposes resources for supported countries and category data.

Disclaimer: This project is not affiliated, associated, authorized, endorsed by, or in any way officially connected with Vinted, or any of its subsidiaries or its affiliates. The official Vinted website can be found at vinted.com.

Client support

This server works with MCP clients that support local stdio servers.

Popular clients and setup docs:

• Claude Desktop (local): https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop
• Claude Desktop (remote): https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp
• ChatGPT (MCP developer mode): https://platform.openai.com/docs/guides/developer-mode
• ChatGPT (MCP and connectors): https://platform.openai.com/docs/guides/tools-remote-mcp
• Cursor: https://docs.cursor.com/context/model-context-protocol
• Windsurf: https://docs.windsurf.com/windsurf/cascade/mcp
• Cline: https://docs.cline.bot/mcp/configuring-mcp-servers
• Full MCP client directory: https://modelcontextprotocol.io/clients

Quick start

Option 1: npx

Add this to your MCP client config:

{
  "mcpServers": {
    "vinted": {
      "command": "npx",
      "args": ["-y", "@andrijdavid/vinted-mcp"]
    }
  }
}

Option 1b: bunx (canary)

bunx @andrijdavid/vinted-mcp@next

This starts the server in stdio mode and waits for an MCP client.

Option 2: global install

npm install -g @andrijdavid/vinted-mcp

Then configure:

{
  "mcpServers": {
    "vinted": {
      "command": "vinted-mcp"
    }
  }
}

Run in network mode (Streamable HTTP over TCP)

If you need a network endpoint instead of stdio, run:

VINTED_MCP_TRANSPORT=http VINTED_MCP_HOST=127.0.0.1 VINTED_MCP_PORT=3001 bunx @andrijdavid/vinted-mcp@next

Optional:

• VINTED_MCP_PATH (default /mcp)
• VINTED_MCP_ENABLE_LEGACY_SSE (default true)
• VINTED_MCP_LEGACY_SSE_PATH (default /sse)
• VINTED_MCP_LEGACY_MESSAGES_PATH (default /messages)

Default endpoints:

• Streamable HTTP (recommended): http://127.0.0.1:3001/mcp
• Legacy SSE (older clients): http://127.0.0.1:3001/sse

CLI usage and env variables

Pass env vars inline (macOS/Linux)

VINTED_AUTH_MODE=env \
VINTED_AUTH_COOKIES='session_cookie=your_value; other_cookie=your_value' \
VINTED_AUTH_CSRF_TOKEN='your_csrf_token' \
bunx @andrijdavid/vinted-mcp@next

Pass env vars inline (PowerShell)

$env:VINTED_AUTH_MODE = "env"
$env:VINTED_AUTH_COOKIES = "session_cookie=your_value; other_cookie=your_value"
$env:VINTED_AUTH_CSRF_TOKEN = "your_csrf_token"
bunx @andrijdavid/vinted-mcp@next

Pass env vars inline (Windows Command Prompt)

set VINTED_AUTH_MODE=env
set VINTED_AUTH_COOKIES=session_cookie=your_value; other_cookie=your_value
set VINTED_AUTH_CSRF_TOKEN=your_csrf_token
bunx @andrijdavid/vinted-mcp@next

Use a local .env file

The server auto-loads .env from the current working directory.

cp .env.example .env
bunx @andrijdavid/vinted-mcp@next

Run network mode from CLI with env

VINTED_MCP_TRANSPORT=http \
VINTED_MCP_HOST=127.0.0.1 \
VINTED_MCP_PORT=3001 \
bunx @andrijdavid/vinted-mcp@next

Windows Command Prompt:

set VINTED_MCP_TRANSPORT=http
set VINTED_MCP_HOST=127.0.0.1
set VINTED_MCP_PORT=3001
bunx @andrijdavid/vinted-mcp@next

Authentication and environment

The server auto-loads `.

... View full README on GitHub