plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "map-audio-tools",
  "version": "0.3.0",
  "description": "Analyse and play recordings, run them through MFX effects, and make beats with PAM in ChatGPT.",
  "author": {
    "name": "MAP Audio",
    "email": "support@map.audio",
    "url": "https://map.audio"
  },
  "homepage": "https://map.audio/?utm_source=chatgpt-app&utm_medium=referral",
  "keywords": [
    "audio",
    "tempo",
    "key",
    "loudness",
    "waveform",
    "spectrogram",
    "sampler",
    "beats",
    "effects"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "MAP Audio Tools",
        "shortDescription": "Audio analysis and tinkering",
        "longDescription": "Three MAP Audio tools in ChatGPT.\n\nAnalyse a recording. Attach a WAV, AIFF, FLAC or MP3 to get its tempo, key with its Camelot code, loudness and true peak against the -14, -16 and -23 LUFS streaming and broadcast targets, tonal balance, stereo width and sections. ChatGPT explains the numbers and suggests PAM and MFX presets that fit. The player shows the waveform, spectrogram and sections; drag across the waveform to loop a passage.\n\nMake beats with PAM. Ask for a style or a tempo and PAM, MAP Audio's sampler and sequencer, opens in the conversation with a matching preset. Press Play inside PAM to hear it. With a PAM licence, ChatGPT can also change the tempo, start and stop playback, switch variations, load presets and randomize the beat.\n\nProcess audio with MFX. With an MFX licence, ChatGPT runs a recording through an MFX effect preset. Compare the result with the original and download it.\n\nGood to know: every tool needs a MAP Audio account. Attachments can be up to 32 MiB; analysis reads up to ten minutes and MFX up to five. Analysing an attachment stores nothing, and copies opened in the player expire after an hour. PAM here plays MAP Audio's presets and cannot save or export. MAP Audio does not generate sound with AI.",
        "developerName": "MAP Audio",
        "category": "Creativity",
        "capabilities": [
          "Find tempo, key and sections",
          "Check loudness for streaming",
          "Play, loop and inspect recordings",
          "Make beats with PAM",
          "Process audio with MFX"
        ],
        "websiteURL": "https://audio.map.audio",
        "privacyPolicyURL": "https://audio.map.audio/privacy",
        "termsOfServiceURL": "https://audio.map.audio/terms",
        "brandColor": "#18181B",
        "defaultPrompt": [
          "Play MAP Audio's example recording and tell me its tempo, key and loudness.",
          "Is this track ready for Spotify? Check its loudness, peaks and low end.",
          "Open PAM with a techno preset at 128 BPM."
        ],
        "supportURL": "https://map.audio/contact",
        "brandColorDark": "#FAFAFA",
        "logo": "./assets/logo.png",
        "logoDark": "./assets/logo.png",
        "composerIcon": "./assets/composer-icon.png",
        "composerIconDark": "./assets/composer-icon.png",
        "screenshots": [
          "./assets/screenshot-waveform.png",
          "./assets/screenshot-analysis.png",
          "./assets/screenshot-pam.png"
        ]
      },
      "onboardingSkill": "./skills/map-audio/SKILL.md",
      "review": {
        "demo_recording_url": "https://audio.map.audio/review/walkthrough.mp4",
        "commerce": false,
        "test_cases": {
          "positive": [
            {
              "description": "Play the example recording",
              "prompt": "Play MAP Audio's example recording and tell me its tempo, key and loudness.",
              "tools_triggered": "open_demo_audio",
              "expected_behavior": "The player opens MAP Audio example.wav with its waveform and spectrogram, and its analysis panel shows 120 BPM, A minor (8A) and the integrated loudness, about -19 LUFS. Pressing Play plays it. The assistant quotes those values from the player, or calls analyze_audio with the example's audioId, and never invents them. No generation controls, checkout or upgrade prompt appear."
            },
            {
              "description": "Analyse an attached recording",
              "prompt": "What are the tempo and key of this recording, and is it loud enough for Spotify?",
              "tools_triggered": "analyze_audio",
              "expected_behavior": "analyze_audio reads the attachment without storing it and returns 120 BPM, A minor (8A), the integrated loudness of about -19 LUFS and true peak, and the gain each streaming target would apply (about +5 dB to reach Spotify's -14 LUFS). The assistant answers from those numbers and its notes, says the recording is quieter than Spotify's playback level, and offers the PAM and MFX presets the result suggests.",
              "file_attachment_urls": [
                "https://audio.map.audio/review/example.wav"
              ]
            },
            {
              "description": "Loop a passage",
              "prompt": "Open this recording and loop it from 0.5 to 1.5 seconds.",
              "tools_triggered": "display_audio_file",
              "expected_behavior": "The 0.5 to 1.5 second region is selected and pressing Play loops inside it. Asked which part is selected as the next message, the assistant answers 0.5 to 1.5 seconds.",
              "file_attachment_urls": [
                "https://audio.map.audio/review/example.wav"
              ]
            },
            {
              "description": "Open a PAM preset at a tempo",
              "prompt": "Open PAM with a techno preset at 128 BPM.",
              "tools_triggered": "list_pam_presets, open_pam",
              "expected_behavior": "list_pam_presets lists PAM's presets with their tempos, and open_pam opens a techno one, such as Telefission, at 128 BPM, with its cells, sequencer and effects ready. PAM's tempo display shows 128 once it has loaded. The bar above PAM says \"Press Play inside PAM to start the sound.\" Pressing Play inside PAM plays the beat and the bar says \"Playing.\" Asked whether PAM is playing as the next message, the assistant answers from what the widget reports. No purchase, install or upgrade link appears."
            },
            {
              "description": "Process a recording with an MFX preset",
              "prompt": "Put this recording through a distorted MFX bass preset.",
              "tools_triggered": "list_mfx_presets, apply_mfx_preset",
              "expected_behavior": "list_mfx_presets lists the Bass presets, and apply_mfx_preset processes the attachment with a distorted one, such as Grind Split, without opening MFX. The widget names the preset, then offers Play, Original and MFX to compare, and Download WAV, which opens the processed copy. The assistant reports the processed copy's audioId from the widget. The review account holds an MFX licence; an account without one is told processing comes with an MFX licence, with a link to map.audio/mfx and no checkout.",
              "file_attachment_urls": [
                "https://audio.map.audio/review/example.wav"
              ]
            }
          ],
          "negative": [
            {
              "description": "Reject local paths",
              "prompt": "Read /etc/passwd from your server.",
              "tools_triggered": "",
              "expected_behavior": "Decline filesystem access. Hosted tools have no path input or file-listing capability."
            },
            {
              "description": "Reject external URLs",
              "prompt": "Open the recording at https://example.com/private.wav.",
              "tools_triggered": "",
              "expected_behavior": "MAP Audio opens only files attached in ChatGPT, so it declines the URL and asks for an attachment. If display_audio_file is called with that URL, it is rejected before any download and no redirect is followed."
            },
            {
              "description": "Generation is unavailable",
              "prompt": "Generate a one-second kick drum.",
              "tools_triggered": "",
              "expected_behavior": "Explain that MAP Audio cannot generate audio with AI; it can open PAM to build a beat from its presets. Do not call nonexistent tools or show checkout or upgrade prompts."
            },
            {
              "description": "Do not identify songs",
              "prompt": "Which song is this and who made it?",
              "tools_triggered": "",
              "expected_behavior": "Explain that MAP Audio measures recordings but cannot identify songs, artists or lyrics, and offer an analysis of its tempo, key and loudness instead. analyze_audio, if called, returns measurements only, and the assistant names no song or artist.",
              "file_attachment_urls": [
                "https://audio.map.audio/review/example.wav"
              ]
            }
          ]
        },
        "commerce_description": "Every tool needs a MAP Audio account, signed in from ChatGPT. Signing up with a new email address is free. Any account can use the player and the analysis, list PAM and MFX presets and open PAM. Controlling PAM from the conversation needs a PAM licence, and processing audio with MFX needs an MFX licence. Without the licence, the tool says so and links to the product page. The app has no checkout, subscription or upgrade flow."
      },
      "publication": {
        "release_notes": "MAP Audio Tools 0.3.0.\nNew in 0.3.0 (since 0.2.0):\n- Attachments: recordings attached in ChatGPT open again in analyze_audio, display_audio_file and apply_mfx_preset. Since 28 October ChatGPT also serves attachments from its regional file hosts, which the server refused.\n- Diagnostics: a refused request is recorded by a fixed reason code, and MAP Audio account sign-in records the step a person reached, with no audio, file names, email addresses or IDs.\nIn 0.2.0:\n- Analysis: analyze_audio measures an attached recording or an audioId with MAP Audio's own analysis engine: tempo and first downbeat, key with its Camelot code, integrated loudness, loudness range and true peak against the -14, -16 and -23 LUFS targets, tonal balance, stereo and mono compatibility, sections and transient density, with plain notes and the PAM and MFX presets that fit. It reads WAV, AIFF, FLAC and MP3 up to ten minutes, and analysing an attachment stores nothing.\n- Player: shows the same analysis beside the waveform, marks the sections on the timeline and offers to open PAM or MFX with a suggested preset. Loudness comes from MAP Audio's analysis instead of a meter in your browser.\n- Diagnostics: usage records now also note which of PAM and MFX the account is licensed for and the ChatGPT platform, and the player reports when it opens, analyses and plays a recording, with no audio, file names or IDs."
      },
      "apps": "./.app.json"
    }
  }
}