# io.github.rog0x/time (npm · @rog0x/mcp-time-tools)

Timezone, dates, cron, timestamps for AI agents

- Trust score: 66/100 (medium)
- Change this week: +20
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `@rog0x/mcp-time-tools`: 66/100 (this document), [markdown](https://verifymcp.io/servers/rog0x-time/rog0x-mcp-time-tools.md), [page](https://verifymcp.io/servers/rog0x-time/rog0x-mcp-time-tools)

## Channel facts

- Registry: `npm`
- Package: `@rog0x/mcp-time-tools`
- Version: `1.0.2`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 86/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 133 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 80/100
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 1042 tokens (~57/item across 18 items; 18 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add rog0x-time -- npx -y @rog0x/mcp-time-tools
```

### Codex

```bash
codex mcp add rog0x-time -- npx -y @rog0x/mcp-time-tools
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "rog0x-time": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@rog0x/mcp-time-tools"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add rog0x-time --command npx --arg -y --arg @rog0x/mcp-time-tools
```

### Hermes

```yaml
mcp_servers:
  rog0x-time:
    command: "npx"
    args: ["-y", "@rog0x/mcp-time-tools"]
```

### Other

```json
{
  "mcpServers": {
    "rog0x-time": {
      "command": "npx",
      "args": [
        "-y",
        "@rog0x/mcp-time-tools"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 66, +45)

- [security regression] Provenance: unverified → fail
- [security improvement] Install scripts: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Malware scan: unverified → pass
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional improvement] Schema quality: unverified → excellent
- [functional improvement] License: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] MCP protocol: unverified → pass
- [functional] Licence: MIT

### 2026-07-31 (score 21, +15)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 6, −20)

- [security regression] Malware scan: pass → unverified
- [functional regression] Dependency health: partial → unverified

### 2026-07-28 (score 26, −20)

- [functional regression] Tool coverage: 100 → unverified
- [functional improvement] Dependency health: unverified → partial
- [functional] First check of Schema quality: unverified

### 2026-07-27 (score 46)

First indexed and scored.

## MCP tools (18)

### `convert_timezone` (~89 tokens)

Convert a date/time from one timezone to another

Input parameters:

- `datetime` (string, required): Date/time string (ISO 8601 or common formats, e.g. 2025-06-15T14:30:00)
- `from_timezone` (string, required): Source timezone (e.g. America/New_York)
- `to_timezone` (string, required): Target timezone (e.g. Asia/Tokyo)

### `list_timezones` (~37 tokens)

List common timezones with their current UTC offsets

Input parameters:

- `filter` (string): Optional filter string to match timezone names (case-insensitive)

### `current_time_multi` (~46 tokens)

Show current time in multiple timezones at once

Input parameters:

- `timezones` (array, required): List of timezone identifiers (e.g. ['America/New_York', 'Asia/Tokyo'])

### `time_difference` (~53 tokens)

Calculate the time difference between two timezones

Input parameters:

- `timezone_a` (string, required): First timezone (e.g. America/New_York)
- `timezone_b` (string, required): Second timezone (e.g. Asia/Tokyo)

### `date_add_subtract` (~77 tokens)

Add or subtract days, weeks, months, or years from a date

Input parameters:

- `amount` (number, required): Amount to add (positive) or subtract (negative)
- `date` (string, required): Starting date (ISO 8601, e.g. 2025-06-15)
- `unit` (string, required): Unit of time

### `date_difference` (~70 tokens)

Calculate the difference between two dates in various units

Input parameters:

- `date_a` (string, required): First date (ISO 8601, e.g. 2025-01-01)
- `date_b` (string, required): Second date (ISO 8601, e.g. 2025-12-31)

### `business_days` (~105 tokens)

Calculate business days between dates or add business days to a date

Input parameters:

- `days` (number): Number of business days to add (required for 'add' mode, can be negative)
- `end_date` (string): End date (required for 'count' mode)
- `mode` (string, required): 'count' to count business days between two dates, 'add' to add business days to a date
- `start_date` (string, required): Start date (ISO 8601)

### `parse_cron` (~41 tokens)

Parse a cron expression into a human-readable description

Input parameters:

- `expression` (string, required): Cron expression (5 fields: minute hour day-of-month month day-of-week)

### `cron_next_runs` (~67 tokens)

Calculate the next N execution times for a cron expression

Input parameters:

- `count` (number): Number of next executions to show (max 50)
- `expression` (string, required): Cron expression (5 fields)
- `from` (string): Starting datetime (ISO 8601). Defaults to now.

### `validate_cron` (~29 tokens)

Validate a cron expression and explain any errors

Input parameters:

- `expression` (string, required): Cron expression to validate

### `generate_cron` (~55 tokens)

Generate a cron expression from a human-readable description

Input parameters:

- `description` (string, required): Human-readable schedule description (e.g. 'every weekday at 9am', 'every 5 minutes', 'first day of month at midnight')

### `timestamp_to_date` (~56 tokens)

Convert a Unix timestamp (seconds or milliseconds) to human-readable date formats

Input parameters:

- `timestamp` (number, required): Unix timestamp (auto-detects seconds vs milliseconds)
- `timezone` (string): Target timezone for display (default: UTC)

### `date_to_timestamp` (~36 tokens)

Convert a date/time string to Unix timestamps

Input parameters:

- `datetime` (string, required): Date/time string (ISO 8601 or common formats)

### `current_timestamp` (~33 tokens)

Get the current Unix timestamp and formatted date/time

Input parameters:

- `timezone` (string): Timezone for display (default: UTC)

### `format_duration` (~68 tokens)

Convert seconds to human-readable duration (e.g. 2h 30m 15s)

Input parameters:

- `seconds` (number, required): Duration in seconds
- `style` (string): Output style: 'short' (2h 30m) or 'long' (2 hours 30 minutes)

### `parse_duration` (~68 tokens)

Parse a human-readable duration string to seconds (e.g. '2h 30m', '1 day 3 hours')

Input parameters:

- `duration` (string, required): Human-readable duration (e.g. '2h 30m 15s', '1 day 3 hours', '90 minutes')

### `time_ago` (~62 tokens)

Calculate relative time description (e.g. '5 minutes ago', 'in 3 hours')

Input parameters:

- `datetime` (string, required): Target date/time (ISO 8601)
- `reference` (string): Reference date/time (ISO 8601). Defaults to now.

### `countdown` (~50 tokens)

Calculate time remaining until a target date/time

Input parameters:

- `from` (string): Starting date/time (ISO 8601). Defaults to now.
- `target` (string, required): Target date/time (ISO 8601)

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/rog0x-time/rog0x-mcp-time-tools#diagnostics

## Score history

- 2026-08-03: 66
- 2026-08-02: 66
- 2026-08-01: 21
- 2026-07-31: 21
- 2026-07-30: 6
- 2026-07-28: 26
- 2026-07-27: 46

## Links

- npm package: https://www.npmjs.com/package/@rog0x/mcp-time-tools
- Socket report: https://socket.dev/npm/package/@rog0x/mcp-time-tools
- Repository: https://github.com/rog0x/mcp-time-tools
- Changelog RSS feed: https://verifymcp.io/servers/rog0x-time/rog0x-mcp-time-tools/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/rog0x-time/rog0x-mcp-time-tools/changelog.json
- HTML version of this page: https://verifymcp.io/servers/rog0x-time/rog0x-mcp-time-tools