@kaiord/mcp

@kaiord/mcp

Model Context Protocol (MCP) server for Kaiord. Exposes fitness file conversion, validation, and inspection tools to AI agents (Claude Desktop, Claude Code, etc.).

Installation

npm install -g @kaiord/mcp

Configuration

Claude Desktop / Claude Code

Add to your MCP configuration:

{
  "kaiord": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "@kaiord/mcp"]
  }
}

Local development (monorepo)

{
  "kaiord": {
    "type": "stdio",
    "command": "node",
    "args": ["./packages/mcp/dist/bin/kaiord-mcp.js"]
  }
}

Tools

Tool	Description
kaiord_convert	Convert between FIT, TCX, ZWO, GCN, and KRD formats
kaiord_validate	Validate KRD JSON against the schema
kaiord_inspect	Parse and summarize any fitness file
kaiord_diff	Compare two fitness files
kaiord_extract_workout	Extract structured workout definition
kaiord_list_formats	List supported formats and capabilities

Resources

URI	Description
kaiord://schema/krd	KRD JSON Schema
kaiord://formats	Supported formats with capabilities
kaiord://docs/krd-format	KRD format specification

Prompts

Name	Description
convert_file	Guided file conversion workflow
analyze_workout	Inspect + extract + summarize a workout

Supported Formats

Format	Extension	Type	Description
FIT	.fit	Binary	Garmin FIT protocol
TCX	.tcx	Text	Training Center XML
ZWO	.zwo	Text	Zwift workout XML
GCN	.gcn	Text	Garmin Connect workout JSON
KRD	.krd	Text	Kaiord canonical JSON format

License

MIT