Skip to content
MCP server

Duration

Parses and formats ISO 8601 durations via an MCP server, for developers and agents

Install
Pricing
Freemium
Platforms
API, CLI, self-hosted
Runs
Locally or Remotely
Version
0.2.1
Listing updated
today

Similar MCP servers

About Duration

Duration is a freemium MCP server for time utilities. It can run locally on your machine or as a hosted remote server.

The Duration server gives AI clients two tools for working with ISO 8601 duration strings. One tool takes a string such as PT1H30M or P1Y2M10DT2H and returns its components along with an approximate total in seconds. The other goes the reverse way, turning a number of seconds into an ISO 8601 string plus a readable form. The README notes that months are estimated as 30 days and years as 365 days in the total.

The README describes the package as a local stdio bridge that forwards calls to a Pipeworx gateway endpoint, so the tools need network access and there is no offline mode, even though the page describes the conversions as offline. The endpoint is also reachable directly over streamable HTTP, and it can be added to Claude, Cursor, VS Code or Claude Code with a single config entry.

The server suits developers who handle durations in APIs, scheduling or media metadata and want an agent to do the conversion rather than writing the parsing code themselves. Calls are anonymous by default with a daily cap, and a free Pipeworx key raises that cap.

Install

Run in a terminal

claude mcp add --transport http duration https://gateway.pipeworx.io/duration/mcp

Add to Settings → Connectors → Add custom connector

https://gateway.pipeworx.io/duration/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "duration": {
      "url": "https://gateway.pipeworx.io/duration/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "duration": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/duration/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "duration": {
      "serverUrl": "https://gateway.pipeworx.io/duration/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "duration": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/duration/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

parse_duration
Parse an ISO 8601 duration string into components and an approximate total in seconds.
format_duration
Convert a number of seconds into an ISO 8601 duration string and a human-readable form.

What it does

Parse ISO 8601 durations
Breaks a duration string into its components and gives an approximate total in seconds.
Format seconds as durations
Converts a count of seconds into an ISO 8601 string and a human-readable form.
Remote and local transports
Available as a streamable HTTP endpoint or as an npm stdio package.
Optional API key
Anonymous calls are capped daily; a free Pipeworx key raises the limit.

Good for

  • Converting ISO 8601 duration fields from an API response into seconds
  • Turning a number of seconds into a readable length for display
  • Checking how a duration string such as P1Y2M10DT2H is interpreted by an agent
  • Adding duration conversion to an MCP client without writing a parser

Pricing

Freemium, from $49 a month

Free anonymous and free registered tiers; paid credits and subscriptions for higher usage

Prices change. Check pipeworx.io before you buy.

Duration FAQ

How are months and years counted in the total?

The README says months are estimated as 30 days and years as 365 days for the approximate total in seconds.

Does the server need an API key?

No. The README says calls work without a key but are capped at 50 per day; a free account raises the cap to 200 per day.

Which tools does the server provide?

The README lists parse_duration and format_duration. Each endpoint also lists shared Pipeworx meta-tools alongside them.

Is Duration free?

Duration has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

How do I add Duration to Claude Code?

Run this command in your terminal: claude mcp add --transport http duration https://gateway.pipeworx.io/duration/mcp

What are the best alternatives to Duration?

The closest alternatives to Duration are Datecalc, Timestamp, ISO 8601 duration shape, Timeapi Io and UTC ISO time only.

Where this comes from

  • Description: written from the project's README, the project's website and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers