MCP Time Server

Documentación de BrainyCalc — Herramientas de Fecha y Hora MCP

Herramientas de Fecha y Hora MCP

Motor de cálculo temporal de alta precisión que admite análisis ISO 8601, conversiones de zona horaria, días hábiles, matemática de duraciones, formato de tiempo relativo y generación completa de calendarios.

Las 50 herramientas de cálculo de fecha y hora están disponibles como un servidor de Protocolo de Contexto de Modelo (MCP) independiente. Instale mediante npx -y @brainycalc/mcptimeserver para potenciar a los asistentes de IA (LM Studio, Claude Desktop) con operaciones temporales deterministas.

1. Núcleo y Formato

now

Obtiene la fecha y hora actuales, opcionalmente formateadas o ajustadas para una zona horaria objetivo.

herramienta coremcp

Parámetro	Tipo	Requerido	Descripción
format	string	opcional	Cadena de token de formato de salida (p. ej. YYYY-MM-DD HH:mm:ss)
timezone	string	opcional	Zona horaria IANA objetivo (p. ej. America/New_York)

{ "format": "YYYY-MM-DD HH:mm:ss", "timezone": "America/New_York" }

"2026-08-11 14:02:00"

Consultas de ejemplo para LLMs

• ¿Cuál es la fecha y hora actuales?
• ¿Cuál es la hora actual en Nueva York formateada como YYYY-MM-DD HH:mm:ss?
• Dame la fecha de hoy y la hora actual.

format_date

Formatea una fecha entrante en una cadena de token localizada personalizada.

herramienta formattingmcp

Parámetro	Tipo	Requerido	Descripción
date	string	requerido	Cadena de fecha o now
format	string	requerido	Patrón de formato (p. ej. dddd, MMMM D, YYYY)
inputFormat	string	opcional	Formato de análisis para entradas de fecha no estándar
timezone	string	opcional	Zona horaria IANA objetivo

{ "date": "2026-08-11T14:02:00Z", "format": "dddd, MMMM D, YYYY" }

"Tuesday, August 11, 2026"

Consultas de ejemplo para LLMs

• Muestra solo el mes de 2026-08-11.
• ¿Puedes reformatear '2026/08/11' a 'DD/MM/YYYY'?
• Muestra esta marca de tiempo en palabras completas: 2026-08-11.

parse_date

Descompone una cadena de fecha en componentes estructurados (año, mes, semana ISO, trimestre, Unix, etc.).

herramienta parsermcp

Parámetro	Tipo	Requerido	Descripción
date	string	requerido	Cadena de fecha a analizar
inputFormat	string	opcional	Formato de análisis para cadenas de entrada no estándar

{ "date": "2026-08-11" }

{
  "year": 2026,
  "month": 8,
  "day": 11,
  "dayOfWeek": 2,
  "dayOfWeekName": "Tuesday",
  "weekOfYear": 33,
  "quarter": 3,
  "unix": 1786406400,
  "iso": "2026-08-11T00:00:00.000Z"
}

Consultas de ejemplo para LLMs

• Desglosa '2026-08-11' en sus componentes de calendario.
• ¿Qué día de la semana y número de semana fue el 11 de agosto de 2026?
• Extrae el trimestre, el año y la semana ISO de '2026-08-11'.

adjust_time

Suma o resta unidades de tiempo especificadas a una fecha base.

herramienta mathmcp

Parámetro	Tipo	Requerido	Descripción
date	string	opcional	Fecha base o now
amount	number	requerido	Cantidad a desplazar
unit	string	requerido	Unidad (millisecond, second, minute, hour, day, week, month, quarter, year)
operation	enum	opcional	add o subtract (predeterminado: add)
format	string	opcional	Patrón de formato de salida

{ "date": "2026-08-11", "amount": 3, "unit": "months" }

"2026-11-11T00:00:00.000Z"

Consultas de ejemplo para LLMs

• ¿Qué fecha será 3 meses después del 11 de agosto de 2026?
• Resta 45 minutos a las 10:00 AM de hoy.
• Suma 3 semanas a 2026-08-11.

boundary_of

Obtiene el límite de inicio o fin de una unidad (año, trimestre, mes, semana, semana ISO, día, hora) para una fecha.

herramienta boundarymcp

Parámetro	Tipo	Requerido	Descripción
date	string	opcional	Fecha o now
unit	enum	requerido	year | quarter | month | week | isoWeek | day | hour | minute | second
edge	enum	opcional	start o end (predeterminado: start)
format	string	opcional	Cadena de formato de salida

{ "date": "2026-08-11", "unit": "month", "edge": "end" }

"2026-08-31T23:59:59.999Z"

Consultas de ejemplo para LLMs

• ¿Cuál es el final de agosto de 2026?
• ¿Cuándo termina la semana actual?.
• ¿Cuándo termina el tercer trimestre de 2026?

get_date_format

Resuelve términos de componentes de fecha en inglés ('month name', 'unix milliseconds') en tokens de formato o compone cadenas de formato.

herramienta utilitymcp

Parámetro	Tipo	Requerido	Descripción
part	string | array	requerido	Nombre(s) de parte en inglés simple o __list__
verbose	boolean	opcional	Devuelve descriptores completos (token, descripción, ejemplo)
compose	boolean	opcional	Une la matriz de partes en una cadena de formato lista
separator	string	opcional	Separador cuando compose es verdadero (predeterminado: '')

{ "part": ["full year", "month", "day"], "compose": true, "separator": "-" }

"YYYY-MM-DD"

Consultas de ejemplo para LLMs

• ¿Qué tokens de formato debo usar para 'year-month-day'?
• Compone una cadena de formato con año completo, nombre del mes y día.
• ¿Cuál es el token de formato para el nombre completo del mes?

format_standard

Formatea la fecha según especificaciones estandarizadas: ISO 8601, ISO 9075, RFC 3339 o RFC 7231 (HTTP).

herramienta standardmcp

Parámetro	Tipo	Requerido	Descripción
date	string	opcional	Fecha o now
standard	enum	opcional	iso | iso9075 | rfc3339 | rfc7231 (predeterminado: iso)
representation	enum	opcional	Para modo ISO: complete | date | time

{ "date": "2026-08-11T14:30:00Z", "standard": "rfc7231" }

"Tue, 11 Aug 2026 14:30:00 GMT"

Consultas de ejemplo para LLMs

• Formatea el 11 de agosto de 2026 al formato de fecha de cabecera HTTP RFC 7231.
• Convierte esta fecha al formato de cadena ISO 8601 estándar.
• Genera una marca de tiempo RFC 3339 para ahora mismo.

parse_strict

Analiza estrictamente entradas desde cadenas ISO, cadenas de fecha JSON, segundos Unix o milisegundos Unix.

herramienta parsermcp

Parámetro	Tipo	Requerido	Descripción
input	string | number	requerido	Valor a analizar
inputType	enum	opcional	iso | json | unix_s | unix_ms (predeterminado: iso)
format	string	opcional	Patrón de formato opcional para la cadena de salida

{ "input": 1786406400, "inputType": "unix_s" }

{
  "input": 1786406400,
  "inputType": "unix_s",
  "iso": "2026-08-11T00:00:00.000Z",
  "unix": 1786406400,
  "unixMs": 1786406400000
}

Consultas de ejemplo para LLMs

• Analiza esta marca de tiempo Unix 1786406400 en segundos a una fecha ISO.
• Analiza estrictamente "2026-08-11" y conviértelo a una marca de tiempo ISO.
• Convierte los milisegundos de época Unix 1786406400000 en una fecha legible para humanos.

to_representation

Convierte un objeto de fecha en representaciones alternativas: matriz, objeto, JSON, cadena UTC o cadena ISO.

herramienta conversionmcp

Parámetro	Tipo	Requerido	Descripción
date	string	opcional	Cadena de fecha o now
output	enum	requerido	array | object | json | utcString | isoString

{ "date": "2026-08-11", "output": "array" }

[2026, 7, 11, 0, 0, 0, 0]

Consultas de ejemplo para LLMs

• Convierte '2026-08-11' en una matriz de números de fecha.
• Exporta esta fecha como una representación de objeto de fecha JavaScript sin procesar.
• Dame '2026-08-11' como una cadena UTC.

utc_date

Analiza o convierte una fecha en modo UTC, preservando o convirtiendo los valores de hora local.

herramienta utcmcp

Parámetro	Tipo	Requerido	Descripción
date	string	opcional	Cadena de fecha o now
format	string	opcional	Patrón de formato de salida
keepLocalTime	boolean	opcional	Conserva los números de hora local al convertir a UTC

{ "date": "2026-08-11T12:00:00", "keepLocalTime": true }

"2026-08-11T12:00:00.000Z"

Consultas de ejemplo para LLMs

• Convierte la hora local 12:00 a UTC conservando los números de hora local.
• Obtén la representación de fecha UTC para el 11 de agosto de 2026.
• Analiza '2026-08-11T12:00:00' directamente en UTC.

2. Diferencia y Comparación

date_diff

Calcula diferencias exactas entre dos fechas (devuelve valor escalar o desglose detallado).

herramienta mathmcp

Parámetro	Tipo	Requerido	Descripción
date1	string	requerido	Primera fecha (formato ISO o now)
date2	string	requerido	Segunda fecha para comparar
unit	string	opcional	Unidad para diferencia escalar (omitir para desglose completo)
float	boolean	opcional	Devuelve diferencia escalar de punto flotante

{ "date1": "2026-08-11", "date2": "2026-12-25" }

{
  "date1": "2026-08-11",
  "date2": "2026-12-25",
  "days": 136,
  "weeks": 19.43,
  "months": 4.47,
  "years": 0.3723,
  "formatted": "19 weeks and 3 days"
}

Consultas de ejemplo para LLMs

• ¿Cuántos días hay entre el 11 de agosto de 2026 y el 25 de diciembre de 2026?
• Calcula la diferencia en semanas y días entre estas dos fechas.

calc_age

Calcula la edad exacta en años, meses, días, semanas totales y días totales en relación con la fecha objetivo.

herramienta humanmcp

Parámetro	Tipo	Requerido	Descripción
birthDate	string	requerido	Cadena de fecha de nacimiento (YYYY-MM-DD). Alias: birth_date
targetDate	string	opcional	Fecha de referencia de comparación (predeterminada: hoy). Alias: reference_date

{ "birthDate": "1995-05-15", "targetDate": "2026-08-11" }

{
  "birthDate": "1995-05-15",
  "years": 31,
  "months": 2,
  "days": 27,
  "totalDays": 11411,
  "totalWeeks": 1630,
  "formatted": "31 years, 2 months, 27 days"
}

Consultas de ejemplo para LLMs

• ¿Qué edad tiene alguien nacido el 15 de mayo de 1995 al 11 de agosto de 2026?
• Calcula la edad exacta en años, meses y días para el 15 de mayo de 1995.
• ¿Cuántas semanas totales tiene una persona nacida el 1995-05-15?

compare_dates

Evalúa predicados booleanos de comparación de fechas: isBefore, isAfter, isSame, isSameOrBefore, isSameOrAfter.

herramienta comparisonmcp

Parámetro	Tipo	Requerido	Descripción
date1	string	opcional	Primera fecha o now
date2	string	requerido	Segunda fecha para comparar
comparison	enum	requerido	isBefore | isAfter | isSame | isSameOrBefore | isSameOrAfter
unit	string	opcional	Granularidad de unidad de comparación (p. ej. month, day)

{ "date1": "2026-08-11", "date2": "2026-08-15", "comparison": "isBefore" }

true

Consultas de ejemplo para LLMs

• ¿Es el 11 de agosto de 2026 anterior al 15 de agosto de 2026?
• Comprueba si la fecha A es igual a la fecha B ignorando la hora.
• ¿Es 2026-08-11 posterior a 2026-08-01?

is_between

Comprueba si una fecha cae entre los límites de inicio y fin con opciones de inclusividad configurables.

herramienta comparisonmcp

Parámetro	Tipo	Requerido	Descripción
date	string	opcional	Fecha objetivo o now
start	string	requerido	Fecha de inicio del rango
end	string	requerido	Fecha de fin del rango
unit	string	opcional	Granularidad de unidad de comparación
inclusivity	enum	opcional	() | (] | [) | [] (predeterminado: ())

{ "date": "2026-08-11", "start": "2026-08-01", "end": "2026-08-31", "inclusivity": "[]" }

true

Consultas de ejemplo para LLMs

• ¿Está hoy entre 2025-01-01 y 2025-12-31?
• ¿Cae el 11 de agosto de 2026 dentro del rango del 1 al 31 de agosto de 2026?
• Comprueba si '2026-08-11' está estrictamente entre dos fechas límite.

date_compare

Ejecuta la matriz completa de comparación de fechas en todas las granularidades de unidad simultáneamente.

herramienta comparisonmcp

Parámetro	Tipo	Requerido	Descripción
date1	string	requerido	Primera cadena de fecha o now
date2	string	requerido	Segunda cadena de fecha o now

{ "date1": "2026-08-11", "date2": "2026-08-15" }

{
  "compareAsc": -1,
  "compareDesc": 1,
  "isSameDay": false,
  "isSameWeek": true,
  "isSameMonth": true,
  "isSameQuarter": true,
  "isSameYear": true
}

Consultas de ejemplo para LLMs

• Compara dos fechas en todas las unidades como misma semana, mismo mes, mismo año.
• ¿Están el 11 de agosto de 2026 y el 15 de agosto de 2026 en el mismo mes y semana?
• Obtén el desglose comparativo completo entre 2026-08-11 y 2026-08-15.

relative_time

Obtiene una expresión de tiempo relativo legible para humanos (p. ej. 'hace 3 días', 'en 2 meses').

herramienta relativemcp

Parámetro	Tipo	Requerido	Descripción
date	string	opcional	Fecha o now
relativeTo	string	opcional	Fecha de referencia en lugar de la hora actual
withoutSuffix	boolean	opcional	Omite el sufijo 'ago' / 'in'
direction	enum	opcional	from o to (predeterminado: from)

{ "date": "2026-08-01", "relativeTo": "2026-08-11" }

"10 days ago"

Consultas de ejemplo para LLMs

• ¿Hace cuánto fue el 1 de agosto de 2026 en comparación con el 11 de agosto de 2026?
• Formatea el 1 de agosto de 2026 como tiempo relativo (p. ej. 'hace 10 días').
• Expresa la diferencia de fechas de forma legible sin sufijos.

intl_format_distance Formato de tiempo relativo sensible a la configuración regional utilizando el estándar Intl.RelativeTimeFormat.

Herramienta i18nmcp

Parámetro	Tipo	Obligatorio	Descripción
date	string	opcional	Fecha objetivo (por defecto: ahora)
baseDate	string	opcional	Fecha de comparación de referencia (por defecto: ahora)
locale	string	opcional	Etiqueta de configuración regional BCP 47 (p. ej., en, fr, es)
numeric	enum	opcional	auto o always
style	enum	opcional	long | short | narrow
unit	string	opcional	Unidad explícita (segundo, minuto, hora, día, semana, mes, año)

{ "date": "2026-08-14", "baseDate": "2026-08-11", "locale": "es" }

{
  "formatted": "dentro de 3 días",
  "unit": "day",
  "value": 3,
  "locale": "es"
}

Consultas de ejemplo para LLMs

• Mostrar la distancia de tiempo relativo en español ('dentro de 3 días') para el 14 de agosto.
• Obtener la distancia de tiempo relativo localizada entre el 11 de agosto y el 14 de agosto de 2026.

closest_date

Encuentra qué fecha en un arreglo de candidatas está más cerca de una fecha de referencia.

Herramienta searchmcp

Parámetro	Tipo	Obligatorio	Descripción
date	string	opcional	Fecha de referencia (por defecto: ahora)
dates	array	obligatorio	Arreglo de cadenas de fecha candidatas
format	string	opcional	Cadena de formato de salida

{
  "date": "2026-08-11",
  "dates": ["2026-01-01", "2026-08-10", "2026-12-31"]
}

{
  "closestIndex": 1,
  "closestDate": "2026-08-10T00:00:00.000Z",
  "diffMs": 86400000
}

Consultas de ejemplo para LLMs

• ¿Qué fecha en esta lista [2026-01-01, 2026-08-10, 2026-12-31] está más cerca del 11 de agosto de 2026?

interval_overlap

Determina si dos intervalos de fecha se superponen y calcula el número de días de superposición.

Herramienta intervalmcp

Parámetro	Tipo	Obligatorio	Descripción
start1	string	obligatorio	Inicio del intervalo 1
end1	string	obligatorio	Fin del intervalo 1
start2	string	obligatorio	Inicio del intervalo 2
end2	string	obligatorio	Fin del intervalo 2
inclusive	boolean	opcional	Incluir el contacto de límites como superposición
mode	enum	opcional	overlapping o days

{
  "start1": "2026-08-01", "end1": "2026-08-15",
  "start2": "2026-08-10", "end2": "2026-08-20",
  "mode": "days"
}

{
  "overlaps": true,
  "overlapDays": 5,
  "overlapStart": "2026-08-10T00:00:00.000Z",
  "overlapEnd": "2026-08-15T00:00:00.000Z"
}

Consultas de ejemplo para LLMs

• ¿Se superponen los rangos de fecha del 1 al 15 de agosto y del 10 al 20 de agosto?
• Calcular cuántos días se superponen entre dos horarios de eventos.
• Verificar si el intervalo 2026-08-01 a 2026-08-15 se cruza con 2026-08-10 a 2026-08-20.

3. Negocios y Calendario

business_days

Cuenta días laborables (lunes a viernes) entre fechas o suma/resta días laborables desde una fecha de inicio.

Herramienta businessmcp

Parámetro	Tipo	Obligatorio	Descripción
mode	enum	opcional	diff | add | subtract (por defecto: diff)
startDate	string	opcional	Cadena de fecha de inicio
endDate	string	opcional	Fecha de fin (para modo diff)
amount	number	opcional	Número de días laborables (para add / subtract)
format	string	opcional	Patrón de formato de salida

{ "mode": "add", "startDate": "2026-08-07", "amount": 5 }

{
  "original": "2026-08-07",
  "amount": 5,
  "result": "2026-08-14"
}

Consultas de ejemplo para LLMs

• Sumar 5 días laborables al viernes 7 de agosto de 2026.
• ¿Cuántos días laborables hay entre el 1 de agosto y el 15 de agosto de 2026?
• Restar 10 días laborables al 11 de agosto de 2026.

work_days

Calcula días laborables entre dos fechas con indicadores opcionales de inclusión de fines de semana.

Herramienta workmcp

Parámetro	Tipo	Obligatorio	Descripción
startDate	string	obligatorio	Fecha de inicio (AAAA-MM-DD)
endDate	string	obligatorio	Fecha de fin (AAAA-MM-DD)
includeWeekends	boolean	opcional	Incluir sábado y domingo (por defecto: false)

{ "startDate": "2026-08-01", "endDate": "2026-08-11" }

{
  "startDate": "2026-08-01",
  "endDate": "2026-08-11",
  "workDaysCount": 7,
  "weekendsIncluded": false
}

Consultas de ejemplo para LLMs

• Contar el total de días laborables entre 2026-08-01 y 2026-08-11.
• ¿Cuántos días excluyendo fines de semana hay en la primera mitad de agosto de 2026?

calendar_month

Genera una matriz de calendario mensual completa estructurada en arreglos semanales para interfaces de calendario.

Herramienta calendarmcp

Parámetro	Tipo	Obligatorio	Descripción
date	string	opcional	Fecha de referencia en el mes objetivo
weekStart	enum	opcional	0 (domingo) o 1 (lunes)
format	string	opcional	Patrón de formato de salida de fecha

{ "date": "2026-08-01", "weekStart": 1 }

{
  "month": "August 2026",
  "year": 2026,
  "daysInMonth": 31,
  "weeks": [ /* Arrays containing week objects */ ]
}

Consultas de ejemplo para LLMs

• Generar una matriz de calendario mensual completa para agosto de 2026 comenzando en lunes.
• Obtener todas las semanas y fechas de agosto de 2026 estructuradas para un diseño de calendario de interfaz.
• Construir una cuadrícula de vista de calendario mensual para agosto de 2026.

each_weekend_of

Obtiene un arreglo de todas las fechas de fin de semana (sábado y domingo) dentro de un intervalo, mes o año especificado.

Herramienta calendarmcp

Parámetro	Tipo	Obligatorio	Descripción
mode	enum	opcional	interval | month | year (por defecto: interval)
date	string	opcional	Fecha de referencia para modo month o year
start	string	opcional	Fecha de inicio para modo interval
end	string	opcional	Fecha de fin para modo interval

{ "mode": "month", "date": "2026-08-01" }

{
  "mode": "month",
  "count": 10,
  "weekends": ["2026-08-01", "2026-08-02", "2026-08-08", "..."]
}

Consultas de ejemplo para LLMs

• Listar todas las fechas de fin de semana (sábados y domingos) en agosto de 2026.
• Obtener cada fecha de fin de semana en el año 2026.
• Encontrar todas las fechas de fin de semana entre el 1 de agosto y el 31 de agosto de 2026.

day_of_week

Obtiene el nombre del día, nombre del mes, año, indicador de fin de semana, día del año y número de semana para cualquier fecha.

Herramienta metadatamcp

Parámetro	Tipo	Obligatorio	Descripción
date	string	obligatorio	Cadena de fecha (AAAA-MM-DD)

{ "date": "2026-08-11" }

{
  "date": "2026-08-11",
  "dayName": "Tuesday",
  "month": "August",
  "dayNumber": 11,
  "year": 2026,
  "isWeekend": false,
  "dayOfYear": 223,
  "weekNumber": 2
}

Consultas de ejemplo para LLMs

• ¿Qué día de la semana es el 11 de agosto de 2026?
• ¿Es el 11 de agosto de 2026 un fin de semana o un día laborable?
• ¿Cuál es el número de día del año para el 11 de agosto de 2026?

last_day_of

Devuelve el último día de un período (mes, año, trimestre, semana, isoWeek, década).

Herramienta boundarymcp

Parámetro	Tipo	Obligatorio	Descripción
date	string	opcional	Fecha de referencia o now
unit	enum	obligatorio	month | year | quarter | week | isoWeek | isoWyear | decade
format	string	opcional	Patrón de formato de salida

{ "date": "2026-08-11", "unit": "quarter" }

{
  "input": "2026-08-11",
  "unit": "quarter",
  "lastDay": "2026-09-30"
}

Consultas de ejemplo para LLMs

• ¿Cuál es el último día del tercer trimestre de 2026?
• Encontrar el último día del mes para agosto de 2026.
• ¿Cuál es el último día de la década para 2026-08-11?

countdown

Genera desgloses estructurados de tiempo restante o tiempo transcurrido en relación con una marca de tiempo objetivo.

Herramienta timermcp

Parámetro	Tipo	Obligatorio	Descripción
date	string	obligatorio	Fecha objetivo o marca de tiempo
format	string	opcional	Cadena de formato para la salida de la fecha objetivo

{ "date": "2027-01-01T00:00:00Z" }

{
  "target": "2027-01-01T00:00:00.000Z",
  "isFuture": true,
  "breakdown": {
    "days": 142,
    "hours": 9,
    "minutes": 58,
    "seconds": 0
  },
  "formatted": "142d 9h 58m 0s"
}

Consultas de ejemplo para LLMs

• ¿Cuántos días, horas y minutos quedan hasta el Año Nuevo 2027?
• Generar un desglose de cuenta regresiva en vivo hasta 2027-01-01T00:00:00Z.
• ¿Cuánto tiempo queda hasta la medianoche del 1 de enero de 2027?

4. Zonas Horarias y Reloj Mundial

convert_timezone

Proyecta marcas de tiempo a través de zonas horarias IANA mundiales manejando transiciones de horario de verano sin problemas.

Herramienta timezonesmcp

Parámetro	Tipo	Obligatorio	Descripción
date	string	opcional	Cadena de fecha o now
fromTimezone	string	opcional	Zona horaria IANA de origen (p. ej., UTC)
toTimezone	string	obligatorio	Zona horaria IANA de destino (p. ej., Asia/Tokyo)
format	string	opcional	Patrón de formato de salida

{
  "date": "2026-08-11T12:00:00",
  "fromTimezone": "UTC",
  "toTimezone": "Asia/Tokyo"
}

"2026-08-11T21:00:00+09:00"

Consultas de ejemplo para LLMs

• ¿Qué hora es a las 12:00 PM UTC en Tokio (Asia/Tokyo)?
• Convertir 2026-08-11 14:00 de America/New_York a Europe/London.
• Proyectar una marca de tiempo UTC a la hora local de Tokio.

local_time

Obtiene la hora local actual, fecha, nombre de zona horaria y desplazamiento para el entorno de ejecución.

Herramienta systemmcp

No toma parámetros obligatorios. Inspecciona el reloj del entorno del sistema local y la configuración regional.

{}

{
  "local_time": "15:28:00",
  "local_date": "Tuesday, August 11, 2026",
  "timezone": "America/New_York",
  "timezone_offset_mins": 240
}

Consultas de ejemplo para LLMs

• ¿Cuál es la hora local, fecha y desplazamiento de zona horaria de mi sistema?
• Mostrar la hora local actual y la zona horaria para este servidor.
• Obtener el reloj del sistema local y el desplazamiento UTC en minutos.

world_time

Consulta la hora local activa, banderas de países y desplazamientos en ciudades principales o regiones mundiales.

Herramienta worldmcp

Parámetro	Tipo	Obligatorio	Descripción
query	string	opcional	Nombre de ciudad o país (p. ej., Tokyo, Germany)
region	enum	opcional	Región de filtro (All | Africa | Americas | Asia | Europe | Oceania)
timezone	string	opcional	Cadena de zona horaria IANA directa
offset_hours	number	opcional	Respaldo de horas de desplazamiento UTC

{ "query": "Tokyo" }

{
  "query": "Tokyo",
  "match_count": 1,
  "results": [
    {
      "flag": "🇯🇵",
      "country": "Japan",
      "city": "Tokyo",
      "timezone": "Asia/Tokyo",
      "time": "23:02:00",
      "offset_string": "GMT+9"
    }
  ]
}

Consultas de ejemplo para LLMs

• ¿Qué hora es en Japón ahora mismo?
• Mostrar la hora actual y el desplazamiento GMT para Tokio.
• Buscar la hora local para ciudades principales en Europa.

time_duration

Calcula la duración entre dos cadenas de hora de reloj de pared (HH:MM o HH:MM:SS), manejando cambios nocturnos automáticamente.

Herramienta timemcp

Parámetro	Tipo	Obligatorio	Descripción
start	string	obligatorio	Hora de inicio (p. ej., 22:00)
end	string	obligatorio	Hora de fin (p. ej., 06:30)

{ "start": "22:00", "end": "06:30" }

{
  "start": "22:00",
  "end": "06:30",
  "hours": 8,
  "minutes": 30,
  "total_seconds": 30600,
  "display": "8h 30m 0s"
}

Consultas de ejemplo para LLMs

• ¿Cuántas horas y minutos pasaron entre las 10:00 PM y las 6:30 AM de la mañana siguiente?
• Calcular la duración entre la hora de inicio 09:00 y la hora de fin 17:30.
• ¿Cuál es la diferencia de tiempo en horas entre las 22:00 y las 06:30?

5. Intervalos y Duraciones

each_of_interval

Genera un arreglo de fechas/horas de paso a través de un límite de intervalo.

Herramienta generatormcp

Parámetro	Tipo	Obligatorio	Descripción
start	string	obligatorio	Cadena ISO de inicio del intervalo
end	string	obligatorio	Cadena ISO de fin del intervalo
unit	enum	opcional	day | hour | minute | month | quarter | week | year (por defecto: day)
step	number	opcional	Tamaño de incremento de paso (por defecto: 1)
format	string	opcional	Patrón de formato de salida

{ "start": "2026-08-01", "end": "2026-08-03", "unit": "day" }

{
  "count": 3,
  "dates": [
    "2026-08-01T00:00:00.000Z",
    "2026-08-02T00:00:00.000Z",
    "2026-08-03T00:00:00.000Z"
  ]
}

Consultas de ejemplo para LLMs

• Listar cada fecha de paso diario entre el 1 de agosto de 2026 y el 3 de agosto de 2026.
• Generar intervalos por hora entre 2026-08-01T00:00 y 2026-08-01T12:00.
• Crear un arreglo de fechas semanales a lo largo de agosto de 2026.

duration

Crea e inspecciona duraciones a partir de cadenas ISO, números de milisegundos o descriptores de objeto de unidad.

Herramienta durationmcp

Parámetro	Tipo	Obligatorio	Descripción
input	string | number | object	obligatorio	Cadena ISO 8601 (P1Y2M), número de ms u objeto de unidad
unit	string	opcional	Unidad cuando la entrada es un número escalar
outputFormat	enum	opcional	iso | humanize | milliseconds | object

{ "input": "P1Y2M3D", "outputFormat": "object" }

{
  "years": 1,
  "months": 2,
  "days": 3,
  "hours": 0,
  "minutes": 0,
  "totalMilliseconds": 36979200000
}

Consultas de ejemplo para LLMs

• Analizar la duración ISO 'P1Y2M3D' en años, meses y días estructurados.
• Convertir 36979200000 milisegundos en una duración legible para humanos.
• Crear un objeto de duración a partir de 2 horas y 30 minutos.

interval_to_duration

Convierte fechas de inicio y fin en un objeto de duración estructurado desglosado en años, meses, días, etc.

Herramienta durationmcp

Parámetro	Tipo	Obligatorio	Descripción
start	string	obligatorio	Cadena ISO de inicio del intervalo
end	string	obligatorio	Cadena ISO de fin del intervalo

{ "start": "2025-01-01", "end": "2026-08-11" }

{
  "years": 1,
  "months": 7,
  "days": 10,
  "humanized": "a year"
}

Consultas de ejemplo para LLMs

• Convertir el intervalo de 2025-01-01 a 2026-08-11 en años, meses y días.
• ¿Cuántos años y meses hay entre dos fechas específicas?
• Obtener un desglose estructurado de la duración entre la fecha de inicio y la fecha de fin. format_duration_string

Construye una cadena de texto en inglés formateada a partir de números de componentes de duración.

herramienta durationmcp

Parámetro	Tipo	Requerido	Descripción
years, months, weeks, days, hours, minutes, seconds	number	opcional	Partes numéricas individuales de duración
format	array	opcional	Limitar unidades mostradas (p. ej. ["hours", "minutes"])
delimiter	string	opcional	Separador de unidades (predeterminado: , )
zero	boolean	opcional	Incluir unidades con valor cero (predeterminado: false)

{ "hours": 2, "minutes": 30 }

{
  "formatted": "2 hours, 30 minutes",
  "humanized": "in 3 hours",
  "iso": "PT2H30M"
}

Consultas de muestra para LLMs

• Formatear 90 minutos como horas, minutos.
• Convertir partes de duración (2 horas, 30 minutos) en una cadena ISO o frase en inglés.

parse_iso_duration

Analiza una cadena de duración ISO 8601 (p. ej. 'P1Y2M3DT4H') en un objeto con todos los componentes.

herramienta durationmcp

Parámetro	Tipo	Requerido	Descripción
iso	string	requerido	Cadena de duración ISO 8601 (p. ej. P1Y6M, PT2H30M)

{ "iso": "PT2H30M" }

{
  "hours": 2,
  "minutes": 30,
  "seconds": 0,
  "totalMilliseconds": 9000000,
  "humanized": "in 3 hours"
}

Consultas de muestra para LLMs

• Analizar la cadena de duración ISO 8601 'PT2H30M'.
• Extraer horas, minutos y milisegundos totales de 'P1Y6M'.
• Decodificar la duración ISO 'PT1H45M' en un objeto de componentes estándar.

clamp_date

Limita una fecha dentro de los límites de un intervalo de inicio y fin.

herramienta mathmcp

Parámetro	Tipo	Requerido	Descripción
date	string	opcional	Fecha a limitar (predeterminado: ahora)
start	string	requerido	Fecha límite inferior
end	string	requerido	Fecha límite superior
format	string	opcional	Patrón de formato de salida

{ "date": "2026-12-31", "start": "2026-01-01", "end": "2026-08-31" }

{
  "clamped": "2026-08-31T00:00:00.000Z",
  "wasClamped": true
}

Consultas de muestra para LLMs

• Limitar '2026-12-31' dentro de los límites '2026-01-01' y '2026-08-31'.
• Asegurar que la fecha no exceda la fecha límite máxima permitida del 31 de agosto de 2026.
• Verificar si la fecha fue limitada al restringirse entre los límites del rango.

round_to_nearest

Redondea fecha/hora al N minutos o N horas más cercano usando redondeo hacia abajo, hacia arriba o estándar.

herramienta mathmcp

Parámetro	Tipo	Requerido	Descripción
date	string	opcional	Fecha objetivo o now
unit	enum	opcional	minutes o hours (predeterminado: minutes)
nearestTo	number	opcional	Incremento de paso (p. ej. 15 para cuarto de hora)
roundingMethod	enum	opcional	round | floor | ceil

{ "date": "2026-08-11T14:23:00Z", "nearestTo": 15 }

{
  "result": "2026-08-11T14:30:00.000Z"
}

Consultas de muestra para LLMs

• Redondear 14:23:00 a los 15 minutos más cercanos.
• Redondear hacia abajo la hora actual al intervalo de 30 minutos más cercano.

6. Componentes y Setters

date_part

Extrae una parte específica de la fecha: semana, isoWeek, isoWeekday, trimestre, díaDelAño o díaDeLaSemana.

herramienta componentmcp

Parámetro	Tipo	Requerido	Descripción
date	string	opcional	Fecha o now
part	enum	requerido	week | isoWeek | isoWeekday | quarter | dayOfYear | weekday

{ "date": "2026-08-11", "part": "dayOfYear" }

223

Consultas de muestra para LLMs

• Obtener el número del día del año para el 11 de agosto de 2026.
• ¿En qué trimestre del año está el 11 de agosto?
• Extraer el número de semana ISO para 2026-08-11.

date_components_all

Recupera todos los componentes numéricos y de calendario a la vez (año, mes, fecha, hora, semana ISO, trimestre, Unix, década, etc.).

herramienta componentmcp

Parámetro	Tipo	Requerido	Descripción
date	string	opcional	Cadena de fecha o now

{ "date": "2026-08-11" }

{
  "year": 2026,
  "month": 8,
  "date_": 11,
  "dayOfWeek": 2,
  "isoDay": 2,
  "dayOfYear": 223,
  "daysInMonth": 31,
  "quarter": 3,
  "unix": 1786406400
}

Consultas de muestra para LLMs

• Recuperar todos los componentes (año, mes, fecha, trimestre, día del año) para el 11 de agosto de 2026.
• Obtener el desglose completo numérico y de texto de la fecha para 2026-08-11.
• Mostrar todos los valores temporales para la fecha actual.

set_components

Establece componentes numéricos específicos de fecha/hora en una fecha base y devuelve la marca de tiempo resultante.

herramienta settermcp

Parámetro	Tipo	Requerido	Descripción
date	string	opcional	Fecha base o now
year, month, day, hour, minute, second, millisecond	number	opcional	Valores de campo específicos a modificar
dayOfYear, quarter, week, isoWeek, isoDay, isoWeekYear, weekYear	number	opcional	Modificaciones de campo de calendario

{ "date": "2026-08-11", "month": 12, "day": 25 }

{
  "original": "2026-08-11T00:00:00.000Z",
  "result": "2026-12-25T00:00:00.000Z"
}

Consultas de muestra para LLMs

• Establecer mes a diciembre y día a 25 en la fecha '2026-08-11'.
• Modificar el año a 2028 para la fecha '2026-08-11'.
• Establecer la hora a 15:30:00 el 11 de agosto de 2026.

days_in_month

Devuelve el número total de días en el mes para una fecha dada.

herramienta calendarmcp

Parámetro	Tipo	Requerido	Descripción
date	string	opcional	Cadena de fecha o now

{ "date": "2024-02-15" }

29

Consultas de muestra para LLMs

• ¿Cuántos días tiene febrero de 2024?
• ¿Cuál es el recuento total de días en agosto de 2026?
• Verificar cuántos días tiene el mes para '2026-02-15'.

convert_units

Convierte un valor numérico entre unidades de tiempo (segundos, minutos, horas, días, semanas, meses, años).

herramienta conversionmcp

Parámetro	Tipo	Requerido	Descripción
value	number	requerido	Cantidad numérica a convertir
from	string	requerido	Unidad de origen (p. ej. hours, days)
to	string	requerido	Unidad de destino (p. ej. minutes, weeks)

{ "value": 36, "from": "hours", "to": "days" }

{
  "value": 36,
  "from": "hours",
  "to": "days",
  "result": 1.5
}

Consultas de muestra para LLMs

• Convertir 36 horas en días.
• ¿Cuántos minutos hay en 2.5 horas?
• Convertir 14 días en semanas.

time_add

Suma o resta horas, minutos y/o segundos a una cadena de hora de reloj de pared.

herramienta timemcp

Parámetro	Tipo	Requerido	Descripción
time	string	requerido	Hora base de reloj de pared (p. ej. 14:30:00)
add_hours	number	opcional	Horas a sumar (negativo para restar)
add_minutes	number	opcional	Minutos a sumar
add_seconds	number	opcional	Segundos a sumar

{ "time": "14:30:00", "add_minutes": 45 }

{
  "original": "14:30:00",
  "result": "15:15:00"
}

Consultas de muestra para LLMs

• Sumar 45 minutos a 14:30:00.
• Restar 2 horas de la hora de pared 01:15:00.
• Sumar 3 horas y 15 minutos a 09:00:00.

7. Validación y Predicados

is_valid

Verifica si una cadena de fecha representa una fecha de calendario válida y analizable.

herramienta validationmcp

Parámetro	Tipo	Requerido	Descripción
date	string	requerido	Cadena de fecha a validar
inputFormat	string	opcional	Patrón de formato de análisis esperado

{ "date": "2026-02-31" }

false

Consultas de muestra para LLMs

• ¿Es '2026-02-31' una fecha de calendario válida?
• Verificar si la cadena '2026-08-11' es una fecha válida.
• Validar si '2025-13-40' puede analizarse como una fecha real.

date_predicate

Prueba predicados booleanos específicos en una fecha: isLeapYear, isToday, isTomorrow, isYesterday.

herramienta predicatemcp

Parámetro	Tipo	Requerido	Descripción
date	string	opcional	Cadena de fecha objetivo o now
predicate	enum	requerido	isLeapYear | isToday | isTomorrow | isYesterday

{ "date": "2024-08-11", "predicate": "isLeapYear" }

true

Consultas de muestra para LLMs

• ¿Es 2024 un año bisiesto?
• ¿Es el 11 de agosto de 2026 hoy?
• Verificar si '2026-08-10' es ayer.

date_predicates

Ejecuta todos los predicados booleanos de calendario y temporales simultáneamente para una fecha.

herramienta predicatemcp

Parámetro	Tipo	Requerido	Descripción
date	string	opcional	Fecha objetivo o now

{ "date": "2026-08-11" }

{
  "isTuesday": true,
  "isWeekend": false,
  "isWeekday": true,
  "isLeapYear": false,
  "isThisMonth": true,
  "isThisYear": true
}

Consultas de muestra para LLMs

• Verificar todas las banderas booleanas (isTuesday, isWeekend, isLeapYear, isThisMonth) para el 11 de agosto de 2026.
• Ejecutar todos los predicados de calendario en '2026-08-11'.
• ¿Es 2026-08-11 un día laborable, fin de semana o año bisiesto?

unix_convert

Convierte entre cadenas de fecha y marcas de tiempo Unix (segundos y milisegundos).

herramienta conversionmcp

Parámetro	Tipo	Requerido	Descripción
date	string	opcional	Cadena de fecha (para modo to_unix)
fromUnix	number	opcional	Marca de tiempo Unix en segundos (conversión abreviada)
mode	enum	opcional	to_unix o from_unix (predeterminado: to_unix)

{ "fromUnix": 1786406400 }

"2026-08-11T00:00:00.000Z"

Consultas de muestra para LLMs

• Convertir la marca de tiempo Unix 1786406400 a una cadena de fecha ISO.
• Obtener la marca de tiempo de época Unix en segundos para '2026-08-11'.
• Convertir 1786406400 segundos en fecha UTC estándar.

min_max

Encuentra la fecha más temprana (mín) o más reciente (máx) de un arreglo de cadenas de fecha.

herramienta searchmcp

Parámetro	Tipo	Requerido	Descripción
dates	array	requerido	Arreglo de cadenas de fecha candidatas
operation	enum	requerido	min (más temprana) o max (más reciente)
format	string	opcional	Patrón de formato de salida

{
  "dates": ["2026-01-01", "2026-08-11", "2026-12-25"],
  "operation": "max"
}

"2026-12-25T00:00:00.000Z"

Consultas de muestra para LLMs

• Encontrar la fecha más reciente entre ['2026-01-01', '2026-08-11', '2026-12-25'].
• ¿Qué fecha es la más temprana en este arreglo de cadenas de fecha?
• Obtener la fecha máxima (más reciente) de mi lista de hitos de proyecto.

locale_data

Recupera arreglos de metadatos de configuración regional (meses, meses abreviados, nombres de días de la semana, primer día de la semana).

herramienta i18nmcp

Parámetro	Tipo	Requerido	Descripción
part	enum	requerido	months | monthsShort | weekdays | weekdaysShort | weekdaysMin | firstDayOfWeek
locale	string	opcional	Código de configuración regional objetivo (predeterminado: en)

{ "part": "months" }

[
  "January", "February", "March", "April", "May", "June",
  "July", "August", "September", "October", "November", "December"
]

Consultas de muestra para LLMs

• Obtener arreglo de nombres completos de meses en inglés.
• Obtener nombres abreviados de días de la semana para la configuración regional en inglés.
• ¿Cuál es el primer día de la semana en los datos de configuración regional en inglés?

next_prev_weekday

Encuentra la siguiente o anterior aparición de un día de la semana específico relativo a una fecha de inicio.

herramienta calendarmcp

Parámetro	Tipo	Requerido	Descripción
date	string	opcional	Fecha de referencia de inicio (predeterminado: ahora)
weekday	string | number	requerido	Día objetivo: 0–6 o nombre del día de la semana (monday, friday)
direction	enum	opcional	next o previous (predeterminado: next)
format	string	opcional	Patrón de formato de salida

{ "date": "2026-08-11", "weekday": "friday", "direction": "next" }

{
  "from": "2026-08-11",
  "direction": "next",
  "weekdayRequested": "friday",
  "result": "2026-08-14"
}

Consultas de muestra para LLMs

• ¿Cuándo es el próximo viernes relativo al 11 de agosto de 2026?
• Encontrar el lunes anterior al 11 de agosto de 2026.
• ¿Qué fecha será el próximo domingo?