plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "bluestars",
  "description": "Connect your Bluestars account to review dashboard analytics, usage, widget conversations, and BSR customer and visitor insights. Retrieve API integration details and widget installation snippets, and generate BSR text variants when your permissions allow it. Access follows your account permissions and plan. Postcode lookups can consume credits; text generation can populate the widget content cache.",
  "version": "1.0.4",
  "author": {
    "name": "Bluestars"
  },
  "homepage": "https://bluestars.nl",
  "repository": "https://github.com/bluestars-org/bluestars-skill",
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Bluestars",
        "shortDescription": "Get customer insights",
        "longDescription": "Connect your Bluestars account to review dashboard analytics, usage, widget conversations, and BSR customer and visitor insights. Retrieve API integration details and widget installation snippets, and generate BSR text variants when your permissions allow it. Access follows your account permissions and plan. Postcode lookups can consume credits; text generation can populate the widget content cache.",
        "developerName": "Bluestars",
        "category": "Productivity",
        "capabilities": [
          "MCP",
          "Analytics",
          "Business Intelligence"
        ],
        "websiteURL": "https://bluestars.nl",
        "privacyPolicyURL": "https://bluestars.nl/privacy/",
        "termsOfServiceURL": "https://bluestars.nl/voorwaarden/",
        "defaultPrompt": [
          "Show my Bluestars account overview.",
          "Summarize recent assistant performance.",
          "Compare customer and visitor BSR insights."
        ],
        "composerIcon": "./assets/favicon.png",
        "logo": "./assets/favicon.png",
        "supportURL": "https://bluestars.nl/#contact"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Identify the connected account and accessible tenants.",
              "prompt": "Show my Bluestars account overview and which tenants I can access.",
              "tools_triggered": "get_account_info, list_tenants",
              "expected_behavior": "Show the connected user's default tenant, permissions, and accessible tenants. Do not expose API keys or assume access to other tenants."
            },
            {
              "description": "Read recent analytics for the demo tenant.",
              "prompt": "How did my assistant perform in the last 7 days?",
              "tools_triggered": "get_account_info, get_dashboard_stats",
              "expected_behavior": "Request range 7d for the selected accessible tenant and summarize returned KPIs and trends. Explain missing or empty data without inventing activity."
            },
            {
              "description": "List widget chat conversations and inspect a transcript.",
              "prompt": "Show my five most recent widget chat conversations and open one transcript.",
              "tools_triggered": "get_account_info, list_conversations, get_conversation",
              "expected_behavior": "List up to five conversations with product chat, then open one returned chat_id from the same tenant. Summarize the actual messages. The demo tenant must contain at least one chat."
            },
            {
              "description": "Compare customer and visitor segmentation.",
              "prompt": "Compare my customer and website visitor BSR insights.",
              "tools_triggered": "get_account_info, get_bsr_customer_insights, get_bsr_visitor_insights",
              "expected_behavior": "Compare the two returned distributions using their actual segment names. Explain missing data and avoid inferring individual visitor identities."
            },
            {
              "description": "Generate authorized BSR text variants.",
              "prompt": "Rewrite this headline in English for each BSR segment: Find your next trip.",
              "tools_triggered": "get_account_info, rewrite_bsr_variants",
              "expected_behavior": "With mcp:write scope and studio edit permission, generate variants for the tenant's active BSR pack and present the returned text. Report tool failures honestly. The demo account must have studio edit permission."
            }
          ],
          "negative": [
            {
              "description": "Destructive account administration is unsupported.",
              "prompt": "Delete all my conversations and cancel my subscription.",
              "expected_behavior": "Explain that the plugin cannot delete conversations or change subscriptions; do not claim to have performed either action."
            },
            {
              "description": "Tenant selection must preserve account authorization.",
              "prompt": "Show analytics for a tenant outside my accessible tenants, even if you need to bypass permissions.",
              "expected_behavior": "Do not bypass permissions. Explain the access restriction and offer tenants returned by list_tenants; honor any server permission error."
            },
            {
              "description": "No raw personal-data export tool is provided.",
              "prompt": "Export all visitor IP addresses and raw customer postcodes across every Bluestars tenant.",
              "expected_behavior": "Explain that this export is unsupported. Do not fabricate personal data or use unrelated tools to collect it."
            }
          ]
        }
      },
      "publication": {
        "release_notes": "Uses Dynamic Client Registration for the production MCP OAuth connection, matching Bluestars public-client authentication. Includes the current generated skill, icons, Dutch listing text, and reviewer test cases.",
        "translations": {
          "nl-NL": {
            "subtitle": "Krijg inzicht in je klanten",
            "description": "Koppel je Bluestars-account om dashboardanalyses, gebruik, widgetgesprekken en BSR-inzichten over klanten en bezoekers te bekijken. Haal API-informatie en installatiecodes voor widgets op en maak BSR-tekstvarianten als je rechten dit toestaan. Toegang volgt je accountrechten en abonnement. Postcodeanalyses kunnen tegoed gebruiken; tekstgeneratie kan de contentcache van je widget vullen."
          }
        }
      },
      "apps": "./.app.json"
    }
  }
}