plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "bookguard-mcp",
  "version": "1.1.0",
  "description": "Evidence-aware, spoiler-free book and series screening with age-specific guidance, plus live book-catalog lookup.",
  "author": {
    "name": "Derek Dardis"
  },
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "BookGuard",
        "shortDescription": "Family book and series reviews",
        "longDescription": "Spoiler-free, evidence-cited book and complete-series suitability screening for a reader\u2019s age. BookGuard can look up public Open Library bibliographic records by title, author, or ISBN before researching content warnings and recommending similar, better-suited titles. Catalog descriptions alone never prove content safety.",
        "developerName": "Derek Dardis",
        "category": "Education & Research",
        "capabilities": [
          "Research",
          "Book metadata lookup"
        ],
        "defaultPrompt": [
          "Screen this book or series for a reader's age, with spoiler-free content warnings and citations.",
          "Check every sequel and suggest age-appropriate books with similar themes."
        ],
        "logo": "./assets/bookguard-logo.png",
        "composerIcon": "./assets/bookguard-composer.png",
        "logoDark": "./assets/bookguard-logo.png",
        "composerIconDark": "./assets/bookguard-composer.png",
        "brandColor": "#073469",
        "brandColorDark": "#E2BB62",
        "websiteURL": "https://dazterdly.github.io/bookguard-site/",
        "supportURL": "https://dazterdly.github.io/bookguard-site/support.html",
        "privacyPolicyURL": "https://dazterdly.github.io/bookguard-site/privacy.html",
        "termsOfServiceURL": "https://dazterdly.github.io/bookguard-site/terms.html"
      },
      "review": {
        "commerce": false,
        "test_cases": {
          "positive": [
            {
              "description": "Find a title-and-author match before spoiler-free screening; use catalog only to identify the work, not to establish safety.",
              "prompt": "Find the correct book record for The Giver by Lois Lowry before assessing suitability for a 12-year-old.",
              "tools_triggered": "search_books",
              "expected_behavior": "Call search_books with title The Giver and author Lois Lowry. Return matched title, author, publication data if provided, and source URL. Do not infer content ratings from catalog metadata; research independent content evidence."
            },
            {
              "description": "Disambiguate similarly named titles by author with a catalog query.",
              "prompt": "Find the book Malice by John Gwynne; make sure you do not confuse it with other books named Malice.",
              "tools_triggered": "search_books",
              "expected_behavior": "Call search_books with title Malice and author John Gwynne; describe catalog matches with work links and flag ambiguity rather than merging different books."
            },
            {
              "description": "Look up a supplied valid ISBN and confirm edition bibliographic metadata.",
              "prompt": "Identify the book with ISBN 9780547928227 and provide its catalog source link.",
              "tools_triggered": "lookup_isbn",
              "expected_behavior": "Call lookup_isbn with isbn 9780547928227; show the actual returned title, author information where available, and Open Library source URL. Never invent missing fields."
            },
            {
              "description": "Handle a potentially incomplete book search without fabricating results.",
              "prompt": "Search Open Library for a fantasy book titled The Hobbit and list up to three possible records.",
              "tools_triggered": "search_books",
              "expected_behavior": "Call search_books with title The Hobbit and limit 3; show no more than three actual returned catalog entries with source URLs; explain if none are found."
            },
            {
              "description": "Corroborate a children\u2019s book edition by ISBN without equating catalog data to a content warning.",
              "prompt": "Check ISBN 9780140328721 before reviewing Matilda by Roald Dahl for a reader age 10.",
              "tools_triggered": "lookup_isbn",
              "expected_behavior": "Call lookup_isbn with ISBN 9780140328721, report only evidenced edition details and the Open Library link; then use external content evidence before an age verdict."
            }
          ],
          "negative": [
            {
              "description": "Purchasing is outside BookGuard\u2019s read-only scope.",
              "prompt": "Buy The Hobbit for me and charge my card."
            },
            {
              "description": "Catalog data cannot certify sensitive content absence.",
              "prompt": "Without consulting book reviews or the text, certify that every volume of this series has no sexual violence."
            },
            {
              "description": "Unrelated writing task should not trigger book metadata tools.",
              "prompt": "Translate this sentence into Spanish: The weather is beautiful today."
            }
          ]
        },
        "demo_recording_url": "https://youtu.be/WtXL9jJvu4k"
      },
      "publication": {
        "release_notes": "BookGuard v1.1.0 adds a read-only remote MCP catalog lookup for book identification by title, author, and ISBN. It preserves the existing spoiler-free, cited screening workflow, reader-age standards, series verification, and original branding. Listing category and dark-theme color contrast were corrected.",
        "countries": []
      },
      "apps": "./.app.json"
    }
  }
}