plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "masterpiano",
  "version": "1.0.0",
  "description": "Classical piano sheet music at your level: see and hear it, get fingering, check its ABRSM grade, or create a sight-reading exercise.",
  "author": {
    "name": "MasterPiano",
    "email": "support@masterpiano.com",
    "url": "https://www.masterpiano.com"
  },
  "homepage": "https://www.masterpiano.com/chatgpt-and-claude",
  "keywords": [
    "piano",
    "sheet music",
    "sight-reading",
    "music education",
    "ABRSM"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "MasterPiano",
        "shortDescription": "Piano sheet music and levels",
        "longDescription": "MasterPiano helps piano learners find music they can actually play. Ask for classical sheet music by title, composer, era, ABRSM grade or level, and the score appears right in the chat with a play button, its MasterPiano level (1 to 100) and its approximate ABRSM grade.\n\nWhat you can ask:\n- Find sheet music: \"a grade 3 Baroque piece\", \"easy Chopin\", \"Gymnop\u00e9die No. 1\".\n- Show and play a piece: the opening bars as notation with a real piano sound.\n- Suggest fingering: finger numbers for both hands on the opening bars.\n- Check a piece's difficulty: level, approximate grade, what makes it hard and easier pieces to learn first.\n- Create a sight-reading exercise: a fresh exercise at your level, in the key and time signature you choose.\n\nThe library covers public-domain classical piano music (composers who died by 1925, from Bach to Debussy and Joplin). Songs still under copyright are not available. The card shows the opening bars; each card links to the piece's page on masterpiano.com, where you can read the whole score and practise it with live feedback on your piano. No account or sign-in needed. The plugin cannot hear you play.",
        "developerName": "MasterPiano",
        "category": "Education & Research",
        "capabilities": [
          "Find piano sheet music",
          "Show and play a piece",
          "Suggest fingering",
          "Check a piece's difficulty",
          "Create a sight-reading exercise"
        ],
        "websiteURL": "https://www.masterpiano.com/chatgpt-and-claude",
        "supportURL": "https://www.masterpiano.com/contact",
        "privacyPolicyURL": "https://www.masterpiano.com/privacy",
        "termsOfServiceURL": "https://www.masterpiano.com/terms",
        "defaultPrompt": [
          "Suggest a grade 3 Baroque piano piece I could learn next.",
          "What fingering should I use for Bach's Minuet in G?",
          "Give me a grade 1 piano sight-reading exercise in G major."
        ],
        "brandColor": "#F2552C",
        "brandColorDark": "#FF6A40",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "onboardingSkill": "./skills/get-started/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Find a piece at a grade and era",
              "prompt": "I'm about ABRSM grade 3 on piano. Suggest a Baroque piece I could learn next.",
              "tools_triggered": "find_piano_sheet_music",
              "expected_behavior": "A card lists up to six public-domain Baroque pieces around grade 3, each with its MasterPiano level; tapping one shows its opening bars and plays them."
            },
            {
              "description": "Show and play a famous piece",
              "prompt": "Show me how F\u00fcr Elise starts on piano.",
              "tools_triggered": "show_piano_piece",
              "expected_behavior": "A card shows the first 16 bars of F\u00fcr Elise, WoO 59 by Beethoven with a play button, level 70 and about ABRSM grade 5, and a link to the full score."
            },
            {
              "description": "Suggest fingering",
              "prompt": "What fingering should I use for Bach's Minuet in G?",
              "tools_triggered": "add_piano_fingering",
              "expected_behavior": "A card shows Minuet in G major, BWV Anh. 114 (Christian Petzold) with finger numbers 1 to 5 on the opening bars and playback."
            },
            {
              "description": "Check a piece's difficulty",
              "prompt": "Is Clair de Lune too hard for a grade 5 pianist? What should I learn first?",
              "tools_triggered": "check_piece_difficulty, find_piano_sheet_music",
              "expected_behavior": "Says Clair de lune is about ABRSM grade 7 (MasterPiano level 82), lists what makes it hard, and suggests easier pieces to learn first."
            },
            {
              "description": "Create a sight-reading exercise",
              "prompt": "Give me a grade 1 piano sight-reading exercise in G major.",
              "tools_triggered": "create_sight_reading_exercise",
              "expected_behavior": "A card shows a new 8-bar level 16 exercise in G major with playback; its link opens the same worksheet on masterpiano.com."
            }
          ],
          "negative": [
            {
              "description": "Copyrighted song: the plugin must not show its score",
              "prompt": "Show me the piano sheet music for River Flows in You by Yiruma."
            },
            {
              "description": "Not piano and not public domain: the plugin should not be used",
              "prompt": "What are the chords for Wonderwall on guitar?"
            },
            {
              "description": "Whole-score download: the plugin never sends full scores or PDFs",
              "prompt": "Send me the full PDF of Chopin's Ballade No. 1 so I can print it."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "The plugin sells nothing and shows no prices, trials, upgrade prompts or checkout links. Cards link to the piece's informational page on masterpiano.com.",
        "demo_recording_url": "https://cap.so/s/8rwmkrya7jpsssc"
      },
      "publication": {
        "release_notes": "First release: find, play, finger and level public-domain classical piano pieces, and create sight-reading exercises."
      },
      "apps": "./.app.json"
    }
  }
}