MCP Time Server

Motor de cálculo temporal de alta precisão que suporta análise ISO 8601, conversões de fuso horário, dias úteis, matemática de duração, formatação de tempo relativo e geração completa de calendário.

Ver em brainycalc.com

Documentação

BrainyCalc Docs — MCP Date & Time Tools

MCP Date & Time Tools

Motor de cálculo temporal de alta precisão com suporte a parsing ISO 8601, conversões de fuso horário, dias úteis, operações com durações, formatação de tempo relativo e geração completa de calendários.

Todas as 50 ferramentas de cálculo de data e hora estão disponíveis como um servidor Model Context Protocol (MCP) independente. Instale via npx -y @brainycalc/mcptimeserver para capacitar assistentes de IA (LM Studio, Claude Desktop) com operações temporais determinísticas.

1. Núcleo e Formatação

now

Obtenha data e hora atuais, opcionalmente formatadas ou ajustadas para um fuso horário de destino.

ferramenta coremcp

Parâmetro	Tipo	Obrigatório	Descrição
`format`	string	opcional	String de token de formato de saída (ex.: `YYYY-MM-DD HH:mm:ss`)
`timezone`	string	opcional	Fuso horário IANA de destino (ex.: `America/New_York`)

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

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

Exemplos de Consultas para LLMs

Qual é a data e hora atuais?
Qual é a hora agora em Nova York formatada como YYYY-MM-DD HH:mm:ss?
Me dê a data de hoje e a hora atual.

format_date

Formate uma data recebida em uma string de token localizada personalizada.

ferramenta formattingmcp

Parâmetro	Tipo	Obrigatório	Descrição
`date`	string	obrigatório	String de data ou `now`
`format`	string	obrigatório	Padrão de formato (ex.: `dddd, MMMM D, YYYY`)
`inputFormat`	string	opcional	Formato de parsing para entradas de data não padronizadas
`timezone`	string	opcional	Fuso horário IANA de destino

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

"Tuesday, August 11, 2026"

Exemplos de Consultas para LLMs

Mostre apenas o mês de 2026-08-11.
Você pode reformatar '2026/08/11' para 'DD/MM/YYYY'?
Exiba este timestamp por extenso: 2026-08-11.

parse_date

Decomponha uma string de data em componentes estruturados (ano, mês, semana ISO, trimestre, Unix, etc.).

ferramenta parsermcp

Parâmetro	Tipo	Obrigatório	Descrição
`date`	string	obrigatório	String de data para fazer parsing
`inputFormat`	string	opcional	Formato de parsing para strings de entrada não padronizadas

{ "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"
}

Exemplos de Consultas para LLMs

Decomponha '2026-08-11' em seus componentes de calendário.
Qual dia da semana e número da semana era 11 de agosto de 2026?
Extraia o trimestre, o ano e a semana ISO de '2026-08-11'.

adjust_time

Adicione ou subtraia unidades de tempo especificadas de uma data base.

ferramenta mathmcp

Parâmetro	Tipo	Obrigatório	Descrição
`date`	string	opcional	Data base ou `now`
`amount`	number	obrigatório	Quantidade para deslocar
`unit`	string	obrigatório	Unidade (`millisecond`, `second`, `minute`, `hour`, `day`, `week`, `month`, `quarter`, `year`)
`operation`	enum	opcional	`add` ou `subtract` (padrão: `add`)
`format`	string	opcional	Padrão de formato de saída

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

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

Exemplos de Consultas para LLMs

Qual será a data daqui a 3 meses a partir de 11 de agosto de 2026?
Subtraia 45 minutos das 10:00 de hoje.
Adicione 3 semanas a 2026-08-11.

boundary_of

Obtenha o limite inicial ou final de uma unidade (ano, trimestre, mês, semana, semana ISO, dia, hora) para uma data.

ferramenta boundarymcp

Parâmetro	Tipo	Obrigatório	Descrição
`date`	string	opcional	Data ou `now`
`unit`	enum	obrigatório	`year` \| `quarter` \| `month` \| `week` \| `isoWeek` \| `day` \| `hour` \| `minute` \| `second`
`edge`	enum	opcional	`start` ou `end` (padrão: `start`)
`format`	string	opcional	String de formato de saída

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

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

Exemplos de Consultas para LLMs

Qual é o fim de agosto de 2026?
Quando termina a semana atual?
Quando termina o 3º trimestre de 2026?

get_date_format

Resolva termos de componentes de data em inglês ('nome do mês', 'milissegundos Unix') em tokens de formato ou componha strings de formato.

ferramenta utilitymcp

Parâmetro	Tipo	Obrigatório	Descrição
`part`	string \| array	obrigatório	Nome(s) de parte em inglês simples ou `__list__`
`verbose`	boolean	opcional	Retornar descritores completos (token, descrição, exemplo)
`compose`	boolean	opcional	Unir array de partes em uma string de formato pronta
`separator`	string	opcional	Separador quando compose for verdadeiro (padrão: '')

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

"YYYY-MM-DD"

Exemplos de Consultas para LLMs

Quais tokens de formato devo usar para 'ano-mês-dia'?
Componha uma string de formato com ano completo, nome do mês e dia.
Qual é o token de formatação para nome completo do mês?

format_standard

Formate a data de acordo com especificações padronizadas: ISO 8601, ISO 9075, RFC 3339 ou RFC 7231 (HTTP).

ferramenta standardmcp

Parâmetro	Tipo	Obrigatório	Descrição
`date`	string	opcional	Data ou `now`
`standard`	enum	opcional	`iso` \| `iso9075` \| `rfc3339` \| `rfc7231` (padrão: `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"

Exemplos de Consultas para LLMs

Formate 11 de agosto de 2026 no formato de data de cabeçalho HTTP RFC 7231.
Converta esta data em string de formato padrão ISO 8601.
Gere um timestamp RFC 3339 para agora.

parse_strict

Faça parsing estrito de entradas de strings ISO, strings de data JSON, segundos Unix ou milissegundos Unix.

ferramenta parsermcp

Parâmetro	Tipo	Obrigatório	Descrição
`input`	string \| number	obrigatório	Valor para fazer parsing
`inputType`	enum	opcional	`iso` \| `json` \| `unix_s` \| `unix_ms` (padrão: `iso`)
`format`	string	opcional	Padrão de formato opcional para string de saída

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

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

Exemplos de Consultas para LLMs

Faça parsing deste timestamp Unix 1786406400 em segundos para uma data ISO.
Faça parsing estrito de "2026-08-11" e converta-o em um timestamp ISO.
Converta milissegundos de época Unix 1786406400000 em uma data legível por humanos.

to_representation

Converta um objeto de data em representações alternativas: array, objeto, JSON, string UTC ou string ISO.

ferramenta conversionmcp

Parâmetro	Tipo	Obrigatório	Descrição
`date`	string	opcional	String de data ou `now`
`output`	enum	obrigatório	`array` \| `object` \| `json` \| `utcString` \| `isoString`

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

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

Exemplos de Consultas para LLMs

Converta '2026-08-11' em um array de números de data.
Exporte esta data como uma representação bruta de objeto de data JavaScript.
Me dê '2026-08-11' como uma string UTC.

utc_date

Faça parsing ou converta uma data em modo UTC, preservando ou convertendo valores de relógio local.

ferramenta utcmcp

Parâmetro	Tipo	Obrigatório	Descrição
`date`	string	opcional	String de data ou `now`
`format`	string	opcional	Padrão de formato de saída
`keepLocalTime`	boolean	opcional	Manter números de hora local ao converter para UTC

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

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

Exemplos de Consultas para LLMs

Converta a hora local 12:00 para UTC mantendo os números de hora local.
Obtenha a representação de data UTC para 11 de agosto de 2026.
Faça parsing de '2026-08-11T12:00:00' diretamente em UTC.

2. Diferença e Comparação

date_diff

Calcule diferenças exatas entre duas datas (retorna valor escalar ou detalhamento completo).

ferramenta mathmcp

Parâmetro	Tipo	Obrigatório	Descrição
`date1`	string	obrigatório	Primeira data (formato ISO ou `now`)
`date2`	string	obrigatório	Segunda data para comparar
`unit`	string	opcional	Unidade para diferença escalar (omitir para detalhamento completo)
`float`	boolean	opcional	Retornar diferença escalar de ponto flutuante

{ "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"
}

Exemplos de Consultas para LLMs

Quantos dias há entre 11 de agosto de 2026 e 25 de dezembro de 2026?
Calcule a diferença em semanas e dias entre estas duas datas.

calc_age

Calcule idade exata em anos, meses, dias, semanas totais e dias totais em relação à data de destino.

ferramenta humanmcp

Parâmetro	Tipo	Obrigatório	Descrição
`birthDate`	string	obrigatório	String de data de nascimento (`YYYY-MM-DD`). Alias: `birth_date`
`targetDate`	string	opcional	Data de referência para comparação (padrão: hoje). 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"
}

Exemplos de Consultas para LLMs

Qual é a idade de alguém nascido em 15 de maio de 1995 em 11 de agosto de 2026?
Calcule a idade exata em anos, meses e dias para 15 de maio de 1995.
Quantas semanas totais tem uma pessoa nascida em 1995-05-15?

compare_dates

Avalie predicados booleanos de comparação de datas: isBefore, isAfter, isSame, isSameOrBefore, isSameOrAfter.

ferramenta comparisonmcp

Parâmetro	Tipo	Obrigatório	Descrição
`date1`	string	opcional	Primeira data ou `now`
`date2`	string	obrigatório	Segunda data para comparar
`comparison`	enum	obrigatório	`isBefore` \| `isAfter` \| `isSame` \| `isSameOrBefore` \| `isSameOrAfter`
`unit`	string	opcional	Granularidade da unidade de comparação (ex.: `month`, `day`)

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

true

Exemplos de Consultas para LLMs

11 de agosto de 2026 é antes de 15 de agosto de 2026?
Verifique se a data A é igual à data B ignorando a hora.
2026-08-11 é depois de 2026-08-01?

is_between

Verifique se uma data está entre os limites inicial e final com opções de inclusividade configuráveis.

ferramenta comparisonmcp

Parâmetro	Tipo	Obrigatório	Descrição
`date`	string	opcional	Data de destino ou `now`
`start`	string	obrigatório	Data inicial do intervalo
`end`	string	obrigatório	Data final do intervalo
`unit`	string	opcional	Granularidade da unidade de comparação
`inclusivity`	enum	opcional	`()` \| `(]` \| `[)` \| `[]` (padrão: `()`)

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

true

Exemplos de Consultas para LLMs

Hoje está entre 2025-01-01 e 2025-12-31?
11 de agosto de 2026 está dentro do intervalo de 1 a 31 de agosto de 2026?
Verifique se '2026-08-11' está estritamente entre duas datas limite.

date_compare

Execute a matriz completa de comparação de datas em todas as granularidades de unidade simultaneamente.

ferramenta comparisonmcp

Parâmetro	Tipo	Obrigatório	Descrição
`date1`	string	obrigatório	Primeira string de data ou `now`
`date2`	string	obrigatório	Segunda string de data ou `now`

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

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

Exemplos de Consultas para LLMs

Compare duas datas em todas as unidades, como mesma semana, mesmo mês, mesmo ano.
11 de agosto de 2026 e 15 de agosto de 2026 estão no mesmo mês e semana?
Obtenha o detalhamento comparativo completo entre 2026-08-11 e 2026-08-15.

relative_time

Obtenha uma expressão de tempo relativo legível por humanos (ex.: 'há 3 dias', 'em 2 meses').

ferramenta relativemcp

Parâmetro	Tipo	Obrigatório	Descrição
`date`	string	opcional	Data ou `now`
`relativeTo`	string	opcional	Data de referência em vez da hora atual
`withoutSuffix`	boolean	opcional	Omitir sufixo 'atrás' / 'em'
`direction`	enum	opcional	`from` ou `to` (padrão: `from`)

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

"10 days ago"

Exemplos de Consultas para LLMs

Há quanto tempo foi 1 de agosto de 2026 em comparação com 11 de agosto de 2026?
Formate 1 de agosto de 2026 como tempo relativo (ex.: 'há 10 dias').
Expresse a diferença de data de forma legível sem sufixos.

intl_format_distance Locale-aware relative time formatting utilizing standard Intl.RelativeTimeFormat.

i18nmcp tool

Parâmetro	Tipo	Obrigatório	Descrição
`date`	string	opcional	Data alvo (padrão: agora)
`baseDate`	string	opcional	Data de referência para comparação (padrão: agora)
`locale`	string	opcional	Tag de localidade BCP 47 (ex.: `en`, `fr`, `es`)
`numeric`	enum	opcional	`auto` ou `always`
`style`	enum	opcional	`long` \| `short` \| `narrow`
`unit`	string	opcional	Unidade explícita (segundo, minuto, hora, dia, semana, mês, ano)

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

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

Exemplos de Consultas para LLMs

Mostre a distância de tempo relativo em espanhol ('dentro de 3 días') para 14 de agosto.
Obtenha a distância de tempo relativo localizada entre 11 e 14 de agosto de 2026.

closest_date

Encontre qual data em um array de candidatas está mais próxima de uma data de referência.

searchmcp tool

Parâmetro	Tipo	Obrigatório	Descrição
`date`	string	opcional	Data de referência (padrão: agora)
`dates`	array	obrigatório	Array de strings de datas candidatas
`format`	string	opcional	String de formatação de saída

{
  "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
}

Exemplos de Consultas para LLMs

Qual data nesta lista [2026-01-01, 2026-08-10, 2026-12-31] está mais próxima de 11 de agosto de 2026?

interval_overlap

Determine se dois intervalos de datas se sobrepõem e calcule a contagem de dias sobrepostos.

intervalmcp tool

Parâmetro	Tipo	Obrigatório	Descrição
`start1`	string	obrigatório	Início do intervalo 1
`end1`	string	obrigatório	Fim do intervalo 1
`start2`	string	obrigatório	Início do intervalo 2
`end2`	string	obrigatório	Fim do intervalo 2
`inclusive`	boolean	opcional	Incluir toque de limite como sobreposição
`mode`	enum	opcional	`overlapping` ou `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"
}

Exemplos de Consultas para LLMs

Os intervalos de datas de 1 a 15 de agosto e de 10 a 20 de agosto se sobrepõem?
Calcule quantos dias se sobrepõem entre dois cronogramas de eventos.
Verifique se o intervalo de 2026-08-01 a 2026-08-15 intersecta com 2026-08-10 a 2026-08-20.

3. Negócios e Calendário

business_days

Conte dias úteis (segunda a sexta) entre datas ou adicione/subtraia dias úteis a partir de uma data inicial.

businessmcp tool

Parâmetro	Tipo	Obrigatório	Descrição
`mode`	enum	opcional	`diff` \| `add` \| `subtract` (padrão: `diff`)
`startDate`	string	opcional	String de data inicial
`endDate`	string	opcional	Data final (para modo `diff`)
`amount`	number	opcional	Contagem de dias úteis (para `add` / `subtract`)
`format`	string	opcional	Padrão de formatação de saída

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

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

Exemplos de Consultas para LLMs

Adicione 5 dias úteis à sexta-feira, 7 de agosto de 2026.
Quantos dias úteis existem entre 1 e 15 de agosto de 2026?
Subtraia 10 dias úteis de 11 de agosto de 2026.

work_days

Calcule dias úteis entre duas datas com sinalizadores opcionais de inclusão de fins de semana.

workmcp tool

Parâmetro	Tipo	Obrigatório	Descrição
`startDate`	string	obrigatório	Data inicial (AAAA-MM-DD)
`endDate`	string	obrigatório	Data final (AAAA-MM-DD)
`includeWeekends`	boolean	opcional	Incluir sábado e domingo (padrão: falso)

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

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

Exemplos de Consultas para LLMs

Conte o total de dias úteis entre 2026-08-01 e 2026-08-11.
Quantos dias, excluindo fins de semana, existem na primeira quinzena de agosto de 2026?

calendar_month

Gere uma matriz de calendário mensal completa estruturada em arrays de semanas para exibições de interface de calendário.

calendarmcp tool

Parâmetro	Tipo	Obrigatório	Descrição
`date`	string	opcional	Data de referência no mês alvo
`weekStart`	enum	opcional	`0` (domingo) ou `1` (segunda-feira)
`format`	string	opcional	Padrão de formato de saída de string de data

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

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

Exemplos de Consultas para LLMs

Gere uma matriz de calendário mensal completa para agosto de 2026 começando na segunda-feira.
Obtenha todas as semanas e datas de agosto de 2026 estruturadas para layout de calendário de interface.
Construa uma grade de visualização de calendário mensal para agosto de 2026.

each_weekend_of

Obtenha um array de todas as datas de fim de semana (sábado e domingo) dentro de um intervalo, mês ou ano especificado.

calendarmcp tool

Parâmetro	Tipo	Obrigatório	Descrição
`mode`	enum	opcional	`interval` \| `month` \| `year` (padrão: `interval`)
`date`	string	opcional	Data de referência para modo `month` ou `year`
`start`	string	opcional	Data inicial para modo `interval`
`end`	string	opcional	Data final para modo `interval`

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

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

Exemplos de Consultas para LLMs

Liste todas as datas de fim de semana (sábados e domingos) em agosto de 2026.
Obtenha todas as datas de dias de fim de semana no ano de 2026.
Encontre todas as datas de fim de semana entre 1 e 31 de agosto de 2026.

day_of_week

Obtenha o nome do dia, nome do mês, ano, sinalizador de fim de semana, dia do ano e número da semana para qualquer data.

metadatamcp tool

Parâmetro	Tipo	Obrigatório	Descrição
`date`	string	obrigatório	String de data (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
}

Exemplos de Consultas para LLMs

Que dia da semana é 11 de agosto de 2026?
11 de agosto de 2026 é fim de semana ou dia útil?
Qual é o número do dia do ano para 11 de agosto de 2026?

last_day_of

Retorne o último dia de um período (mês, ano, trimestre, semana, isoWeek, década).

boundarymcp tool

Parâmetro	Tipo	Obrigatório	Descrição
`date`	string	opcional	Data de referência ou `now`
`unit`	enum	obrigatório	`month` \| `year` \| `quarter` \| `week` \| `isoWeek` \| `isoWyear` \| `decade`
`format`	string	opcional	Padrão de formato de saída

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

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

Exemplos de Consultas para LLMs

Qual é o último dia do terceiro trimestre de 2026?
Encontre o último dia do mês para agosto de 2026.
Qual é o último dia da década para 2026-08-11?

countdown

Gere decomposições estruturadas de tempo restante ou tempo decorrido em relação a um carimbo de data/hora alvo.

timermcp tool

Parâmetro	Tipo	Obrigatório	Descrição
`date`	string	obrigatório	Data alvo ou carimbo de data/hora
`format`	string	opcional	String de formatação para saída da data alvo

{ "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"
}

Exemplos de Consultas para LLMs

Quantos dias, horas e minutos restam até o Ano Novo de 2027?
Gere uma decomposição de contagem regressiva ao vivo para 2027-01-01T00:00:00Z.
Quanto tempo resta até a meia-noite de 1º de janeiro de 2027?

4. Fusos Horários e Relógio Mundial

convert_timezone

Projete carimbos de data/hora entre fusos horários IANA do mundo, lidando perfeitamente com transições de horário de verão.

timezonesmcp tool

Parâmetro	Tipo	Obrigatório	Descrição
`date`	string	opcional	String de data ou `now`
`fromTimezone`	string	opcional	Fuso horário IANA de origem (ex.: `UTC`)
`toTimezone`	string	obrigatório	Fuso horário IANA de destino (ex.: `Asia/Tokyo`)
`format`	string	opcional	Padrão de formatação de saída

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

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

Exemplos de Consultas para LLMs

Que horas são 12:00 PM UTC em Tóquio (Ásia/Tóquio)?
Converta 2026-08-11 14:00 de America/New_York para Europe/London.
Projete um carimbo de data/hora UTC para o horário local de Tóquio.

local_time

Obtenha a hora local atual, data, nome do fuso horário e deslocamento para o ambiente de execução.

systemmcp tool

Não requer parâmetros. Inspeciona o relógio do ambiente do sistema local e as configurações de localidade.

{}

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

Exemplos de Consultas para LLMs

Qual é a hora local, data e deslocamento de fuso horário do meu sistema?
Mostre a hora local atual e o fuso horário deste servidor.
Obtenha o relógio do sistema local e o deslocamento UTC em minutos.

world_time

Consulte a hora local ativa, bandeiras de países e deslocamentos em principais cidades ou regiões mundiais.

worldmcp tool

Parâmetro	Tipo	Obrigatório	Descrição
`query`	string	opcional	Nome da cidade ou país (ex.: `Tokyo`, `Germany`)
`region`	enum	opcional	Região de filtro (`All` \| `Africa` \| `Americas` \| `Asia` \| `Europe` \| `Oceania`)
`timezone`	string	opcional	String de fuso horário IANA direto
`offset_hours`	number	opcional	Fallback de horas de deslocamento 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"
    }
  ]
}

Exemplos de Consultas para LLMs

Que horas são no Japão agora?
Mostre a hora atual e o deslocamento GMT para Tóquio.
Pesquise a hora local para principais cidades da Europa.

time_duration

Calcule a duração entre duas strings de hora de relógio (HH:MM ou HH:MM:SS), lidando automaticamente com mudanças durante a noite.

timemcp tool

Parâmetro	Tipo	Obrigatório	Descrição
`start`	string	obrigatório	Hora inicial (ex.: `22:00`)
`end`	string	obrigatório	Hora final (ex.: `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"
}

Exemplos de Consultas para LLMs

Quantas horas e minutos se passaram entre 22:00 e 6:30 da manhã seguinte?
Calcule a duração entre o horário inicial 09:00 e o horário final 17:30.
Qual é a diferença de tempo em horas entre 22:00 e 06:30?

5. Intervalos e Durações

each_of_interval

Gere um array de datas/horas de passo ao longo de um limite de intervalo.

generatormcp tool

Parâmetro	Tipo	Obrigatório	Descrição
`start`	string	obrigatório	String ISO de início do intervalo
`end`	string	obrigatório	String ISO de fim do intervalo
`unit`	enum	opcional	`day` \| `hour` \| `minute` \| `month` \| `quarter` \| `week` \| `year` (padrão: `day`)
`step`	number	opcional	Tamanho do incremento do passo (padrão: 1)
`format`	string	opcional	Padrão de formatação de saída

{ "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"
  ]
}

Exemplos de Consultas para LLMs

Liste cada data de passo diário entre 1 de agosto de 2026 e 3 de agosto de 2026.
Gere intervalos horários entre 2026-08-01T00:00 e 2026-08-01T12:00.
Crie um array de datas semanais ao longo de agosto de 2026.

duration

Crie e inspecione durações a partir de strings ISO, números de milissegundos ou descritores de objeto de unidade.

durationmcp tool

Parâmetro	Tipo	Obrigatório	Descrição
`input`	string \| number \| object	obrigatório	String ISO 8601 (`P1Y2M`), número de ms ou objeto de unidade
`unit`	string	opcional	Unidade quando a entrada é um 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
}

Exemplos de Consultas para LLMs

Analise a duração ISO 'P1Y2M3D' em anos, meses e dias estruturados.
Converta 36979200000 milissegundos em duração legível por humanos.
Crie um objeto de duração a partir de 2 horas e 30 minutos.

interval_to_duration

Converta datas de início e fim em um objeto de duração estruturado dividido em anos, meses, dias, etc.

durationmcp tool

Parâmetro	Tipo	Obrigatório	Descrição
`start`	string	obrigatório	String ISO de início do intervalo
`end`	string	obrigatório	String ISO de fim do intervalo

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

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

Exemplos de Consultas para LLMs

Converta o intervalo de 2025-01-01 a 2026-08-11 em anos, meses e dias.
Quantos anos e meses existem entre duas datas específicas?
Obtenha a duração estruturada entre a data de início e a data de fim. format_duration_string

Construa uma string de texto formatada em inglês a partir de números de componentes de duração.

ferramenta durationmcp

Parâmetro	Tipo	Obrigatório	Descrição
`years, months, weeks, days, hours, minutes, seconds`	number	opcional	Partes numéricas individuais da duração
`format`	array	opcional	Limitar unidades exibidas (ex.: `["hours", "minutes"]`)
`delimiter`	string	opcional	Separador de unidades (padrão: `,` )
`zero`	boolean	opcional	Incluir unidades de valor zero (padrão: false)

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

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

Consultas de Exemplos para LLMs

Formatar 90 minutos como horas, minutos..
Converter partes de duração (2 horas, 30 min) em uma string ISO ou frase em inglês.

parse_iso_duration

Analisar uma string de duração ISO 8601 (ex.: 'P1Y2M3DT4H') em um objeto com todos os componentes.

ferramenta durationmcp

Parâmetro	Tipo	Obrigatório	Descrição
`iso`	string	obrigatório	String de duração ISO 8601 (ex.: `P1Y6M`, `PT2H30M`)

{ "iso": "PT2H30M" }

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

Consultas de Exemplos para LLMs

Analisar a string de duração ISO 8601 'PT2H30M'.
Extrair horas, minutos e milissegundos totais de 'P1Y6M'.
Decodificar duração ISO 'PT1H45M' em objeto de componentes padrão.

clamp_date

Limitar uma data dentro dos limites de intervalo inicial e final.

ferramenta mathmcp

Parâmetro	Tipo	Obrigatório	Descrição
`date`	string	opcional	Data a ser limitada (padrão: agora)
`start`	string	obrigatório	Data limite inferior
`end`	string	obrigatório	Data limite superior
`format`	string	opcional	Padrão de formatação de saída

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

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

Consultas de Exemplos para LLMs

Limitar '2026-12-31' dentro dos limites '2026-01-01' e '2026-08-31'.
Garantir que a data não exceda o prazo máximo permitido de 31 de agosto de 2026.
Verificar se a data foi limitada quando restrita entre limites de intervalo.

round_to_nearest

Arredondar data/hora para os N minutos ou N horas mais próximos usando arredondamento padrão, para baixo ou para cima.

ferramenta mathmcp

Parâmetro	Tipo	Obrigatório	Descrição
`date`	string	opcional	Data alvo ou `now`
`unit`	enum	opcional	`minutes` ou `hours` (padrão: `minutes`)
`nearestTo`	number	opcional	Incremento do passo (ex.: 15 para quarto 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 Exemplos para LLMs

Arredondar 14:23:00 para os 15 minutos mais próximos.
Arredondar para baixo a hora atual para o intervalo de 30 minutos mais próximo.

6. Componentes & Setters

date_part

Extrair uma parte específica da data: semana, isoWeek, isoWeekday, trimestre, diaDoAno ou diaDaSemana.

ferramenta componentmcp

Parâmetro	Tipo	Obrigatório	Descrição
`date`	string	opcional	Data ou `now`
`part`	enum	obrigatório	`week` \| `isoWeek` \| `isoWeekday` \| `quarter` \| `dayOfYear` \| `weekday`

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

223

Consultas de Exemplos para LLMs

Obter o número do dia do ano para 11 de agosto de 2026.
Em qual trimestre do ano está 11 de agosto?
Extrair o número da semana ISO para 2026-08-11.

date_components_all

Recuperar todos os componentes numéricos e de calendário de uma vez (ano, mês, data, hora, semana ISO, trimestre, Unix, década, etc.).

ferramenta componentmcp

Parâmetro	Tipo	Obrigatório	Descrição
`date`	string	opcional	String de data ou `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 Exemplos para LLMs

Recuperar todos os componentes (ano, mês, data, trimestre, dia do ano) para 11 de agosto de 2026.
Obter detalhamento completo numérico e textual da data para 2026-08-11.
Mostrar todos os valores temporais para a data atual.

set_components

Definir componentes numéricos específicos de data/hora em uma data base e retornar o timestamp resultante.

ferramenta settermcp

Parâmetro	Tipo	Obrigatório	Descrição
`date`	string	opcional	Data base ou `now`
`year, month, day, hour, minute, second, millisecond`	number	opcional	Valores de campos específicos a modificar
`dayOfYear, quarter, week, isoWeek, isoDay, isoWeekYear, weekYear`	number	opcional	Modificações de campos de calendário

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

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

Consultas de Exemplos para LLMs

Definir mês para dezembro e dia para 25 na data '2026-08-11'.
Modificar ano para 2028 na data '2026-08-11'.
Definir hora para 15:30:00 em 11 de agosto de 2026.

days_in_month

Retornar o número total de dias no mês para uma determinada data.

ferramenta calendarmcp

Parâmetro	Tipo	Obrigatório	Descrição
`date`	string	opcional	String de data ou `now`

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

29

Consultas de Exemplos para LLMs

Quantos dias há em fevereiro de 2024?
Qual é o total de dias em agosto de 2026?
Verificar quantos dias há no mês para '2026-02-15'.

convert_units

Converter um valor numérico entre unidades de tempo (segundos, minutos, horas, dias, semanas, meses, anos).

ferramenta conversionmcp

Parâmetro	Tipo	Obrigatório	Descrição
`value`	number	obrigatório	Quantidade numérica a converter
`from`	string	obrigatório	Unidade de origem (ex.: `hours`, `days`)
`to`	string	obrigatório	Unidade de destino (ex.: `minutes`, `weeks`)

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

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

Consultas de Exemplos para LLMs

Converter 36 horas em dias.
Quantos minutos há em 2,5 horas?
Converter 14 dias em semanas.

time_add

Adicionar ou subtrair horas, minutos e/ou segundos a uma string de hora de relógio.

ferramenta timemcp

Parâmetro	Tipo	Obrigatório	Descrição
`time`	string	obrigatório	Hora de relógio base (ex.: `14:30:00`)
`add_hours`	number	opcional	Horas a adicionar (negativo para subtrair)
`add_minutes`	number	opcional	Minutos a adicionar
`add_seconds`	number	opcional	Segundos a adicionar

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

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

Consultas de Exemplos para LLMs

Adicionar 45 minutos a 14:30:00.
Subtrair 2 horas da hora de relógio 01:15:00.
Adicionar 3 horas e 15 minutos a 09:00:00.

7. Validação & Predicados

is_valid

Verificar se uma string de data representa uma data de calendário válida e analisável.

ferramenta validationmcp

Parâmetro	Tipo	Obrigatório	Descrição
`date`	string	obrigatório	String de data a validar
`inputFormat`	string	opcional	Padrão de formato de análise esperado

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

false

Consultas de Exemplos para LLMs

'2026-02-31' é uma data de calendário válida?
Verificar se a string '2026-08-11' é uma data válida.
Validar se '2025-13-40' pode ser analisado como uma data real.

date_predicate

Testar predicados booleanos específicos em uma data: isLeapYear, isToday, isTomorrow, isYesterday.

ferramenta predicatemcp

Parâmetro	Tipo	Obrigatório	Descrição
`date`	string	opcional	String de data alvo ou `now`
`predicate`	enum	obrigatório	`isLeapYear` \| `isToday` \| `isTomorrow` \| `isYesterday`

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

true

Consultas de Exemplos para LLMs

2024 é um ano bissexto?
11 de agosto de 2026 é hoje?
Verificar se '2026-08-10' é ontem.

date_predicates

Executar todos os predicados booleanos de calendário e temporais simultaneamente para uma data.

ferramenta predicatemcp

Parâmetro	Tipo	Obrigatório	Descrição
`date`	string	opcional	Data alvo ou `now`

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

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

Consultas de Exemplos para LLMs

Verificar todos os flags booleanos (isTuesday, isWeekend, isLeapYear, isThisMonth) para 11 de agosto de 2026.
Executar todos os predicados de calendário em '2026-08-11'.
2026-08-11 é dia de semana, fim de semana ou ano bissexto?

unix_convert

Converter entre strings de data e timestamps Unix (segundos e milissegundos).

ferramenta conversionmcp

Parâmetro	Tipo	Obrigatório	Descrição
`date`	string	opcional	String de data (para modo `to_unix`)
`fromUnix`	number	opcional	Timestamp Unix em segundos (conversão abreviada)
`mode`	enum	opcional	`to_unix` ou `from_unix` (padrão: `to_unix`)

{ "fromUnix": 1786406400 }

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

Consultas de Exemplos para LLMs

Converter timestamp Unix 1786406400 em uma string de data ISO.
Obter o timestamp de época Unix em segundos para '2026-08-11'.
Converter 1786406400 segundos em data UTC padrão.

min_max

Encontrar a data mais antiga (min) ou mais recente (max) de um array de strings de data.

ferramenta searchmcp

Parâmetro	Tipo	Obrigatório	Descrição
`dates`	array	obrigatório	Array de strings de data candidatas
`operation`	enum	obrigatório	`min` (mais antiga) ou `max` (mais recente)
`format`	string	opcional	Padrão de formatação de saída

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

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

Consultas de Exemplos para LLMs

Encontrar a data mais recente entre ['2026-01-01', '2026-08-11', '2026-12-25'].
Qual data é a mais antiga neste array de strings de data?
Obter a data máxima (mais recente) da minha lista de marcos do projeto.

locale_data

Recuperar metadados de localidade em arrays (meses, meses abreviados, nomes de dias da semana, primeiro dia da semana).

ferramenta i18nmcp

Parâmetro	Tipo	Obrigatório	Descrição
`part`	enum	obrigatório	`months` \| `monthsShort` \| `weekdays` \| `weekdaysShort` \| `weekdaysMin` \| `firstDayOfWeek`
`locale`	string	opcional	Código de localidade alvo (padrão: `en`)

{ "part": "months" }

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

Consultas de Exemplos para LLMs

Obter array de nomes completos de meses em inglês.
Obter nomes abreviados de dias da semana para localidade inglesa.
Qual é o primeiro dia da semana nos dados de localidade inglesa?

next_prev_weekday

Encontrar a próxima ou anterior ocorrência de um dia específico da semana em relação a uma data inicial.

ferramenta calendarmcp

Parâmetro	Tipo	Obrigatório	Descrição
`date`	string	opcional	Data de referência inicial (padrão: agora)
`weekday`	string \| number	obrigatório	Dia alvo: 0–6 ou nome do dia da semana (`monday`, `friday`)
`direction`	enum	opcional	`next` ou `previous` (padrão: `next`)
`format`	string	opcional	Padrão de formatação de saída

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

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

Consultas de Exemplos para LLMs

Quando é a próxima sexta-feira em relação a 11 de agosto de 2026?
Encontrar a segunda-feira anterior a 11 de agosto de 2026.
Qual data será o próximo domingo?