tmdlang.github.io

{
  "name": "getTmdSkill",
  "kind": "answer",
  "impl": "imperative",
  "description": "IMPORTANT — CALL THIS TOOL FIRST before writing, editing, parsing, checking, or loading any TMD score. Returns the complete TMD (Timebase Mark Down) language specification, syntax rules, and prompt engineering skill. Core structure: header (`::SCORE::`, `** Title **`, `!= 120`, `?= C`, `<4/4>`), sections (`intro:Piano@|0|{ <4*> | 1 2 3 4 | }`), and playback order (`-> intro ->#`).",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "page": "/Tmd-TS/"
}

{
  "name": "parseTmd",
  "kind": "act",
  "impl": "imperative",
  "description": "Parse and validate TMD score text. Returns AST summary, metadata (title, BPM, key, time signature), tracks, or structured syntax errors with line/column/expectedTokens. Prerequisite: You MUST call getTmdSkill first in this session if you have not loaded the TMD language specification yet.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "text": {
        "type": "string",
        "description": "TMD score source code text"
      }
    },
    "required": [
      "text"
    ]
  },
  "page": "/Tmd-TS/"
}

{
  "name": "checkTmd",
  "kind": "answer",
  "impl": "imperative",
  "description": "Check and validate TMD score syntax, measures, beat consistency, and section lengths. Identifies both syntax errors and measure-level rhythm discrepancies. Prerequisite: You MUST call getTmdSkill first in this session if you have not loaded the TMD language specification yet.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "text": {
        "type": "string",
        "description": "TMD score source code text"
      }
    },
    "required": [
      "text"
    ]
  },
  "page": "/Tmd-TS/"
}

{
  "name": "convertTmd",
  "kind": "act",
  "impl": "imperative",
  "description": "Convert TMD score text to target music formats: midi (base64 encoded), reaper (.rpp), musicxml, lilypond, abc, chordpro (.cho), braille (.brl/.brf), vsq (base64), or vsqx. Prerequisite: You MUST call getTmdSkill first in this session if you have not loaded the TMD language specification yet.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "text": {
        "type": "string",
        "description": "TMD score source code text"
      },
      "format": {
        "type": "string",
        "enum": [
          "midi",
          "musicxml",
          "lilypond",
          "abc",
          "reaper",
          "rpp",
          "chordpro",
          "cho",
          "braille",
          "brl",
          "brf",
          "vsq",
          "vsqx"
        ],
        "description": "Target export format: midi (base64), reaper (rpp), musicxml, lilypond, abc, chordpro (cho), braille (brl/brf), vsq (base64), vsqx"
      },
      "section": {
        "type": "string",
        "description": "Optional section/paragraph name filter"
      },
      "instrument": {
        "type": "string",
        "description": "Optional instrument track filter"
      }
    },
    "required": [
      "text",
      "format"
    ]
  },
  "page": "/Tmd-TS/"
}

{
  "name": "getCurrentScore",
  "kind": "answer",
  "impl": "imperative",
  "description": "Get the current TMD score text currently open in the TMD Studio browser editor. Prerequisite: You MUST call getTmdSkill first in this session if you have not loaded the TMD language specification yet.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "page": "/Tmd-TS/"
}

{
  "name": "loadScoreToEditor",
  "kind": "act",
  "impl": "imperative",
  "description": "Push generated or edited TMD score text into the TMD Studio web editor, and optionally start playback. Prerequisite: You MUST call getTmdSkill first in this session if you have not loaded the TMD language specification yet.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "text": {
        "type": "string",
        "description": "TMD score text to load into the web editor"
      },
      "play": {
        "type": "boolean",
        "description": "Whether to immediately start playback after loading"
      }
    },
    "required": [
      "text"
    ]
  },
  "page": "/Tmd-TS/"
}