Skip to content
MCP server

Vinted

Search second-hand Vinted listings by keyword, price and sort, read-only

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI
Runs
Locally
Version
0.1.0
Listing updated
2 days ago

About Vinted

Vinted is an open-source MCP server for e-commerce. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "vinted-mcp": {
      "command": "uvx",
      "args": [
        "vinted-search-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "vinted-mcp": {
      "command": "uvx",
      "args": [
        "vinted-search-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

MIT licence

Prices change. Check thiagolannes.com before you buy.

Vinted 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 to Vinted

  1. Let Claude, ChatGPT or Cursor manage a PrestaShop shop with per-employee permissions

    Not checked yet
    • Remote
    • Open source
    • 2 GitHub stars
    • E-commerce
  2. SecureCloud

    MCP server

    SentinelOne and IT security catalog, prices, quotes and checkout links for Israel

    • 7 tools
    • Remote
    • Free
    • Security
  3. Search replacement filters, alarms and batteries, check fit and build a cart link

    • 7 tools
    • Remote
    • Free
    • E-commerce
  4. Renta

    MCP server

    Remote MCP server for running an outdoor rental shop on Renta from an AI client

    • Remote
    • Paid
    • E-commerce
  5. Hosted MCP server that returns any Shopify store's products, prices and stock

    Not checked yet
    • 4 tools
    • Remote
    • Paid
    • E-commerce
  6. repairinfo

    MCP server

    Repairability scores and spare-parts years for EU appliances and electronics

    • 4 tools
    • Remote
    • Freemium
    • Analytics and data