LotsDirectory

npx add-mcp 'https://api.lots.directory/mcp'

Pregúntale a tu agente, por ejemplo.

Una vez que LotsDirectory esté conectado, solicitudes simples como estas funcionan.

Conéctate en dos minutos.

Claude

Configuración → Conectores → Añadir conector personalizado. Pega la URL, conéctate e inicia sesión con tu cuenta de Lots.

ChatGPT

Configuración → Apps y Conectores → Avanzado → activa el Modo desarrollador, luego crea un conector con la URL e inicia sesión.

Claude Code

claude mcp add --transport http lots-directory https://api.lots.directory/mcp

Codex

codex mcp add lots-directory --url https://api.lots.directory/mcp

Cursor, Windsurf y otros

{
  "mcpServers": {
    "lots-directory": {
      "url": "https://api.lots.directory/mcp"
    }
  }
}

Agentes en la nube sin MCP

Dale al agente https://api.lots.directory/docs.md y una clave API de lotstech.com/api. Llama a la API REST con Authorization: Bearer <key>.

Cada servidor usa OAuth: tu agente actúa como tú, dentro de tus propios roles y espacios de trabajo. Puedes desconectarlo en cualquier momento desde la aplicación.

36 herramientas, también endpoints REST.

Cada herramienta está disponible a través de MCP y como endpoint REST bajo https://api.lots.directory/api/v1/lotsdirectory.

Responder una pregunta

PATCH /questions/:id

Responde una pregunta en un listado que te pertenece.

Verificar la insignia de LotsDirectory

POST /listings/:id/verify-badge

Comprueba que el sitio web del producto muestra la insignia de LotsDirectory (un enlace a lots.directory/products/<slug>; el fragmento está en get_my_listing badge.snippet). Si se encuentra: el listado pasa a Verificado, su enlace al sitio web se sigue mientras la insignia esté activa, y un listado gratuito que espera su insignia se publica. El resultado indica qué se leyó y por qué no se encontró la insignia (por ejemplo, una página construida solo con JavaScript).

Completar la carga de imagen del producto

POST /images/uploads/complete

Verifica los bytes realmente subidos y el tamaño/tipo reservado antes de adjuntar una imagen. Devuelve la URL; como máximo 8 imágenes distintas por listado, incluyendo logo y portada.

Confirmar el pago de Directory Pro

Confirma un pago de Directory Pro después de regresar del proceso de pago. Activa solo un pedido pagado para este producto y propietario. Repetirlo no extiende la promoción.

Crear carga de imagen de producto

POST /images/uploads

Sube una imagen local: obtén una URL PUT firmada de 15 minutos, sube los bytes y luego completa_listing_image_upload. Tamaño exacto, máximo 2 MB. Solo JPEG/PNG/WebP/GIF.

Eliminar imagen de producto no utilizada

POST /images/delete

Elimina una imagen subida que te pertenezca. Quítala del listado y guarda primero. Libera un espacio de carga no adjunto.

Obtener categoría

GET /public/categories/:slug

Obtén una categoría con sus productos publicados.

Obtener oferta de Directory

Lee la oferta actual de Directory, precio, límites de imagen, recuento de directorios verificados y cómo se rastrea el Domain Rating (Directory Pro a diario, listados Verificados gratuitos semanalmente). El precio solo está presente cuando el pago de $20 está realmente habilitado.

Obtener historial de Domain Rating

Lee la serie de Domain Rating de un producto que te pertenece: valor actual, cuándo se comprobó, el mejor valor y los últimos 90 días. Los productos Directory Pro se comprueban todos los días; los productos Verificados gratuitos (la insignia de LotsDirectory en tu sitio web) una vez por semana, los lunes. Los productos no reclamados y reclamados no se rastrean. Domain Rating por Ahrefs.

Obtener mi producto

GET /listings/:id

Obtén todos los detalles de un listado que te pertenece (para edición), incluyendo trust_state; badge: el fragmento de insignia para copiar y pegar, las últimas comprobaciones de insignia y si el listado espera su insignia para publicarse; launch: su semana de lanzamiento (estado upcoming, live o ended), su lugar y votos en el tablero semanal, semanas seleccionables para Directory Pro (set_launch_week) y cualquier victoria de Producto de la Semana con su fragmento de insignia; y traffic: los últimos 30 días de visitas, clics al sitio web del producto y lecturas de rastreadores de IA (GPTBot, ClaudeBot, PerplexityBot y otros, desde el user agent).

Obtener mi perfil

GET /me/profile

Obtén el perfil autenticado del creador, con email_preferences: dr_updates (nuevo máximo histórico de Domain Rating), launch_results (Producto de la Semana) y badge_alerts (insignia faltante en un producto Verificado). Todos están activados por defecto; cada correo tiene un enlace de baja con un clic.

Obtener un directorio

Lee un directorio auditado y el progreso guardado para un producto que te pertenece: enlace de envío, relevance_tier, fecha del listado más reciente, tiempo de aprobación cuando el directorio lo indica, y agent_submission (método, endpoints, documentación, autenticación, qué puede hacer un agente, qué debe terminar el propietario y la página desde la que se leyó). Antes de abrir un navegador, usa agent_submission; si es form o unknown, revisa el /llms.txt, /openapi.json y /.well-known/agents.json del sitio. Nunca completes pagos o creación de cuentas sin el propietario. Los requisitos y tarifas no se inventan.

Obtener producto

GET /public/listings/:slug

Obtén un único producto publicado por slug. trust_state es unclaimed (listado desde el sitio web público del producto), claimed (el propietario demostró un correo en el dominio), verified (el propietario muestra la insignia de LotsDirectory) o pro; link_rel es el rel utilizado para enlaces al sitio web del producto.

Obtener analíticas del producto

GET /listings/:id/analytics

Lee visitas, clics y una proporción de visitas a clics para un producto Directory Pro que te pertenece. No hay atribución de fuente. Los productos gratuitos reciben PRO_REQUIRED.

Obtener derechos del producto

Lee el estado Free o Directory Pro, trust_state, asignación de imágenes, fechas de promoción y capacidades de un producto que te pertenece. checkout_needs_verification es true hasta que el listado esté Verificado. Directory Pro también elige su semana de lanzamiento (set_launch_week) y aparece destacado en la página de inicio esa semana. No revela el producto de otro propietario.

Obtener preparación del producto

Lee el paquete reutilizable de preparación del producto para un producto Directory Pro que te pertenece. format text o markdown devuelve contenido copiable. submission_routes lista los directorios del catálogo a los que un agente puede enviar (MCP, REST, un enlace de borrador que el propietario termina, o una solicitud de extracción de GitHub) y la regla para el resto: navegador solo como último recurso, nunca pago o creación de cuentas sin el propietario. Los campos faltantes permanecen faltantes. Nada se inventa.

Listar categorías

GET /public/categories

Lista todas las categorías del directorio.

Listar progreso de directorios

Lista el progreso guardado de directorios para un producto que te pertenece. format=text devuelve un resumen copiable. Los recuentos incluyen directorios que no se han iniciado.

Listar preguntas entrantes

GET /me/questions

Lista preguntas hechas sobre tus productos (para responder).

Listar mis productos

GET /me/listings

Lista los listados propiedad del usuario autenticado, con el trust_state de cada listado.

Listar notificaciones

GET /me/notifications

Lista las notificaciones del usuario autenticado.

Listar productos

GET /public/listings

Lista productos publicados del directorio con filtros y ordenación. Cada tarjeta tiene trust_state (unclaimed, claimed, verified o pro) y link_rel.

Listar lanzamientos de esta semana

El tablero de lanzamientos semanales de LotsDirectory. Una semana de lanzamiento va de lunes 00:00 UTC a domingo 23:59 UTC. Solo los productos Verificados y Pro se lanzan; se clasifican por los votos emitidos durante su semana de lanzamiento (empates: más votos en total, luego el producto que se unió primero a la semana). period: this_week (predeterminado), last_week o this_month. Cada entrada tiene rank, week_votes, launch_week y winner_rank (1 a 3 una vez que la semana ha cerrado). resets_at es el próximo reinicio semanal. En el reinicio, los 3 primeros con al menos un voto se convierten en #1, #2 y #3 Producto de la Semana.

Listar directorios verificados

Lista los directorios auditados para un producto que te pertenece, con su progreso guardado. Cada directorio se comprobó para nuevos listados en los últimos 90 días y envíos abiertos, y lleva relevance_tier: core_launch (plataformas de lanzamiento y directorios de startups), review_site, community, ai_directory (solo se muestra para productos de IA) o niche. relevant=true conserva los que encajan con este producto; tier filtra a un tipo. agent_submission indica cómo enviar: mcp o rest (un agente envía a través de la API), draft-link (un agente prepara un borrador que el propietario termina), github-pr (una solicitud de extracción desde la cuenta de GitHub del propietario), email, o form (navegador). agent_submittable=true lista solo las rutas de agente. Esto no registra ni envía nada. Otros filtros: search, category, pricing, tipo de enlace, DR mínimo, estado de progreso.

Gestionar publicación del producto

Publica, despublica, mantén como borrador privado o programa un listado que te pertenezca. El resultado indica si es público, privado, programado, en espera de revisión o awaiting_badge (un listado gratuito se publica una vez que verify_badge encuentra la insignia de LotsDirectory en su sitio web).

Marcar notificación como leída

POST /me/notifications/read

Marca una o todas las notificaciones como leídas.

Elegir la semana de lanzamiento

Directory Pro: elige la semana en que un producto que te pertenece se lanza en el tablero semanal de LotsDirectory, la semana actual o una de las próximas 12 (week_start es cualquier fecha en esa semana, YYYY-MM-DD; la semana va de lunes 00:00 UTC a domingo 23:59 UTC). El producto aparece destacado en la página de inicio durante su semana de lanzamiento. Una semana de lanzamiento se bloquea una vez que comienza, por lo que un producto se lanza una sola vez. Envía un week_start vacío para limpiar una semana que no ha comenzado. Los listados Verificados gratuitos se unen automáticamente a la próxima semana abierta (ver get_my_listing launch) y reciben PRO_REQUIRED aquí; los listados Unclaimed y Claimed reciben NOT_ELIGIBLE.

Publicar una actualización del producto

POST /listings/:id/updates

Publica una actualización en un producto Directory Pro que te pertenezca. Los productos gratuitos no pueden publicar actualizaciones. Las preguntas siguen siendo gratuitas.

Registrar progreso de directorio

Registra o actualiza el progreso de un directorio en un producto que te pertenezca. Esto no envía el formulario. submitted necesita un recibo o nota. live necesita la URL pública del listado. needs_action necesita la próxima acción del propietario. Un reintento idéntico no cambia la revisión.

Buscar productos

GET /public/search

Búsqueda de autocompletado en productos publicados.

Iniciar pago de Directory Pro

Inicia un pago único de $20 para un producto que te pertenezca. El listado debe estar Verificado primero (la insignia de LotsDirectory en su sitio web, comprobada con verify_badge); de lo contrario, se rechaza con VERIFY_FIRST. Se rechaza a menos que la oferta del servidor esté habilitada y el producto de facturación sea $20 USD. No envía el producto a otros directorios.

Enviar un producto

POST /listings

Crea un listado de producto que te pertenezca. Un listado gratuito se publica una vez que la insignia de LotsDirectory está en el sitio web del producto: hasta que verify_badge la encuentre, el listado permanece como borrador (publication.status awaiting_badge, con el fragmento). Una vez Verificado y publicado, se une automáticamente a la próxima semana de lanzamiento abierta. publication: publish (predeterminado), draft para mantenerlo privado mientras se prepara, o schedule con scheduled_publish_at. Gratis incluye 2 imágenes distintas, Directory Pro 8; logo, portada, galería y miniaturas cuentan una vez por URL; cada imagen máximo 2 MB.

Actualizar un producto

PATCH /listings/:id

Actualiza un producto que te pertenezca. Un producto gratuito puede mantener un conjunto de imágenes heredado solo cuando las URLs no cambian. Cualquier cambio real de imagen debe caber en 2 imágenes, o 8 después de Directory Pro. No envíes is_pro ni un límite de imágenes; el servidor decide.

Actualizar perfil del creador

PATCH /me/profile

Actualiza el perfil autenticado del creador. email_preferences activa o desactiva los correos del propietario: dr_updates, launch_results, badge_alerts (true o false; los temas omitidos conservan su configuración).

Actualizar preparación del producto

Guarda anulaciones de preparación, variantes o notas para un producto Directory Pro que te pertenezca. Envía null o en blanco para limpiar una anulación. Pasa expected_revision para evitar sobrescribir una versión más nueva. Las variantes que superan un límite de caracteres se conservan y se advierten, no se truncan.

Subir imagen del producto

POST /images

Sube una URL de imagen o imagen base64 al almacenamiento de Directory. Máximo 2 MB, JPEG/PNG/WebP/GIF. Los productos gratuitos pueden usar 2 imágenes distintas y los productos Directory Pro pueden usar 8, incluyendo logo y portada. La misma URL cuenta una vez. Pasa listing_id para que el servidor aplique ese límite de producto. Como máximo 2 cargas pueden permanecer sin adjuntar.

Preguntas, respondidas.

¿Cuál es la URL del servidor MCP de LotsDirectory?

https://api.lots.directory/mcp. Añádela como servidor MCP remoto (conector personalizado) en tu agente de IA e inicia sesión con tu cuenta de Lots.

¿Qué agentes funcionan con LotsDirectory?

Claude, ChatGPT (modo desarrollador), Claude Code, Codex, Cursor, Windsurf y cualquier otro cliente que admita MCP remoto con OAuth. Los agentes sin MCP usan la API REST con una clave API.

¿Dónde están los documentos de la API de LotsDirectory? https://api.lots.directory/docs.md: Markdown escrito para que un agente de IA pueda leerlo. Las solicitudes van a https://api.lots.directory/api/v1/lotsdirectory con Authorization: Bearer <your key>.

¿Cómo obtengo una clave de API de LotsDirectory?

Usa Generar clave en esta página o en lotstech.com/api. Inicia sesión con tu cuenta de LotsTech, nombra la clave y cópiala una vez. Puedes revocarla allí en cualquier momento.

¿El acceso a MCP o API tiene un costo adicional?

No. Está incluido con LotsDirectory. Solo pagas por el plan o uso propio de LotsDirectory, y tu proveedor de IA factura su propio uso.