BOE Skill

El directorio de legislación española. Consulta el Boletín Oficial del Estado directamente desde tu agente.

Usa boe_del_dia y buscar_boe para acceder a la legislación. Esta skill se centra en conceptos y flujos de trabajo canónicos.

Quick Start

# 1. Instalar la skill
npx @spainmcp/cli@latest skill add spainmcp/boe-skill

# 2. Conectar con SpainMCP
spainmcp mcp add "https://mcp.lat/api/mcp" --id spainmcp

# 3. Consultar el BOE de hoy
spainmcp tool call spainmcp boe_del_dia '{}'

# 4. Buscar en el BOE
spainmcp tool call spainmcp buscar_boe '{"query": "convocatoria empleo"}'

# 5. Explorar herramientas disponibles
spainmcp tool list spainmcp
spainmcp tool list spainmcp boe.

# 6. Inspeccionar esquema de una herramienta
spainmcp tool get spainmcp boe_del_dia

# 7. Llamar con parámetros completos
spainmcp tool call spainmcp buscar_boe '{"query": "becas", "fecha": "2026-04-07"}'

Conceptos Clave

Herramientas disponibles

Esta skill expone 2 herramientas al agente a través de SpainMCP. Cada herramienta se conecta a la API oficial del BOE en boe.es. Sin autenticación requerida. Flujo canónico:

spainmcp tool list spainmcp
spainmcp tool get spainmcp boe_del_dia
spainmcp tool call spainmcp boe_del_dia '{}'

Para flags y opciones disponibles, ejecuta spainmcp tool --help y spainmcp mcp --help.

Conectar (Conexiones MCP)

Una conexión es una sesión MCP gestionada y duradera. SpainMCP gestiona el ciclo de vida de la sesión, el almacenamiento de credenciales y la renovación de tokens. Modelo de estado de conexión:

• conectado: listo para listar/llamar herramientas BOE
• auth_requerida: el usuario debe abrir la URL de autorización
• error: inspeccionar detalles y reintentar/corregir configuración

Flujo canónico (conexión de un solo usuario):

spainmcp mcp add https://mcp.lat/api/mcp \
  --id usuario-123-boe \
  --metadata '{"userId":"usuario-123"}'

spainmcp mcp list --metadata '{"userId":"usuario-123"}'
spainmcp tool list usuario-123-boe

Si el CLI muestra auth_requerida, indica al usuario que abra la URL y vuelve a intentarlo.

Scoping de Tokens

Los tokens de servicio son credenciales restringidas para uso en navegador/móvil/agente. Nunca pases una API key completa a código no confiable. Modelo mental de políticas:

• Una política de token es una o más restricciones
• En el CLI, pasa un objeto JSON por flag --policy
• Los campos dentro de una restricción son AND (más campos = más restrictivo)
• Las listas y múltiples restricciones son OR (más entradas = más permisivo)

Token de usuario canónico:

spainmcp auth token --policy '{
  "namespaces": "mi-app",
  "resources": "connections",
  "operations": ["read", "execute"],
  "metadata": { "userId": "usuario-123" },
  "ttl": "1h"
}'

Restricciones de Herramientas (`rpcReqMatch`, experimental)

Usa rpcReqMatch para restringir peticiones MCP JSON-RPC específicas (regex por ruta). Importante: los IDs de conexión no están en el cuerpo JSON-RPC, por lo que combina:

• metadata para restricción a nivel de conexión
• rpcReqMatch para restricción de método/herramienta

Restricción combinada canónica:

spainmcp auth token --policy '{
  "resources": "connections",
  "operations": "execute",
  "metadata": { "connectionId": "mi-boe" },
  "rpcReqMatch": {
    "method": "tools/call",
    "params.name": "^boe\\."
  },
  "ttl": "30m"
}'

Salida por Pipe

Cuando la salida se redirige, los comandos de SpainMCP emiten JSONL (un objeto JSON por línea):

spainmcp tool list spainmcp --flat --limit 1000 | grep boe