
Duration
Parses and formats ISO 8601 durations via an MCP server, for developers and agents
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://gateway.pipeworx.io/duration/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"duration": {
"url": "https://gateway.pipeworx.io/duration/mcp"
}
}
}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.