Integrates with VTEX public APIs to search and filter the Plaza Vea catalog, retrieve product variants and offers, display product images, and generate cart links for purchasing on Plaza Vea.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@plaza-vea-mcp busca leche y ordénala por precio ascendente"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Servidor MCP local para consultar el catalogo publico de plazaVea mediante las APIs publicas de VTEX. Permite buscar, filtrar, comparar precios, mostrar imagenes dentro de un cliente MCP y generar enlaces para continuar la compra directamente en Plaza Vea.
Incluye un crawler Scrapy opcional que mantiene un cache SQLite y un historial local de precios.
Proyecto independiente, sin afiliacion con Plaza Vea, Compania Food Retail S.A.C. ni VTEX.
Servidor basado exclusivamente en el SDK oficial mcp, usando la API de bajo nivel y stdio.
Consultas live-first al catalogo VTEX con respaldo en SQLite.
Extraccion de todos los SKUs y sellers de cada producto.
Filtros por nombre parcial y marca exacta, tolerantes a mayusculas y acentos.
Ordenamiento por precio ascendente, descendente o nombre.
Imagenes PNG como ImageContent para vision del modelo y Markdown para mostrarlas al usuario.
Enlaces individuales y combinados para agregar productos al carrito.
Crawler Scrapy respetuoso con robots.txt, AutoThrottle, cache HTTP y reintentos.
Sin Selenium, credenciales, CAPTCHA ni automatizacion del pago.
Related MCP server: mcp-carrefour
Python 3.12 o 3.13.
uv.
Codex CLI o cualquier cliente compatible con MCP por stdio.
git clone https://github.com/jeffreymonjacastro/plaza-vea-mcp.git
cd plaza-vea-mcp
uv sync --all-groupsPara registrar el servidor local en Codex desde este checkout:
codex mcp add plaza-vea -- uv --directory C:\ruta\a\plaza-vea-mcp run plaza-vea-mcp
codex mcp get plaza-veaReinicia o abre una nueva tarea de Codex para que las tools aparezcan en la sesion.
Tool | Descripcion |
| Filtra por nombre y marca y ordena por precio o nombre. |
| Devuelve todas las variantes, sellers, ofertas e imagenes. |
| Lista marcas activas, opcionalmente por prefijo. |
| Devuelve |
| Valida SKUs y genera enlaces para continuar en Plaza Vea. |
| Inicia el crawler local en segundo plano. |
| Consulta el progreso y resultado del crawler. |
Ejemplos de solicitudes naturales en Codex:
Busca productos que contengan "leche" y ordenalos del mas barato al mas caro.
Busca cafe de la marca ALTOMAYO y muestra la imagen del producto mas barato.
Genera un enlace de carrito para dos unidades del SKU 12345.
Actualiza la categoria 814 y dime cuando termine.Los precios se devuelven como enteros en centimos de sol (price_cents) y con moneda PEN.
Cada consulta indica si la fuente es live o cache. Cuando se usa el cache, stale es true.
La version inicial usa el catalogo anonimo del canal de venta 1. Precio, stock, promociones,
region y entrega se vuelven a validar al abrir Plaza Vea.
build_cart_links no abre el navegador ni modifica directamente el carrito. Devuelve:
La pagina de cada producto.
El addToCartLink oficial proporcionado por VTEX para cada SKU.
Un enlace combinado para varios SKUs.
La pagina de checkout de Plaza Vea.
El usuario abre el enlace y completa identificacion, entrega y pago en Plaza Vea. Si el enlace combinado deja de ser compatible con la tienda, se pueden abrir los enlaces individuales.
El proyecto nunca solicita ni almacena contrasenas, DNI, direcciones o datos de tarjeta.
Desde MCP, usa start_catalog_refresh. Sin category_id recorre las categorias hoja del arbol
publico; con un ID solo actualiza esa categoria. La tool devuelve un run_id que puede consultarse
con get_catalog_refresh_status.
Los datos locales se guardan en data/catalog.sqlite3; los logs del crawler quedan en
data/logs/. Ambos estan excluidos de Git.
Variables opcionales:
Variable | Uso |
| Directorio de trabajo del proyecto. |
| Directorio para base de datos, logs y cache HTTP. |
| Ruta explicita del archivo SQLite. |
uv sync --all-groups
uv run ruff check src tests scripts
uv run mypy src
uv run pytest
uv run python scripts/smoke_mcp.pyEl smoke test inicia el MCP por stdio, consulta productos reales, obtiene una imagen y construye
un enlace de carrito. No abre el enlace ni avanza al pago.
Respeta los terminos, disponibilidad y politicas publicadas por Plaza Vea.
No incrementes la concurrencia ni desactives AutoThrottle sin autorizacion.
No accedas automaticamente a /checkout; esa ruta esta bloqueada en robots.txt.
No uses este proyecto para evadir CAPTCHA, controles de acceso o limites del sitio.
Las imagenes y datos comerciales pertenecen a sus respectivos titulares.
Consulta THIRD_PARTY_NOTICES.md para referencias y atribuciones.
Codigo publicado bajo licencia MIT. Esta licencia no concede derechos sobre marcas, imagenes ni contenido comercial obtenido de Plaza Vea.
Valida SKUs y genera enlaces para que el usuario abra Plaza Vea y agregue los productos. No abre el navegador, no modifica un carrito y no realiza pagos.
Inputs: items (required). Returns: items, warning, checkout_url, combined_cart_url
Consulta progreso, resultado y errores de una actualizacion Scrapy.
Inputs: run_id (required). Returns: pid, error, run_id, status, +4 more
Devuelve todas las variantes, sellers, ofertas e imagenes de un producto.
Inputs: product_id (required). Returns: brand, stale, offers, source, +5 more
Descarga una imagen publica de un SKU y la devuelve como ImageContent PNG para vision del modelo. Para hacerla visible al usuario en Codex, copia tambien en la respuesta final el Markdown de imagen incluido en TextContent.
Inputs: sku_id (required), image_index. Returns: width, height, sku_id, mime_type, +4 more
Lista marcas activas y permite filtrar por prefijo.
Inputs: limit, prefix. Returns: stale, brands, source, fetched_at
Busca el catalogo publico por nombre parcial y marca exacta. Puede ordenar por precio minimo o nombre; precio y stock se revalidan al abrir Plaza Vea.
Inputs: name, sort, brand, limit, +1 more. Returns: stale, source, products, fetched_at
Inicia un crawler Scrapy local en segundo plano. Escribe catalogo e historial de precios en SQLite, sin modificar datos remotos.
Inputs: category_id. Returns: run_id, status, started_at, category_id
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 7 tools
Each tool has a clear, distinct purpose: searching products, retrieving details, listing brands, fetching images, building cart links, and managing catalog refresh. No overlap or ambiguity.
All tool names follow a consistent verb_noun pattern with lowercase underscores (e.g., search_products, get_product_image, start_catalog_refresh). Perfectly uniform.
7 tools is well within the ideal range for a focused e-commerce catalog server, covering both read operations and background job management without excess.
The tool set comprehensively covers product discovery (search, get, brands, images), cart link generation, and catalog refresh management (start and status). No obvious gaps for the stated domain.
MCP server for real-time product search by barcode (EAN, UPC, GTIN) or keyword on ean-search.org
Unified MCP server for 70+ eCommerce platforms: products, orders, customers, and more.
The Mercado Pago MCP Server implements the Model Context Protocol to provide AI agents and LLMs with access to Mercado Pago's APIs and tools within compatible development environments. It acts as an intermediary that translates Mercado Pago resources into executable functions (tools) that AI applications can invoke to perform actions and automate flows. The server simplifies integration, enables using documentation to implement or improve code, and optimizes operations through natural language interactions without manual implementations.
Unlock the power of food transparency with our Open Food Facts MCP server. Easily look up any food
