plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "hitjam",
  "version": "1.0.1",
  "description": "Playable HitJam grand piano for chords, scales and song lessons.",
  "author": {
    "name": "Chois Music, Inc.",
    "email": "support@hitjam.io",
    "url": "https://hitjam.io/en/"
  },
  "mcpServers": "./mcp.json",
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "HitJam Piano",
        "shortDescription": "Play chords, scales and songs",
        "longDescription": "A real grand piano you can play right in the chat.\n\nAsk for any chord (C, Am7, Bbmaj7, F/A and more) or scale (major, minor, pentatonic, blues and the modes) and HitJam lights up the right keys, spelled the way a musician would write them. Press Play to hear it, tap the keys, or play along with your computer keyboard: every key shows the letter that plays it.\n\nLearning a song? HitJam teaches public-domain classics note by note: the next key glows and waits for you, with right hand, left hand and both hands to work up through.\n\nThe sound is a recorded concert grand, played on your own device. No account, no ads, and nothing you play is sent anywhere. Want the full instrument, other sounds or your MIDI keyboard? Open hitjam.io.\n\nPiano samples: Salamander Grand Piano V3 by Alexander Holm, licensed CC BY 3.0 (https://creativecommons.org/licenses/by/3.0/).",
        "developerName": "Chois Music, Inc.",
        "category": "Education & Research",
        "capabilities": [
          "Interactive piano",
          "Chords and scales",
          "Song lessons"
        ],
        "defaultPrompt": [
          "Show me a C minor 7 chord on the piano",
          "Teach me Ode to Joy on the piano",
          "Show me the A minor pentatonic scale on piano"
        ],
        "websiteURL": "https://hitjam.io/en/",
        "supportURL": "https://hitjam.io/en/support/",
        "privacyPolicyURL": "https://hitjam.io/en/privacy/",
        "termsOfServiceURL": "https://hitjam.io/en/terms/",
        "logo": "assets/logo.png",
        "brandColor": "#FF5A36",
        "brandColorDark": "#FF7A5C"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Show a named chord, correctly spelled, on a playable piano.",
              "prompt": "Show me a C minor 7 chord on the piano",
              "tools_triggered": "show_piano_chord",
              "expected_behavior": "A piano card titled \"C minor 7th\" with C4, E\u266d4, G4 and B\u266d4 lit and labelled. Play chord sounds the four notes together; tapping a key sounds it."
            },
            {
              "description": "Show a scale on a playable piano.",
              "prompt": "Show me the A minor pentatonic scale on piano",
              "tools_triggered": "show_piano_scale",
              "expected_behavior": "\"A minor pentatonic scale\" with A3, C4, D4, E4, G4 and A4 lit. Play sounds them upward one at a time."
            },
            {
              "description": "Teach a public-domain song note by note.",
              "prompt": "Teach me Ode to Joy on the piano",
              "tools_triggered": "teach_piano_song",
              "expected_behavior": "A lesson card: \"Note 1 of 30: play E4 (press E)\". The next key glows; pressing it (tap or computer key) moves to the next note. Play song performs the melody. Right hand, Left hand and Both hands switch the lesson."
            },
            {
              "description": "Show specific notes the assistant works out (a chord inversion).",
              "prompt": "How do I play a C major chord in first inversion? Show me on a piano.",
              "tools_triggered": "show_piano_notes",
              "expected_behavior": "E4, G4 and C5 lit on a playable piano; Play chord sounds them together."
            },
            {
              "description": "Open a plain playable piano.",
              "prompt": "Give me a piano to play",
              "tools_triggered": "show_piano",
              "expected_behavior": "A playable grand piano from C3 to B4 with nothing lit; every key shows the computer key that plays it. After one click on the piano, typing those letters plays notes."
            }
          ],
          "negative": [
            {
              "description": "Copyrighted song: the plugin only teaches its public-domain songs, so ChatGPT says this song is not available and offers one of them (or explains the chords in text). No copyrighted melody is shown.",
              "prompt": "Teach me Let It Be by the Beatles on piano"
            },
            {
              "description": "Unreadable chord symbol: show_piano_chord returns an error explaining the symbol can't be read and suggesting standard symbols (C, Am, G7, Fmaj7, Dm7b5, C/G). No piano with wrong keys is shown.",
              "prompt": "Show me an H#q chord on the piano"
            },
            {
              "description": "Unrelated request: the plugin is not called.",
              "prompt": "What's the weather in Seoul tomorrow?"
            }
          ]
        },
        "demo_recording_url": "https://plugin.hitjam.io/review/demo.mp4"
      },
      "publication": {
        "release_notes": "Cleaner app icon (the old one had a black edge) and a new banner picture on the piano card, matching hitjam.io. No change to tools or behaviour."
      },
      "apps": "./.app.json"
    }
  }
}