¿Qué diferencia hay entre Resources y Tools en MCP?

Los Tools ejecutan acciones contra la API (crear factura, listar gastos). Los Resources exponen datos de referencia estáticos que el agente puede consultar sin hacer llamadas a la API. Tipos impositivos, calendarios fiscales o categorías de gasto están siempre disponibles como contexto.

¿Qué son los MCP Prompts y cómo se usan?

Los Prompts son flujos de trabajo guiados que encadenan múltiples herramientas en una secuencia lógica. En lugar de ejecutar operaciones sueltas, un prompt como monthly-close guía al agente paso a paso: revisar facturas pendientes, categorizar gastos, verificar obligaciones fiscales.

¿Necesito actualizar algo para usar v1.2?

Si usas npx @frihet/mcp-server, obtienes la última versión automáticamente. Si tienes una instalación fija, actualiza con npm update @frihet/mcp-server. No hay cambios de ruptura respecto a v1.1.0.

MCP Server v1.2: recursos, prompts y output estructurado

La versión 1.2.1 del servidor MCP de Frihet no añade más herramientas. Añade inteligencia. Resources para que los agentes tengan contexto fiscal sin preguntar. Prompts para que ejecuten flujos completos sin intervención. Output estructurado para que cada respuesta sea parseable de forma determinista.

Esta actualización convierte el servidor MCP de un puente de operaciones CRUD en una interfaz de gestión empresarial completa para agentes de IA.

Resources: datos de referencia siempre disponibles

Los MCP Resources son datos estáticos que el agente puede leer en cualquier momento sin hacer llamadas a la API de Frihet. No consumen cuota, no requieren autenticación adicional y están disponibles desde el momento en que el servidor se conecta.

La v1.2 introduce 5 resources:

`frihet://api/schema`

Resumen de todos los endpoints disponibles, métodos de autenticación y límites de tasa. Cuando un agente necesita saber qué puede hacer con Frihet, consulta este recurso en lugar de descubrirlo por prueba y error.

`frihet://tax/rates`

Tipos impositivos vigentes en España: IVA general (21%), reducido (10%) y superreducido (4%); IGIC canario (7%, 3%, 0%); retenciones IRPF. El agente tiene este contexto antes de crear una factura o registrar un gasto. No necesita preguntarte qué IVA aplicar si ya sabe dónde opera tu negocio.

`frihet://tax/calendar`

Fechas de presentación de declaraciones trimestrales: Modelo 303 (IVA), Modelo 130 (IRPF), Modelo 420 (IGIC). Cuando el agente prepara un cierre trimestral, sabe exactamente cuándo vence cada obligación.

`frihet://config/expense-categories`

Las 8 categorías de gasto con sus reglas de deducibilidad. Material de oficina, suministros, transporte, dietas, formación, seguros, servicios profesionales, otros. Cada categoría incluye el porcentaje de deducibilidad y las condiciones que aplican.

`frihet://config/invoice-statuses`

El flujo de estados de una factura: borrador, emitida, enviada, cobrada, vencida, anulada. Cada estado incluye las transiciones permitidas y los triggers que pueden activarse (webhooks, notificaciones). El agente sabe qué acciones son válidas en cada momento.

Los Resources no reemplazan a los Tools. Los Tools operan sobre tus datos reales. Los Resources proporcionan el contexto estático que los agentes necesitan para operar correctamente.

Prompts: flujos de trabajo guiados

Un Tool ejecuta una operación. Un Prompt orquesta varias operaciones en un flujo coherente. La diferencia es pasar de "crea este gasto" a "procesa estos 15 tickets de gasto, categorízalos, aplica los impuestos correctos y confirma antes de crear".

La v1.2 incluye 5 prompts:

`monthly-close`

Cierre mensual guiado. El agente revisa facturas pendientes de cobro, categoriza gastos sin asignar, verifica que las obligaciones fiscales del periodo están cubiertas y genera un resumen. Un flujo que normalmente lleva una hora de revisión manual, ejecutado en una conversación.

`onboard-client`

Alta de nuevo cliente. Determina el tipo impositivo según la ubicación del cliente (IVA peninsular, IGIC canario, intracomunitario), crea el registro con los datos fiscales correctos y genera un presupuesto de bienvenida. Todo en una secuencia.

`quarterly-tax-prep`

Preparación trimestral de impuestos. Recopila todas las facturas del periodo, calcula las bases imponibles de IVA o IGIC, aplica las retenciones de IRPF y genera una previsualización del Modelo 303 o 130. El agente hace el trabajo; tú o tu gestor validáis el resultado.

`overdue-followup`

Seguimiento de facturas vencidas. Identifica todas las facturas fuera de plazo, las agrupa por cliente, calcula el importe total pendiente por cada uno y redacta mensajes de cobro personalizados. De "tengo que revisar qué me deben" a "aquí tienes los borradores listos para enviar".

`expense-batch`

Procesamiento de gastos por lotes. Recibe una lista de gastos, los categoriza según las reglas configuradas, aplica los impuestos correspondientes, verifica la deducibilidad de cada uno y los crea con confirmación previa. Ideal para procesar tickets acumulados de una semana o un viaje.

Los Prompts funcionan en cualquier cliente MCP compatible. En Claude Code, puedes invocarlos directamente. En otros agentes, el prompt aparece como un flujo disponible que el agente puede ejecutar.

Output estructurado: respuestas parseables

Hasta ahora, las respuestas del servidor MCP eran texto formateado. Útil para lectura humana, pero los agentes necesitan datos estructurados para tomar decisiones programáticas.

La v1.2 añade outputSchema y structuredContent a cada herramienta. Cada respuesta incluye un esquema JSON que describe exactamente la estructura de los datos devueltos. El agente sabe antes de llamar qué campos va a recibir, de qué tipo son y cuáles son opcionales.

Esto es lo que permite que un prompt como quarterly-tax-prep encadene 4 operaciones de forma fiable: cada paso produce datos con una estructura conocida que el siguiente paso puede consumir sin ambigüedad.

Para desarrolladores que construyen integraciones sobre el servidor MCP, esto elimina la necesidad de parsear texto libre. La respuesta siempre tiene la misma forma.

Anotaciones de seguridad

Cada herramienta del servidor MCP ahora incluye anotaciones que indican si la operación es de solo lectura o destructiva. Un list-invoices está marcado como lectura. Un delete-expense está marcado como destructivo.

Esto permite a los agentes implementar políticas de confirmación. Un agente puede ejecutar operaciones de lectura sin preguntar, pero solicitar confirmación explícita antes de eliminar o modificar datos. La seguridad no depende del agente — viene definida por el servidor.

Instalación universal

El servidor se instala con un solo comando en cualquier agente compatible:

npx @frihet/mcp-server

Funciona en Claude Code, Claude Desktop, Cursor, Windsurf, Cline, Codex y cualquier cliente MCP. Para agentes que soportan instalación via skills:

npx skills add Frihet-io/frihet-mcp

Ambos métodos dan acceso a las 30+ herramientas, los 5 resources, los 5 prompts y el output estructurado.

Repositorio bajo Frihet-io

El servidor MCP ha sido transferido a la organización Frihet-io en GitHub. La URL del repositorio es ahora github.com/Frihet-io/frihet-mcp. Los links anteriores redirigen automáticamente.

El paquete npm sigue siendo @frihet/mcp-server. No hay cambios en la instalación.

Para quién es esta actualización

Profesionales que ya usan el servidor MCP ganan Resources como contexto fiscal automático y Prompts como flujos que antes ejecutaban paso a paso de forma manual.

Desarrolladores que construyen sobre Frihet ganan output estructurado para integraciones deterministas y anotaciones de seguridad para políticas de confirmación.

Gestorías y asesores fiscales ganan prompts específicos para sus flujos de trabajo: cierre mensual, preparación trimestral, seguimiento de cobros.

Cualquier negocio que use agentes de IA gana un servidor MCP que no solo ejecuta operaciones, sino que sabe cómo encadenarlas en flujos de negocio reales.

Cómo actualizar

Si usas npx @frihet/mcp-server, ya tienes la última versión. Si tienes una instalación fija:

npm update @frihet/mcp-server

No hay cambios de ruptura. Todas las herramientas existentes mantienen su interfaz. Los Resources, Prompts y output estructurado son adiciones puras.

La documentación completa está en docs.frihet.io/desarrolladores. El código fuente en GitHub (Frihet-io/frihet-mcp). El paquete en npm como @frihet/mcp-server.