Skip to main content
Glama

Read the editions of a work

list_work_files
Read-onlyIdempotent

Read the scores and recordings an IMSLP work page holds, edition by edition, with paging and section filters, and report copyright by jurisdiction.

Instructions

Read the scores and recordings a work on IMSLP holds, edition by edition. An edition is a set of files published under one set of terms: the publisher, the editor and the copyright statement belong to the edition, and its files are the entries under it. A block of recordings carries performers instead, and no copyright statement at all. Address the work by its page title, written 'Work (Composer)', or by its page id, and read it a page at a time with 'limit' and 'offset'. 'editions_on_page' counts the editions the page holds, so it says how far a reading can go. Restrict to one part of the page with 'section', using the names the page itself prints: 'Scores', 'Parts', 'Arrangements and Transcriptions', 'Recordings', 'Full Scores' and others. A restriction matching nothing comes back with the sections the page does hold rather than as a work without scores. The copyright of a score is stated per jurisdiction: 'Public Domain - Non-PD US' is free in Canada and the European Union and protected in the United States, so never report a score as public domain without saying where. No score file is downloaded or linked; the work page is what an answer links to. When you show an edition to a user, credit IMSLP and link that page.

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": "list_work_files"
  }
}

Input Schema

NameRequiredDescriptionDefault
pageNoThe title of the work's page, written 'Work (Composer)', for example 'Nocturnes, Op.9 (Chopin, Frédéric)'. Pass this or 'pageid', not both.
limitNoEditions to serve, from 1 to 100.
offsetNoEditions to skip, for reading a work whose page holds many.
pageidNoThe page id a search returns. Pass this or 'page', not both.
sectionNoOne section of the page, in the wording the page prints: 'Scores', 'Parts', 'Recordings', 'Arrangements and Transcriptions', 'Full Scores', 'Synthesized/MIDI'. Matched without regard to case. Left out, every section is read.

Output Schema

NameRequiredDescriptionDefault
limitYes
notesYes
titleYesThe work these editions belong to.
offsetYes
pageidYes
sourceYes
licenseYes
sectionYesThe restriction this answer was read under.
composerYes
editionsYes
has_moreYes
page_urlYes
returnedYes
sectionsYesThe sections of the page, with the number of entries the site counts in each.
page_titleYes
redirected_fromYes
editions_on_pageYesEditions the page holds, counted here rather than published by IMSLP.
editions_in_sectionYesEditions left after the restriction, equal to 'editions_on_page' without one.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed31 schema fields changedv1.1.0
    • removedOutput schema / properties / composer / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / composer / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / editions / items / properties / arranger / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / editions / items / properties / arranger / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / editions / items / properties / copyright / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "headline": {
      -        "description": "What the statement leads with, for example 'Public Domain'.",
      -        "type": "string"
      -      },
      -      "remark": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "A remark the library wrote beside the statement, for example 'See notes on copyright status for urtext editions'. It qualifies the terms without naming a place."
      -      },
      -      "restrictions": {
      -        "description": "The jurisdictions the statement excludes, for example 'Non-PD US'. Empty when it excludes none, which is not a claim about countries IMSLP does not review.",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "reviewed_in": {
      -        "description": "Where IMSLP checks copyright: Canada, the United States and the European Union.",
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "statement": {
      -        "description": "The statement as IMSLP publishes it.",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "statement",
      -      "headline",
      -      "restrictions",
      -      "remark",
      -      "reviewed_in"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "headline": {
      +        "description": "What the statement leads with, for example 'Public Domain'.",
      +        "type": "string"
      +      },
      +      "remark": {
      +        "description": "A remark the library wrote beside the statement, for example 'See notes on copyright status for urtext editions'. It qualifies the terms without naming a place.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "restrictions": {
      +        "description": "The jurisdictions the statement excludes, for example 'Non-PD US'. Empty when it excludes none, which is not a claim about countries IMSLP does not review.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "reviewed_in": {
      +        "description": "Where IMSLP checks copyright: Canada, the United States and the European Union.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "statement": {
      +        "description": "The statement as IMSLP publishes it.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "statement",
      +      "headline",
      +      "restrictions",
      +      "remark",
      +      "reviewed_in"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedOutput schema / properties / editions / items / properties / editor / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / editions / items / properties / editor / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / editions / items / properties / files / items / properties / blocked_reason / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / editions / items / properties / files / items / properties / blocked_reason / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / editions / items / properties / files / items / properties / format / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / editions / items / properties / files / items / properties / format / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / editions / items / properties / files / items / properties / format_code / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / editions / items / properties / files / items / properties / format_code / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / editions / items / properties / files / items / properties / scanned_by_code / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / editions / items / properties / files / items / properties / scanned_by_code / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / editions / items / properties / files / items / properties / scanned_by_name / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / editions / items / properties / files / items / properties / scanned_by_name / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / editions / items / properties / files / items / properties / uploaded_on / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / editions / items / properties / files / items / properties / uploaded_on / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / editions / items / properties / files / items / properties / uploader / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / editions / items / properties / files / items / properties / uploader / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / editions / items / properties / misc_notes / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / editions / items / properties / misc_notes / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / editions / items / properties / performers / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / editions / items / properties / performers / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / editions / items / properties / publisher_info / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / editions / items / properties / publisher_info / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / redirected_from / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / redirected_from / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / section / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / section / type
      Added value: +[
      +  "string",
      +  "null"
      +]
  2. First observedv1.0.0

TDQS

A4.3/5.0
Behavior5/5

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

Annotations already declare this is read-only, idempotent, open-world, and non-destructive, but the description adds substantial domain behavior: edition vs recording distinctions, per-jurisdiction copyright meaning, section-fallback behavior, no file download/linking, and attribution requirements. These are meaningful operational details beyond the structured annotations.

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

Conciseness4/5

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

The description is fairly long, but it is front-loaded with the core purpose and proceeds logically through edition semantics, addressing, pagination, section filtering, copyright, and attribution. Some sentences such as the attribution instruction are not strictly about invocation, but they remain relevant to correct use.

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

Completeness5/5

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

Given that there is an output schema, rich annotations, and full schema coverage, the description supplies the remaining domain context an agent needs: what editions are, how recordings differ, how section restrictions behave, and how copyright should be reported. Nothing critical appears missing.

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 description coverage is 100%, so the baseline is 3. The description still adds value by explaining the 'Work (Composer)' page format, giving section-name examples and case-insensitive matching behavior, and describing what happens when a section filter matches nothing.

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 states a specific verb and resource: read the scores and recordings a work holds, edition by edition. It explains the edition structure clearly, but it never names or contrasts the sibling tools such as get_work or search_works, so the agent must infer when this tool is preferable.

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?

It gives clear invocation context: address the work by page title or page id, paginate with limit and offset, and optionally restrict with section. However, it does not explicitly say when not to use this tool or name alternatives like get_work.

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