Back to Browse

Vinted MCP Server

Developer ToolsModerate5.6MCP RegistryLocal
Free

Server data from the Official MCP Registry

Search second-hand listings on Vinted (anonymous, read-only).

About

Search second-hand listings on Vinted (anonymous, read-only).

Security Report

5.6
Moderate5.6Moderate Risk

The vinted-search-mcp server is a small, anonymous, read-only scraper that queries Vinted's public catalog page with httpx and parses the embedded results. No credentials are handled, no shell execution or dynamic code evaluation occurs, and network access is the only permission needed for its stated purpose. Minor observations: the scraper is fragile by design, the broad exception handler returns raw error strings to the model, and the user-supplied base URL is not validated, but none of these indicate malicious behavior. Supply chain analysis found 5 known vulnerabilities in dependencies (0 critical, 5 high severity). Package verification found 1 issue.

5 files analyzed · 10 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-thiagojacoblannes-vinted-mcp": {
      "args": [
        "vinted-search-mcp"
      ],
      "command": "uvx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

vinted-mcp

MCP server for searching second-hand listings on Vinted, so Claude (or any MCP client) can answer "what does a used X go for?".

Anonymous and read-only. No login, no account, no writes: it only searches. Not affiliated with Vinted.

Tool

search

Search listings, with optional filters. Returns the total number of matches and the listings for one page.

Parameters:

  • query — search keywords (e.g. "nike air max 90", "vestido zara")
  • price_min / price_max — price range in EUR
  • sort — "relevance" (default) | "cheap" | "expensive" | "newest"
  • page — page number (default 1)
  • per_page — results per page (default 24, max 96)

Each listing has: title, price, price with Vinted's buyer protection fee (shipping is extra), brand, size, condition, link, photo, whether the seller is a business, and favourites.

Tip: "cheap" also pulls in loosely related listings. For "the cheapest X", use the default relevance sort with price_max.

Install

Quickest (needs uv): no clone needed, it runs straight from PyPI.

claude mcp add vinted -- uvx vinted-search-mcp

For Claude Desktop, use "command": "uvx", "args": ["vinted-search-mcp"].

From source:

Requires Python 3.10+.

git clone https://github.com/ThiagoJacobLannes/vinted-mcp
cd vinted-mcp
python -m pip install -e .

On Windows, if you keep code in a cloud-synced folder (Google Drive, OneDrive), create the virtual environment outside it: sync clients drop desktop.ini files into folders, which can crash packages on startup.

Add to Claude Code

claude mcp add vinted -- python -m vinted_mcp.server

Add to Claude Desktop

Merge claude_desktop_config.snippet.json into your Claude Desktop claude_desktop_config.json, then restart Claude Desktop:

{
  "mcpServers": {
    "vinted": {
      "command": "python",
      "args": ["-m", "vinted_mcp.server"]
    }
  }
}

Other countries

Portugal is the default. Set VINTED_BASE_URL to another Vinted domain (for example https://www.vinted.fr or https://www.vinted.es) to search there.

How it works

Vinted has no official API. The server loads Vinted's public catalog page for your search and reads the results the page already contains (they arrive as React Server Component data). If Vinted changes its page, the tool fails with a clear {"error": ...} instead of returning wrong data.

License

MIT

Reviews

No reviews yet

Be the first to review this server!