SoloTodo MCP

En producción: https://solotodo.mmoraga.dev/mcp — protegido con OAuth 2.1, de un solo usuario.

Servidor MCP que expone los datos públicos de SoloTodo.cl —precios, specs, historial y evaluaciones— como herramientas para agentes de IA.

En vez de abrir fichas una por una en el sitio, le pides a tu asistente:

"búscame notebooks con RTX 4050 y 16 GB bajo $1.000.000, y dime si el precio de hoy es bueno"

y el agente filtra, compara el historial y responde. Se apoya en la API pública (publicapi.solotodo.com); no hay scraping de HTML.

Herramientas

Detección de ofertas infladas

La maniobra habitual antes de un CyberDay es subir el precio normal para exhibir un descuento grande sobre una referencia que nadie pagó. historial_precio compara el precio normal de hoy contra su mediana del período: si está inflado y el precio que realmente se paga no bajó, lo marca explícitamente.

**Conclusión:** hoy el mejor precio es $819.990, un 9% sobre el mínimo del período
($749.990). Si no es urgente, conviene esperar.

| Tienda | Precio hoy | Mín. período | Máx. período | Habitual | Veredicto        |
| ------ | ---------- | ------------ | ------------ | -------- | ---------------- |
| Paris  | $819.990   | $749.990     | $1.599.990   | $969.990 | 🟢 Buen precio   |

Uso rápido

npm install
npm run dev        # http://localhost:8787/mcp
npm test           # pruebas unitarias y de protocolo (sin red)
npm run test:live  # pruebas contra la API real de SoloTodo
npm run deploy     # despliegue a Cloudflare Workers

Conectarlo a un cliente MCP

claude mcp add --transport http solotodo https://solotodo.mmoraga.dev/mcp

Luego, dentro de Claude Code, /mcp para iniciar el login: se abre el navegador, pide la clave maestra y el cliente guarda el token. Se hace una sola vez; después el refresh token renueva el acceso solo.

En claude.ai se agrega como conector personalizado (Configuración → Conectores → Agregar conector personalizado) pegando la misma URL. El descubrimiento OAuth y el registro dinámico hacen el resto; solo tienes que escribir la clave maestra cuando aparezca la pantalla de consentimiento.

El transporte es streamable HTTP en modo stateless: cada POST /mcp es autocontenido, no hay sesión ni SSE, y por lo tanto no se necesitan Durable Objects.

Autorización

El servidor es de un solo usuario: no hay registro ni tabla de usuarios. Tu identidad la prueba una clave maestra guardada como secreto del Worker.

Implementa lo que la especificación MCP exige del lado del servidor:

El cliente no necesita configuración: pega la URL, recibe un 401 con WWW-Authenticate, descubre el resto solo y arranca el flujo.

Decisiones de seguridad

• PKCE con S256 obligatorio. Sin code_challenge el /authorize responde 400, y plain se rechaza. Los clientes son públicos, sin secreto compartido: la seguridad la aporta PKCE.

• Nada se guarda en claro. Códigos y tokens se almacenan como SHA-256, así que una filtración de la base no permite suplantar a nadie.

• Códigos de un solo uso. El canje marca el código como consumido con un UPDATE condicional; si dos canjes llegan a la vez, el segundo no afecta filas y se rechaza.

• Sin open redirect. La redirect_uri debe coincidir exactamente con una registrada; si no, se muestra un error en vez de redirigir. En el registro solo se aceptan HTTPS o localhost.

• Tokens ligados a este recurso (RFC 8707). Un token emitido para otro servidor MCP se rechaza con 403, que es la defensa contra confused deputy.

• Rotación de refresh tokens. Cada uso invalida el anterior.

• Bloqueo por fuerza bruta. Cinco claves erradas desde una IP la bloquean 15 minutos.

• Pantalla de consentimiento explícita. Siempre muestra qué aplicación pide acceso y a qué URL va a redirigir. Es la contramedida práctica al punto débil del registro dinámico: cualquiera puede registrar un cliente, así que la última verificación la haces tú antes de escribir la clave.

Vida útil: access token 1 hora, refresh token 30 días.

Operación

npx wrangler secret put MCP_AUTH_PASSWORD   # cambiar la clave maestra
npm run auth:revoke-all                     # botón de pánico: invalida todos los tokens
npm run db:migrate                          # aplicar el esquema (primera vez o tras cambiarlo)

Tras revocar o cambiar la clave, cada cliente vuelve a pedir login.

Ejemplo de llamada directa

curl -s https://solotodo.mmoraga.dev/mcp \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <token>' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
        "name":"buscar_productos",
        "arguments":{"categoria":"notebooks","precio_max_clp":1000000,
                     "specs":{"ram_quantity":16,"video_cards":["RTX 4050"]}}}}'

Cómo está armado

src/
├── index.ts              Worker: Hono, rutas /mcp, /health, /
├── mcp/
│   ├── server.ts         Dispatcher JSON-RPC 2.0 y registro de herramientas
│   └── types.ts          Tipos del protocolo y helper `defineTool`
├── solotodo/
│   ├── client.ts         Cliente HTTP con caché en dos capas
│   ├── api.ts            Endpoints tipados
│   ├── categories.ts     Resolución difusa de categorías
│   ├── filters.ts        Traducción specs humanas → query params
│   └── types.ts
├── auth/
│   ├── oauth.ts          Servidor de autorización OAuth 2.1
│   ├── store.ts          Estado en D1 (clientes, códigos, tokens)
│   ├── crypto.ts         Tokens aleatorios, SHA-256, PKCE
│   └── login-page.ts     Pantalla de consentimiento
├── tools/                Una herramienta MCP por archivo
└── lib/
    ├── price-analysis.ts Estadísticas de historial y ofertas infladas
    ├── format.ts         Precios en CLP y tablas markdown
    └── text.ts           Matching sin acentos

La parte no obvia: los filtros piden IDs, no valores

Este es el detalle que hace falta traducir y que justifica el servidor. Filtrar notebooks con al menos 16 GB de RAM no se hace con el valor:

GET /categories/1/browse/?ram_quantity_min=16
→ 400 "Select a valid choice. That choice is not one of the available choices."

Hay que mandar el id del choice que representa "16 GB" en esa categoría:

GET /categories/1/browse/?ram_quantity_min=103202   ✅

Esos ids viven en /category_specs_form_layouts/?category=<id>&website=1, cambian por categoría y no son adivinables. src/solotodo/filters.ts los resuelve desde texto natural ("16", "16 GB", "RTX 4050"), redondeando hacia arriba en los umbrales: pedir 12 GB aplica el corte de 16 GB en vez de devolver equipos de 8 GB.

Otras particularidades de la API, todas verificadas contra producción y cubiertas por test/live.test.ts:

• Los filtros de precio son en USD (offer_price_usd_max); los precios que se muestran vienen en CLP dentro de prices_per_currency. La conversión usa el tipo de cambio que publica la propia API en /currencies/.

• Los filtros booleanos se validan como entero (screen_touch=1), no como true.

• El filtro de evaluaciones es products en plural; product se ignora en silencio y devuelve el catálogo completo.

• ordering acepta offer_price_usd, normal_price_usd, relevance, discount y leads. No existe el orden descendente con prefijo -.

Caché

Dos capas, para golpear lo menos posible una API de terceros:

1. Memo por request — deduplica llamadas dentro de una misma ejecución de herramienta (el layout de filtros se consulta varias veces al resolver specs).

2. Cache API de Cloudflare — comparte respuestas entre requests, TTL configurable en SOLOTODO_CACHE_TTL (900 s por defecto).

Configuración

Se definen en wrangler.jsonc; para desarrollo local se pueden sobrescribir copiando .dev.vars.example a .dev.vars.

Estado

Fase 1 (MVP) — completa y desplegada en https://solotodo.mmoraga.dev/mcp, con autorización OAuth 2.1 de un solo usuario.

Fase 2 — pendiente. Vigilancia de precios con estado: tabla D1 de productos vigilados, herramientas vigilar_producto / dejar_de_vigilar / listar_vigilados, y un Cron Trigger que compare precios y dispare alertas. Los bindings están comentados en wrangler.jsonc. Queda por decidir el canal de notificación (Telegram / email / otro).

Fase 3 — pendiente. Publicación open source bajo Root SpA, elección de licencia, rate limiting propio y evaluación de una versión hosted en RapidAPI. Si alguna vez se abre a varios usuarios, la clave maestra única deja de servir: habría que agregar usuarios reales y scopes por cliente.

Riesgo a vigilar

La API pública de SoloTodo no declara garantías de estabilidad ni términos de uso explícitos para terceros. Antes de publicar este servidor conviene revisar sus términos y contactar a SoloTodo. Mientras tanto: caché agresiva, un User-Agent identificable y sin paralelismo agresivo contra el upstream.

Las pruebas de test/live.test.ts incluyen un bloque contrato de la API upstream que falla si SoloTodo cambia las convenciones de las que depende este servidor.

Datos de SoloTodo.cl. Este proyecto no está afiliado a SoloTodo.