How are years and months calculated?

To ensure deterministic results, a year is treated as exactly 365 days and a month is treated as exactly 30 days.

Can I validate a duration string before parsing it?

Yes, you can use the `validate_syntax` tool to check if a string adheres to the ISO 8601 specification before attempting to extract components.

What tools are available in this MCP?

The server provides `parse_duration_components` for unit extraction, `calculate_total_seconds` for magnitude calculation, and `validate_syntax` for format verification.

ISO 8601 Duration Parser MCP Connector for Claude

A+

Extracts time components and calculates total seconds from ISO 8601 duration strings.

3 tools Official Updated Oct 1, 2026 Official Vinkius Partner

More Details Connect to Claude

This MCP server provides deterministic parsing of ISO 8601 duration strings. It allows AI agents to break down time spans into specific components like years, months, and days, or convert a full duration into a total count of seconds. Use parse_duration_components to get a detailed breakdown, calculate_total_seconds for a single numeric magnitude, or validate_syntax to ensure a string follows the strict ISO 8601 format.

iso8601durationtime-parsingdeterministictime-conversion

Connect to Claude

Subscribe on Vinkius, then add this connector to Claude.ai or Claude Code.

① Claude.ai (web app)

Go to Settings → Connectors → Add custom connector
Paste the MCP endpoint URL below

https://edge.vinkius.com/vk_preview_2WcnUBWGMCBZlVpBB9cXYGlf2wdTc8ndAB28ZT4s/mcp

② Claude Code (terminal)

claude mcp add --transport http iso-8601-duration-parser https://edge.vinkius.com/vk_preview_2WcnUBWGMCBZlVpBB9cXYGlf2wdTc8ndAB28ZT4s/mcp

③ Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "iso-8601-duration-parser": {
      "url": "https://edge.vinkius.com/vk_preview_2WcnUBWGMCBZlVpBB9cXYGlf2wdTc8ndAB28ZT4s/mcp"
    }
  }
}

Get full access on Vinkius

The preview token above works for testing. Powered by Vinkius.

Details

Tools: 3
Grade: A+
Score: 100/100
Updated: Oct 1, 2026

Related Connectors

Sample Offset Calculator MCP

3 tools Official

Convert between milliseconds and exact audio samples for precise DAW alignment.

A+ View details →

EU Court Deadline Calculator MCP

3 tools Official

Calculate legal procedural deadlines across European jurisdictions, accounting for national holidays and business day adjustments.

A+ View details →

IP Address Parser MCP

1 tools Official

Validate, parse, and classify any IPv4 or IPv6 address. Detect private vs public ranges, parse CIDR notation, and convert between IPv4 and IPv6. Powered by ipaddr.js — the engine behind Express.js.

A+ View details →

NEW

Social Calendar Builder MCP

4 tools Official

Optimize your social life by balancing availability, budget, and travel.

A+ View details →