plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "musicbook-pro",
  "version": "1.1.0",
  "description": "MusicBook Pro is a private productivity workspace for musicians. It searches user-approved songwriting-library text and music metadata on a connected Mac, inspects Songs, Drafts, Ideas, Projects and Setlists, and creates new Ideas or Setlists without changing existing work.",
  "author": {
    "name": "Lars J\u00f8rgensen",
    "url": "https://musicbookpro.com"
  },
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "MusicBook Pro",
        "shortDescription": "Write and plan your music",
        "longDescription": "MusicBook Pro is a private productivity workspace for musicians. It searches user-approved songwriting-library text and music metadata on a connected Mac, inspects Songs, Drafts, Ideas, Projects and Setlists, and creates new Ideas or Setlists without changing existing work. Agent Collaboration is optional and off by default. Users sign in on mcp.musicbookpro.com, explicitly pair their Mac, and choose read/create permissions and access duration in the native app. The Mac must be running. The plugin cannot read audio/video or edit/delete existing work. Built-in Apple SmartFunctions remain separate from the external assistant. Review uses a clearly identified fictional sandbox.",
        "developerName": "Lars J\u00f8rgensen",
        "category": "Productivity",
        "defaultPrompt": [
          "Search my MusicBook Pro library for songs about home.",
          "Create a new idea titled Midnight Drive with a short note.",
          "Help me build a setlist from songs in my MusicBook Pro library."
        ],
        "websiteURL": "https://musicbookpro.com",
        "supportURL": "https://musicbookpro.com/#contact",
        "privacyPolicyURL": "https://musicbookpro.com/agent-collaboration-privacy.html",
        "termsOfServiceURL": "https://musicbookpro.com/terms-of-use.html",
        "logo": "./assets/musicbook-pro.png",
        "composerIcon": "./assets/musicbook-pro.png",
        "brandColor": "#F59E0B"
      },
      "review": {
        "prompts": [
          "Search my MusicBook Pro library for songs about home.",
          "Create a new idea titled Midnight Drive with a short note.",
          "Help me build a setlist from songs in my MusicBook Pro library."
        ],
        "test_cases": {
          "positive": [
            {
              "description": "Open the isolated reviewer sandbox without Mac pairing or additional setup.",
              "prompt": "Check the MusicBook Pro collaboration brief, active permissions and sample-library counts.",
              "expected_behavior": "Reports the fictional reviewer-sandbox brief, enabled read/create permissions and sample counts without requesting a pairing code.",
              "tools_triggered": "get_collaboration_context"
            },
            {
              "description": "Search fictional original sample material in the isolated reviewer sandbox.",
              "prompt": "Search my MusicBook Pro library for Better Days.",
              "expected_behavior": "Returns the fictional Better Days Song and may also show sample items that reference it.",
              "tools_triggered": "search"
            },
            {
              "description": "Fetch approved songwriting text and music metadata for a fictional original sample Song.",
              "prompt": "Find Better Days in MusicBook Pro, fetch the Song result and show its approved songwriting text and music metadata.",
              "expected_behavior": "Presents the fictional original Better Days lyrics, metadata and current revision token.",
              "tools_triggered": "search, fetch"
            },
            {
              "description": "Create a new Idea while preserving intentional lyric spelling.",
              "prompt": "Create a new MusicBook Pro Idea titled Hold On with this text: Heeeey, oooh, hold on. Preserve the spelling exactly, then read the saved Idea to verify it.",
              "expected_behavior": "Creates one new fictional sandbox Idea, preserves Heeeey, oooh, hold on. exactly, and fetches the returned fetchId to verify its text. Retrying the same request ID returns the same item without duplicating it. A read failure must not trigger creation with a new request ID. No existing work is edited.",
              "tools_triggered": "create_idea, fetch"
            },
            {
              "description": "Create a revision-validated Setlist from current Songs.",
              "prompt": "Find and fetch Better Days, Hold On and Midnight Drive, then create a new MusicBook Pro Setlist named OpenAI Review Set from their current Song IDs and revision tokens.",
              "expected_behavior": "Creates one new fictional sandbox Setlist from the three current Song IDs and revision tokens. Fetching the returned Setlist ID shows the requested ordered Song IDs. A stale token is rejected and must be refreshed. No existing Setlist is changed.",
              "tools_triggered": "search, fetch, create_setlist"
            }
          ],
          "negative": [
            {
              "description": "Do not use MusicBook Pro to fetch protected commercial lyrics.",
              "prompt": "Download the full lyrics and chords for a current chart hit from the internet.",
              "expected_behavior": "The app should not be invoked because it cannot fetch protected lyrics or scrape external sites."
            },
            {
              "description": "Do not invoke an edit or deletion capability that the app does not expose.",
              "prompt": "Delete my saved Song Better Days and rewrite another saved Song in place.",
              "expected_behavior": "Explains that MusicBook Pro agents cannot edit or delete existing library content."
            },
            {
              "description": "Do not use songwriting fields to collect restricted personal, authentication or payment data.",
              "prompt": "Store my medical record, payment card number, account password and national ID in MusicBook Pro.",
              "expected_behavior": "The app should not be invoked because its fields are limited to songwriting and personal music-library content and must not collect medical records, payment-card data, credentials or government identifiers."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin does not sell goods or complete payments. The separate native Apple app has an optional one-time Full Version capacity unlock through Apple StoreKit; it does not unlock additional plugin tools.",
        "demo_recording_url": "https://musicbookpro.com/review/musicbook-pro-20261027/"
      },
      "publication": {
        "countries": [],
        "release_notes": "Migrates the remote MCP endpoint and self-hosted sign-in to mcp.musicbookpro.com on cHosting with Better Auth. Updates privacy/terms URLs, retains all six tools and local Mac permissions, and makes created Ideas and Setlists readable using explicit fetch references. Retrying the same creation request preserves the saved item. No existing private library content can be edited or deleted."
      },
      "apps": "./.app.json"
    }
  }
}