Para LLM y agentes

Todo el sitio está disponible en formatos aptos para máquinas. Si eres un LLM o estás construyendo un agente, usa estos endpoints en vez de extraer HTML.

Endpoints

Instalar componentes programáticamente

El registro usa un esquema JSON abierto. Cada elemento contiene dependencies (npm), registryDependencies (otros elementos) y files[].content (el código TypeScript completo):

curl https://ui.logic2b.com/r/button.json

Cada payload registry:ui también publica api, generado desde sus exports de TypeScript, y accessibility: modelo de soporte, semántica/ARIA, interacción de teclado, responsabilidades del consumidor y limitaciones conocidas. Un agente debe preservar esos requisitos al componer o modificar un componente.

Para instalar en el proyecto del usuario, ejecuta la CLI:

npx logic2b@next add button

O resuelve una versión mediante /r/versions.json, descarga el payload direccionado por contenido del manifiesto inmutable, verifica su SHA-256, escribe files[].content, instala las dependencias y recorre registryDependencies.

Copy Prompt

Cada superficie de instalación —componentes, bloques, gráficos y el estudio /create— ofrece Copy Prompt junto al comando. Copia un encargo autocontenido con la ruta CLI, un fallback contra el JSON del registro, el tema exacto, la tabla de rutas y una lista de verificación. Un agente recibe así el contexto completo sin extraer páginas ni adivinar convenciones.

Servidor MCP

Requisitos del host y versiones beta

Las herramientas MCP devuelven datos y planes. Aplicar un plan requiere un host capaz de escribir archivos; instalar dependencias, compilar y verificar en el navegador requiere un entorno con el gestor de paquetes adecuado. Un chat que solo tiene MCP remoto puede consultar código y solicitar planes, pero no puede completar esos pasos por sí solo. El servidor remoto no accede a tus archivos.

El transporte stdio local requiere Node.js 18+ y npm. Usa @logic2b/mcp@next para la beta y logic2b@next para la CLI. Estos selectores npm son independientes de version del registro. Registra la versión del handshake MCP y --version de la CLI: next puede cambiar. El MCP remoto y el código actual ofrecen resultados estructurados, lecturas verificadas por defecto, límites de entrada y list_presets. El paquete npm @next sigue en 1.0.0-rc.2: devuelve JSON como texto y aún no incluye esas novedades. Usa el endpoint remoto para acceder al catálogo completo descrito aquí hasta la próxima publicación npm.

Si omites version, el MCP resuelve el canal next del registro a una versión exacta, verifica el SHA-256 de cada payload y devuelve registryVersion; una verificación fallida es un error, nunca una copia sin verificar. Las entradas están acotadas (32 items por llamada, 1 MB de CSS, cuerpos de 2 MB); los argumentos inválidos son errores JSON-RPC y los fallos de ejecución devuelven isError. /mcp es un endpoint de protocolo: un GET con HTTP 405 es esperado; comprueba la conexión con un cliente MCP, no navegando al endpoint.

El registro expone el Model Context Protocol de dos formas, con la diferencia de versión npm indicada arriba. Para leer: list_components, search_components, get_component, get_demo, list_registry_versions y get_changelog. Las lecturas, instalaciones y operaciones de tema aceptan version como semver exacto, rango o canal, y verifican SHA-256 antes de responder.

Para planificar cambios en un proyecto: install_plan devuelve los archivos y dependencias exactos; scaffold_plan devuelve una app Next.js, Vite o Astro completa desde un starter de marketing, dashboard o auth. get_theme, decode_preset y apply_preset reconstruyen o parchean theme.css; list_presets descubre las mismas configuraciones curadas de /es/themes, con ids canónicos, enlaces al estudio y avisos medidos; contrast_audit comprueba WCAG 2.2 y APCA; lint_theme detecta tokens ausentes, duplicados o inválidos, deriva, contraste y fidelidad exacta a un preset. export_tokens resuelve cualquier preset al paquete global/claro/oscuro que alimenta las salidas CSS, iOS y Android.

Por ejemplo, un agente puede llamar a scaffold_plan con framework: "vite", starter: "dashboard", version: "next" y un preset, escribir los archivos e instalar dependencias. La respuesta conserva la versión exacta en components.json. CI compila ese mismo contrato para Next, Vite y Astro.

Remoto (sin instalar un servidor MCP local) — conecta un cliente MCP HTTP streamable:

https://ui.logic2b.com/mcp

Con Claude Code:

claude mcp add --transport http logic2b https://ui.logic2b.com/mcp

O en un cliente con configuración JSON:

{
  "mcpServers": {
    "logic2b": { "type": "http", "url": "https://ui.logic2b.com/mcp" }
  }
}

Local (stdio) — npx -y @logic2b/mcp@next ejecuta el paquete publicado como proceso local, con las diferencias de versión indicadas arriba.

Convenciones fiables para un agente

• Cada componente usa cn() desde @/lib/utils.
• Los colores siempre son tokens (bg-primary), nunca clases de paleta crudas.
• Las variantes se definen y exportan con class-variance-authority.
• Cada raíz incluye data-slot para una selección estable.

Inspección de proyectos en el candidato fuente

El candidato fuente añade logic2b inspect --json --details full y la herramienta MCP inspect_project, sin acceso a la red. Comprueba su presencia en --help o tools/list antes de utilizarlas. Inspeccionan configuración y huellas de archivos, identifican alias confirmados y modificaciones locales, y mantienen explícito lo desconocido. El MCP necesita una instantánea aportada por el anfitrión; no puede leer tu disco. Límites: 128 KiB de configuración, 1.000 huellas y rutas relativas de 256 caracteres. Solicita el detalle completo antes de conciliar destinos: los planes de instalación todavía no consumen este contexto automáticamente. Disponible en fuente no significa publicado.

Instrucciones gestionadas para agentes (candidato de código fuente)

El código actual incorpora agent_rules en MCP y rules en CLI. Comprueba su presencia en el catálogo de herramientas o en la ayuda del CLI; este cambio no implica que el paquete npm instalado ya lo incluya.

init, add y update generan o actualizan AGENTS.md y DESIGN.md. La opción --no-agent-rules lo desactiva. rules --format agents,claude,cursor,copilot añade la importación @AGENTS.md para Claude, una regla Cursor y una sección Copilot. El texto externo a los marcadores se conserva. Los marcadores dañados requieren reparación; el instalador informa por separado si fallan las reglas.

Sin terminal, agent_rules devuelve archivos a partir de preset, stack, iconLibrary, formats, registryVersion exacta e items instalados (nombre y, opcionalmente, tipo/categorías). Todos son opcionales. Un inventario omitido es desconocido: el catálogo disponible no prueba una instalación. Combina el bloque gestionado con las instrucciones existentes, sin sustituir el documento completo ni el frontmatter propio de Cursor. Las reglas ocupan hasta 6 KiB; los inventarios grandes indican cuántos nombres se muestran. DESIGN.md es una referencia separada del preset: prevalecen las personalizaciones del CSS real.

scaffold_plan incluye ambos documentos salvo con agentRules: false. El paquete MCP incluye skills/logic2b-ui/SKILL.md, que puedes copiar a la ubicación de skills de tu host; npx no lo instala allí automáticamente. La skill utiliza herramientas disponibles y comprobaciones del proyecto. Revisión, composición y propuestas siguen planificadas. Las reglas no autorizan ejecuciones nuevas ni exigen repetir una aprobación ya concedida por el usuario.