MCP server for Vinted: search, item details, favourites, messages, offers, orders and listing management for AI agents. Also ships a CLI and a typed Python client.
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"vinted-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
<p align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/figurophobia/vinted-mcp/main/docs/logo-dark.svg"> <img src="https://raw.githubusercontent.com/figurophobia/vinted-mcp/main/docs/logo-light.svg" alt="Vinted × Model Context Protocol" height="96"> </picture> </p> <h1 align="center">vinted-mcp</h1> <p align="center"> <a href="https://github.com/figurophobia/vinted-mcp/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/figurophobia/vinted-mcp/actions/workflows/ci.yml/badge.svg"></a> <a href="https://pypi.org/project/vinted-mcp/"><img alt="PyPI" src="https://img.shields.io/pypi/v/vinted-mcp?color=09B1BA"></a> <img alt="Python" src="https://img.shields.io/badge/python-3.10%E2%80%933.14-3776AB?logo=python&logoColor=white"> <img alt="MCP" src="https://img.shields.io/badge/MCP-stdio-16181D"> <img alt="Tools" src="https://img.shields.io/badge/tools-55-09B1BA"> <a href="https://github.com/figurophobia/vinted-mcp/blob/main/LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-green"></a> <a href="https://github.com/figurophobia/wallapop-mcp"><img alt="Sibling: wallapop-mcp" src="https://img.shields.io/badge/sibling-wallapop--mcp-13C1AC"></a> </p> <p align="center"> <b>Give an AI agent a Vinted account.</b><br> Search the catalogue, read listings and sellers, chat, negotiate offers on both sides, manage your closet and let the agent draft listings from photos, negotiate within your limits and relist — through the same internal API the Vinted web app uses, with no browser automation. <b>Buying stays manual.</b> </p> --- One codebase, three interfaces: | | What | Entry point | |---|---|---| | **MCP server** | 55 tools over stdio for any MCP client; writes hidden unless you opt in | `vinted-mcp` | | ⌨ **CLI** | Every feature from the terminal, JSON output | `vinted` | | **Python library** | Typed client the other two are built on | `import …
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.