plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "map-audio",
  "version": "0.4.0",
  "description": "Play and analyse 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",
    "waveform",
    "spectrogram",
    "loudness",
    "samples",
    "sampler",
    "beats",
    "effects"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "MAP Audio",
        "shortDescription": "Audio analysis and tinkering",
        "longDescription": "MAP Audio puts three of its tools in ChatGPT.\n\nAnalyse a recording. Attach a file and the player shows its waveform and spectrogram, with sample peak, true peak, RMS and integrated LUFS measured in your browser. Drag across the waveform to loop a section. ChatGPT sees the measurements, where playback is and the section you picked, and it can mark sections on the timeline. In the ChatGPT desktop app, WAV, FLAC, MP3 and M4A files from the conversation open in the player too.\n\nMake beats with PAM. PAM is MAP Audio's eight-cell sampler and sequencer, and it runs in the conversation, in your browser. Ask for a style or a tempo and ChatGPT opens PAM with a matching preset. Press Play inside PAM to start the sound. With a PAM licence, ChatGPT can then change the tempo, start and stop playback, switch variations, load another preset or randomize the beat.\n\nProcess audio with MFX. With an MFX licence, ChatGPT runs a recording through one of MFX's effect presets without opening MFX. You can compare the result with the original and download it.\n\nLimits: attachments can be up to 32 MiB, and MFX takes up to five minutes of audio. Stored copies expire after one hour. PAM in ChatGPT plays MAP Audio's presets and cannot save presets or export audio. Every tool needs a MAP Audio account. MAP Audio does not generate sound with AI.",
        "developerName": "MAP Audio",
        "category": "Creativity",
        "capabilities": [
          "Play and loop recordings",
          "See waveform and spectrogram",
          "Measure peaks and loudness",
          "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 show its waveform and spectrogram.",
          "How loud is this recording, and does it clip?",
          "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-meters.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.",
              "tools_triggered": "open_demo_audio",
              "expected_behavior": "The player opens MAP Audio example.wav with its waveform, spectrogram and sample peak, true peak, RMS and integrated LUFS readings, and pressing Play plays it. No generation controls, checkout or upgrade prompt appear."
            },
            {
              "description": "Open an attached recording and read its meters",
              "prompt": "Open this recording and show its loudness and peak readings.",
              "tools_triggered": "display_audio_file",
              "expected_behavior": "display_audio_file imports the attachment and shows it with its waveform, spectrogram and sample peak, true peak, RMS and integrated LUFS readings measured in the browser, and Download audio saves the original WAV. The player fetches the bytes itself through the app-only read_audio_chunk tool, which the model never calls. Asked for the integrated loudness as the next message, the assistant quotes the player's reading and never invents one.",
              "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 PAM",
              "prompt": "Open PAM so I can make a beat.",
              "tools_triggered": "open_pam",
              "expected_behavior": "PAM opens in the conversation with its default preset loaded and its cells, sequencer and effects ready. The bar above it 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": "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. PAM's tempo display shows 128 once it has loaded. Sound starts only after the user presses Play inside PAM."
            },
            {
              "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."
            }
          ]
        },
        "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 its measurements, 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": "New in 0.4.0:\n- Sign-in: every tool now needs a MAP Audio account, signed in through ChatGPT (OAuth).\n- PAM: open_pam opens PAM, MAP Audio's sampler and sequencer, in the conversation with a chosen preset, variation and tempo, and list_pam_presets lists the presets. With a PAM licence, ChatGPT can also read and change what PAM is playing: get_transport, start_transport, stop_transport, full_stop_transport, set_bpm, load_variation, cancel_queued_variation, load_preset and randomize.\n- MFX: apply_mfx_preset processes a recording with an MFX preset without opening MFX and keeps the result for an hour behind its own download link; list_mfx_presets lists the presets. Processing needs an MFX licence.\n- Desktop file viewer: WAV, FLAC, MP3 and M4A files open in the player, and MAP Audio stores no copy.\n- If ChatGPT refuses a file chosen with the player's Open audio button, the player now asks you to attach it in the conversation.\n- The widgets send anonymous diagnostics (event names and timings) to audio.map.audio, with no audio, file names or IDs."
      },
      "apps": "./.app.json"
    }
  }
}