Skip to content
MCP server

Kaiord

Convert, validate and inspect FIT, TCX, ZWO and Garmin workout files from an agent

Pricing
Open source
Platforms
CLI, API, self-hosted
Runs
Locally or Remotely
Version
10.5.0
Listing updated
3 days ago

About Kaiord

Kaiord is an open-source MCP server for files and documents. It can run locally on your machine or as a hosted remote server.

The server's job is fitness file formats. It converts between FIT, TCX, ZWO (Zwift), Garmin Connect workout JSON (GCN) and Kaiord's own JSON format, KRD, and can also validate, inspect, diff and extract structured workouts. GCN output stores power in watts, so a workout with percent-of-FTP targets needs the athlete's FTP supplied, otherwise the tool fails with a missing-ftp error.

There are two ways to run it. Locally, the npm package runs over stdio and additionally has Garmin Connect tools for pushing a workout after login, plus health tools. A hosted, stateless endpoint needs no install or account but is a subset: eight tools, inline content only with FIT as base64, structured workouts only, a 65,536-byte request limit, and ZWO checked for well-formedness without XSD validation. The hosted endpoint stores and logs nothing.

Kaiord also ships a TypeScript library, a CLI and a browser workout editor, and the README describes conversions as running on your own machine with no Kaiord backend. It lists one known gap: the TrainingPeaks TSS duration type is not yet implemented in the FIT converter.

Install

Run in a terminal

claude mcp add --transport http kaiord https://kaiord.com/mcp

Add to Settings → Connectors → Add custom connector

https://kaiord.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "kaiord": {
      "type": "http",
      "url": "https://kaiord.com/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "kaiord": {
      "serverUrl": "https://kaiord.com/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "kaiord": {
      "type": "http",
      "url": "https://kaiord.com/mcp"
    }
  }
}

Tools this server provides (9)

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

kaiord_convert
Convert between FIT, TCX, ZWO, GCN and KRD
kaiord_validate
Validate KRD JSON against the schema
kaiord_inspect
Parse and summarise a fitness file
kaiord_diff
Compare two fitness files field by field
kaiord_extract_workout
Extract a structured workout definition
kaiord_list_formats
List supported formats and capabilities
kaiord_get_format_spec
Get a format specification
kaiord_round_trip_validate
Validate a conversion round trip
kaiord_garmin_push
Push a KRD workout to Garmin Connect (local only)

What it does

Format conversion
FIT, TCX, ZWO, GCN and KRD in either direction.
Round-trip validation
Checks that a conversion survives a trip back.
Inspect and diff
Summarise a file or compare two field by field with tolerances.
Workout extraction
Pulls steps, targets and durations into JSON.
Hosted endpoint
A no-install, no-account remote subset.
Garmin Connect push
Local server only: send a workout to Garmin Connect after login.

Good for

  • Turn a Zwift workout into a Garmin workout
  • Check that a FIT file converted without losing data
  • Compare two versions of a workout file
  • Summarise a workout's steps and targets for an athlete
  • Push a structured workout to Garmin Connect

Pricing

Open source

Free, open source; hosted endpoint needs no account

Prices change. Check kaiord.com before you buy.

Kaiord FAQ

Do I need to install anything?

Not for the hosted endpoint at kaiord.com/mcp, which needs no account. The local server runs with npx @kaiord/mcp.

What does the hosted endpoint not do?

It has no Garmin or health tools, rejects file paths, accepts structured workouts only and caps requests at 65,536 bytes.

Why does conversion ask for FTP?

GCN stores power in watts, so percent-of-FTP targets need the athlete's FTP.

Is data stored?

The hosted endpoint stores and logs nothing, according to the docs.

Is Kaiord free?

Yes. Kaiord is open source, so you can use and self-host it for free.

How do I add Kaiord to Claude Code?

Run this command in your terminal: claude mcp add --transport http kaiord https://kaiord.com/mcp

What are the best alternatives to Kaiord?

The closest alternatives to Kaiord are Tooluniverse, Oya Browser, ASTra, Later Stages and CARTESIAN ECU.

Alternatives to Kaiord

  1. Tooluniverse

    MCP server

    MCP server giving AI agents access to thousands of scientific research tools

    Runs locally
    • Open source
    • 1.8K GitHub stars
    • Health and science
  2. Oya Browser

    MCP server

    HIPAA-oriented agentic browser with replayable playbooks, reachable over MCP

    • 32 tools
    • Remote
    • Freemium
    • 349 GitHub stars
    • Browser automation
  3. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  4. Later Stages

    MCP server

    California senior living and care provider records from state licensing and Medicare

    • 6 tools
    • Remote
    • Free
    • Health and science
  5. CARTESIAN ECU

    MCP server

    Check and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)

    Not checked yet
    • 5 tools
    • Remote
    • Paid
    • Files and documents
  6. Read-only local index of medical-device standards with official links, no standard text

    Runs locally
    • 4 tools
    • Free
    • Legal and government