Skip to main content
Glama

Create score from notation

create_score

Make a score from ABC, MusicXML or a written file. No credits; it returns its panel. Fixes go into the existing score. Pass source_score_id to keep its recording. To save its current version as a new score, pass source_score_id, title and save_current.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "create_score"
  }
}

Input Schema

NameRequiredDescriptionDefault
bpmNoPlayback tempo, overriding the notation's own.
fileNoA MusicXML, MXL or ABC file you wrote, instead of notation.
viewNostaff, jianpu (1 = the key, movable do), jianpu_fixed (1 = C, fixed do) or jianpu_melody (top line only).
titleNoNamed after its version, such as "My song (easy)".
formatNoabc or musicxml.abc
notationNoABC or MusicXML text. Every bar must fit its time signature (count L: units); a score whose bars hold more is refused unsaved. A style is more than chords and sound: write its rhythm and melody (a blues or rock line, a walking bass, fills). Swing or shuffle: write even eighths under a "Swing" or "Shuffle" word (ABC Q:"Swing" 1/4=110, or "^Swing" on a note), and playback swings the eighths of every part 2:1 from there until a "Straight" word. Several parts and staves, chord symbols and lyrics; ABC headers X, T, M, L, Q (the written tempo) and K. Playback follows repeat signs; at most 30 minutes.
save_currentNoCopy the saved revision to title. Send revision and a stable request_id (UUID), no notation.
source_score_idNoThe score it derives from: inherits its audio or video by default, without asking; check the alignment before claiming it plays in sync.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / save_current
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "Copy the saved revision to title. Send revision and a stable request_id (UUID), no notation.",
      +  "properties": {
      +    "request_id": {
      +      "type": "string"
      +    },
      +    "revision": {
      +      "type": "integer"
      +    }
      +  },
      +  "required": [
      +    "revision",
      +    "request_id"
      +  ],
      +  "type": "object"
      +}
  2. Changed1 schema field changed
    • changedInput schema / properties / notation / description
      Previous value: -"ABC or MusicXML text. Every bar must fit its time signature (count L: units); a score whose bars hold more is refused unsaved. A style is more than chords and sound: write its rhythm and melody (a blues or rock line, a walking bass, fills). Swing or shuffle: write even eighths under a \"Swing\" or \"Shuffle\" word (ABC Q:\"Swing\" 1/4=110, or \"^Swing\" on a note), and playback swings the eighths of every part 2:1 from there until a \"Straight\" word. Several parts and staves, chord symbols and lyrics; ABC headers X, T, M, L, Q (the written tempo) and K. Playback follows repeat signs; at most ten minutes."New value: +"ABC or MusicXML text. Every bar must fit its time signature (count L: units); a score whose bars hold more is refused unsaved. A style is more than chords and sound: write its rhythm and melody (a blues or rock line, a walking bass, fills). Swing or shuffle: write even eighths under a \"Swing\" or \"Shuffle\" word (ABC Q:\"Swing\" 1/4=110, or \"^Swing\" on a note), and playback swings the eighths of every part 2:1 from there until a \"Straight\" word. Several parts and staves, chord symbols and lyrics; ABC headers X, T, M, L, Q (the written tempo) and K. Playback follows repeat signs; at most 30 minutes."
  3. Changed2 schema fields changed
    • changedInput schema / properties / notation / description
      Previous value: -"ABC or MusicXML text. Every bar must fit its time signature (count L: units); a score whose bars hold more is refused unsaved. A style is more than chords and sound: write its rhythm and melody (a blues or rock line, a walking bass, fills). Swing or shuffle: write even eighths under a \"Swing\" or \"Shuffle\" word (ABC Q:\"Swing\" 1/4=110, or \"^Swing\" on a note), and playback swings the eighths of every part 2:1 from there until a \"Straight\" word. Several parts and staves, chord symbols and lyrics; ABC headers X, T, M, L, Q (the written tempo) and K. Repeats play once as written; at most ten minutes."New value: +"ABC or MusicXML text. Every bar must fit its time signature (count L: units); a score whose bars hold more is refused unsaved. A style is more than chords and sound: write its rhythm and melody (a blues or rock line, a walking bass, fills). Swing or shuffle: write even eighths under a \"Swing\" or \"Shuffle\" word (ABC Q:\"Swing\" 1/4=110, or \"^Swing\" on a note), and playback swings the eighths of every part 2:1 from there until a \"Straight\" word. Several parts and staves, chord symbols and lyrics; ABC headers X, T, M, L, Q (the written tempo) and K. Playback follows repeat signs; at most ten minutes."
    • changedInput schema / properties / title / description
      Previous value: -"Named after its version, such as \"Für Elise (easy)\"."New value: +"Named after its version, such as \"My song (easy)\"."
  4. Changed28 schema fields changed
    • removedInput schema / properties / bpm / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedInput schema / properties / bpm / default
      Removed value: -null
    • addedInput schema / properties / bpm / description
      Added value: +"Playback tempo, overriding the notation's own."
    • addedInput schema / properties / bpm / type
      Added value: +"number"
    • addedInput schema / properties / file / additionalProperties
      Added value: +false
    • removedInput schema / properties / file / anyOf
      Removed value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "download_url": {
      -        "type": "string"
      -      },
      -      "file_id": {
      -        "type": "string"
      -      },
      -      "file_name": {
      -        "default": "",
      -        "type": "string"
      -      },
      -      "mime_type": {
      -        "default": "",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "download_url",
      -      "file_id"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedInput schema / properties / file / default
      Removed value: -null
    • addedInput schema / properties / file / description
      Added value: +"A MusicXML, MXL or ABC file you wrote, instead of notation."
    • addedInput schema / properties / file / properties
      Added value: +{
      +  "download_url": {
      +    "type": "string"
      +  },
      +  "file_id": {
      +    "type": "string"
      +  },
      +  "file_name": {
      +    "default": "",
      +    "type": "string"
      +  },
      +  "mime_type": {
      +    "default": "",
      +    "type": "string"
      +  }
      +}
    • addedInput schema / properties / file / required
      Added value: +[
      +  "download_url",
      +  "file_id"
      +]
    • addedInput schema / properties / file / type
      Added value: +"object"
    • addedInput schema / properties / format / description
      Added value: +"abc or musicxml."
    • removedInput schema / properties / notation / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedInput schema / properties / notation / default
      Removed value: -null
    • changedInput schema / properties / notation / description
      Previous value: -"ABC or MusicXML text. Every bar must fit its time signature (count L: units); a score whose bars hold more is refused unsaved. A style is more than chords and sound: write its rhythm and melody (a blues or rock line, a walking bass, fills). Swing or shuffle: write even eighths under a \"Swing\" or \"Shuffle\" word (ABC Q:\"Swing\" 1/4=110, or \"^Swing\" on a note), and playback swings the eighths of every part 2:1 from there until a \"Straight\" word."New value: +"ABC or MusicXML text. Every bar must fit its time signature (count L: units); a score whose bars hold more is refused unsaved. A style is more than chords and sound: write its rhythm and melody (a blues or rock line, a walking bass, fills). Swing or shuffle: write even eighths under a \"Swing\" or \"Shuffle\" word (ABC Q:\"Swing\" 1/4=110, or \"^Swing\" on a note), and playback swings the eighths of every part 2:1 from there until a \"Straight\" word. Several parts and staves, chord symbols and lyrics; ABC headers X, T, M, L, Q (the written tempo) and K. Repeats play once as written; at most ten minutes."
    • addedInput schema / properties / notation / type
      Added value: +"string"
    • removedInput schema / properties / source_score_id / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedInput schema / properties / source_score_id / default
      Removed value: -null
    • addedInput schema / properties / source_score_id / description
      Added value: +"The score it derives from: inherits its audio or video by default, without asking; check the alignment before claiming it plays in sync."
    • addedInput schema / properties / source_score_id / type
      Added value: +"string"
    • removedInput schema / properties / title / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedInput schema / properties / title / default
      Removed value: -null
    • addedInput schema / properties / title / description
      Added value: +"Named after its version, such as \"Für Elise (easy)\"."
    • addedInput schema / properties / title / type
      Added value: +"string"
    • removedInput schema / properties / view / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedInput schema / properties / view / default
      Removed value: -null
    • addedInput schema / properties / view / description
      Added value: +"staff, jianpu (1 = the key, movable do), jianpu_fixed (1 = C, fixed do) or jianpu_melody (top line only)."
    • addedInput schema / properties / view / type
      Added value: +"string"
  5. Changed1 schema field changed
    • addedInput schema / properties / notation / description
      Added value: +"ABC or MusicXML text. Every bar must fit its time signature (count L: units); a score whose bars hold more is refused unsaved. A style is more than chords and sound: write its rhythm and melody (a blues or rock line, a walking bass, fills). Swing or shuffle: write even eighths under a \"Swing\" or \"Shuffle\" word (ABC Q:\"Swing\" 1/4=110, or \"^Swing\" on a note), and playback swings the eighths of every part 2:1 from there until a \"Straight\" word."
  6. Changed1 schema field changed
    • addedInput schema / properties / source_score_id
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null
      +}
  7. Changed5 schema fields changed
    • addedInput schema / properties / file
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": false,
      +      "properties": {
      +        "download_url": {
      +          "type": "string"
      +        },
      +        "file_id": {
      +          "type": "string"
      +        },
      +        "file_name": {
      +          "default": "",
      +          "type": "string"
      +        },
      +        "mime_type": {
      +          "default": "",
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "download_url",
      +        "file_id"
      +      ],
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null
      +}
    • addedInput schema / properties / notation / anyOf
      Added value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedInput schema / properties / notation / default
      Added value: +null
    • removedInput schema / properties / notation / type
      Removed value: -"string"
    • removedInput schema / required
      Removed value: -[
      -  "notation"
      -]
  8. First observed

TDQS

A3.6/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare this is a non-destructive, non-idempotent, closed-world write, so the safety profile is covered. The description adds real context the annotations do not: no credit cost and that it returns its panel. It does not disclose failure behavior, whether partial results are saved, or how the derived recording inheritance works, which for an 8-parameter creation tool leaves notable behavioral gaps.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

It is short and front-loads the main action, but the telegraphic fragments ("No credits; it returns its panel", "Fixes go into the existing score") are clipped to the point of ambiguity about what the panel is and what a "fix" means. Every sentence is relevant, yet several need unpacking rather than merely being brief.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With 8 parameters including two nested objects and no output schema, the description covers the derivation and save-current paths but never states that notation or file must actually be supplied, despite zero required parameters. The rich notation guidance lives in the schema, which compensates, but the valid parameter combinations remain an inference for the agent.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so baseline is 3, but the description adds combinational meaning beyond individual field docs: that source_score_id is what preserves the recording, and that source_score_id + title + save_current together copy the current version into a new score. That cross-parameter semantics is genuinely not derivable from the schema alone.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a concrete verb and resource ("Make a score from ABC, MusicXML or a written file") and names the accepted source formats, so an agent knows exactly what is produced. It stops short of explicitly contrasting itself with siblings such as revise_score, save_score_edits or preview_score_edit, so differentiation is inferred from the derivation language rather than stated.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

"Fixes go into the existing score" implicitly routes correction work away from this tool toward editing siblings, and the last sentence gives an explicit conditional pattern (source_score_id + title + save_current) for saving a version as a new score. It gives clear context but no named alternative tool, so an agent must map the implied alternative itself.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources