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
| Endpoint | Contenido |
|---|---|
/llms.txt |
Índice de toda la documentación inglesa con URL absolutas |
/es/llms.txt |
Índice de las traducciones españolas |
/es/llms-full.txt |
Toda la documentación española disponible en un Markdown |
/es/docs/<page>.md |
Cualquier página española como Markdown plano |
/r/index.json |
Índice del registro con cada componente y descripción |
/r/<name>.json |
Payload completo: metadatos, código, API y contrato de accesibilidad |
/r/versions.json |
Índice de versiones exactas, fechas y canales |
/r/versions/<version>.json |
Manifiesto inmutable con URL de contenido e integridad SHA-256 |
/r/changelog/<name>.json |
Historial de versiones legible por máquinas |
/tokens/default/manifest.json |
Manifiesto SHA-256 de los tokens portables |
/mcp |
Endpoint MCP remoto mediante HTTP streamable |
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 paquete npm @next resuelve a
1.0.0-rc.3 y coincide con el MCP remoto: resultados estructurados, lecturas
verificadas por defecto, límites de entrada y el catálogo completo descrito
aquí, incluido list_presets. Las instalaciones antiguas de 1.0.0-rc.2
devuelven JSON como texto y no incluyen esas novedades.
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: remoto y
stdio local. 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-slotpara 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.