# Vinted

> Vinted is an open-source MCP server for e-commerce. Search second-hand Vinted listings by keyword, price and sort, read-only. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://thiagolannes.com
- **Repository:** https://github.com/thiagojacoblannes/vinted-mcp
- **MCP Registry name:** io.github.ThiagoJacobLannes/vinted-mcp
- **Categories:** e-commerce
- **Listing updated:** 2026-11-15

## About

Vinted MCP lets an assistant answer questions like what a used pair of trainers goes for. It has a single search tool taking keywords, a price range in euros, a sort order (relevance, cheap, expensive or newest), a page number and a page size of up to 96.

Each result carries title, price, the price including Vinted's buyer protection fee (shipping is extra), brand, size, condition, link, photo, whether the seller is a business and favourites count. The README notes the cheap sort also pulls in loosely related items, so for the cheapest of something it suggests relevance with a price cap.

Vinted has no official API, so the server reads results embedded in the public catalogue page. If Vinted changes that page, the tool returns a clear error instead of wrong data. Portugal is the default market; setting VINTED_BASE_URL switches to another country such as France or Spain. The project is MIT-licensed and not affiliated with Vinted.

## Features

- **Keyword search:** Search listings with free-text queries.
- **Price filters:** Limit by minimum and maximum price in EUR.
- **Four sort orders:** Relevance, cheap, expensive or newest.
- **Fee-inclusive price:** Shows price with the buyer protection fee as well as the base price.
- **Country switch:** Point it at another Vinted domain with an environment variable.
- **Clear failures:** Returns an error when the page layout changes.

## Good for

- Check what a used item typically sells for
- Find the cheapest listing of a model under a price cap
- Compare conditions and sizes on second-hand clothing
- Track new listings for a brand

## Install

### Claude Code (Terminal)

```sh
claude mcp add vinted-mcp -- uvx vinted-search-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "vinted-mcp": {
      "command": "uvx",
      "args": [
        "vinted-search-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "vinted-mcp": {
      "command": "uvx",
      "args": [
        "vinted-search-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "vinted-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "vinted-search-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "vinted-mcp": {
      "command": "uvx",
      "args": [
        "vinted-search-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "vinted-mcp": {
      "command": "uvx",
      "args": [
        "vinted-search-mcp"
      ]
    }
  }
}
```

## Tools

- `search`: Searches Vinted listings with optional price, sort and paging filters.

## FAQ

### Does it need a login?

No. It is anonymous and read-only.

### How do I install it?

Run claude mcp add vinted -- uvx vinted-search-mcp, which needs uv.

### Which country does it search?

Portugal by default; set VINTED_BASE_URL for others.

### Is it official?

No, it says it is not affiliated with Vinted.

### Is Vinted free?

Yes. Vinted is open source, so you can use and self-host it for free.

### How do I add Vinted to Claude Code?

Run this command in your terminal: claude mcp add vinted-mcp -- uvx vinted-search-mcp

### What are the best alternatives to Vinted?

The closest alternatives to Vinted are O'So MCP Server for PrestaShop, SecureCloud, MadMax Trade Supply parts, Renta and Shopify MCP Server (any store).

## Alternatives

- [O'So MCP Server for PrestaShop](https://ai-powered.com/mcp/o-so-mcp-server-for-prestashop): O'So MCP Server for PrestaShop is an open-source MCP server for e-commerce.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [MadMax Trade Supply parts](https://ai-powered.com/mcp/madmax-trade-supply-parts): MadMax Trade Supply parts is a free MCP server for e-commerce.
- [Renta](https://ai-powered.com/mcp/renta): Renta is a paid MCP server for e-commerce.
- [Shopify MCP Server (any store)](https://ai-powered.com/mcp/shopify-mcp-server-any-store): Shopify MCP Server (any store) is a paid MCP server for e-commerce.
- [repairinfo](https://ai-powered.com/mcp/repairinfo): repairinfo is a freemium MCP server for analytics and data.
- [bxmcp — 1C-Bitrix site assistant](https://ai-powered.com/mcp/bxmcp-1c-bitrix-site-assistant): bxmcp — 1C-Bitrix site assistant is a freemium MCP server for e-commerce.
- [Suawave](https://ai-powered.com/mcp/suawave): Suawave is a paid MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/vinted
