MCP

Endpoint MCP on-prem

Este mismo binario expone un servidor de Model Context Protocol (MCP) junto a las páginas que está leyendo ahora mismo. Apunte un agente compatible con MCP hacia él y podrá consultar componentes, tokens y notas de investigación directamente — sin necesidad de levantar un servicio aparte, sin una copia del registro que mantener sincronizada a mano.

API de registro / máquina

No existe un único archivo de registro agregado para descargar. Las recetas de componentes, el paquete de tokens y la búsqueda de texto completo son tres endpoints reales y separados — verificado directamente contra la propia tabla de rutas del servidor en ejecución.

JSON-RPC 2.0. Siempre devuelve HTTP 200 — revise el cuerpo de la respuesta en busca de una clave error en lugar del código de estado. Sobre estándar de MCP: tools/list para enumerar las cinco herramientas anteriores, tools/call para invocar una.

curl -s https://design.pointsav.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_component_recipe","arguments":{"name":"button"}}}'

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [{ "type": "text", "text": "{ ...recipe.json, as a string... }" }]
  }
}

La receta viaja dentro de result.content[0].text como una cadena JSON, no como un objeto de nivel superior — analícela (parse) una vez más de su lado. Leer dtcg-vault/components/button/recipe.json directamente es la alternativa a nivel de sistema de archivos.

Un GET simple, invocable con curl, para la receta de un componente — sin sobre JSON-RPC. Lee vault/components/<slug>/recipe.json tal cual y lo sirve como application/json.

curl -s https://design.pointsav.com/components/button/recipe.json

Búsqueda de texto completo en componentes, tokens y notas de investigación — el mismo índice que consulta la herramienta MCP search_design_system. La respuesta es un arreglo JSON de objetos {id, title, snippet, url}, con un tope de 20 resultados. Un q vacío o ausente devuelve [].

Exportación de tokens DTCG

Los agentes que solo necesitan los valores de los tokens — no las recetas completas de componentes — pueden obtener directamente la exportación en formato DTCG del registro, sin pasar en absoluto por /mcp.

El paquete completo de tokens DTCG — todos los tokens primitive y theme, con rutas y valores reales en notación de puntos, servido como application/json simple.

Los mismos tokens compilados a propiedades personalizadas CSS, servidos como text/css — enlácelo directamente.

Comprime en zip el paquete de tokens actual (tokens.full.json, tokens.css, más los archivos de investigación/atribución del paquete) para uso sin conexión.