plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "iq-score",
  "version": "0.2.2",
  "description": "You know the yield. Do you know the risk behind it? Explore income quality for covered CEFs, BDCs, REITs and income ETFs.",
  "author": {
    "name": "R-Ventures B.V."
  },
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "IQ Score",
        "shortDescription": "Beyond yield. Check quality.",
        "longDescription": "You know the yield. Do you know the risk behind it?\n\nIQ Score evaluates indicators of income quality and sustainability for covered CEFs, BDCs, REITs and income ETFs. Look beyond headline yield with data-driven scores, confidence levels and Friend, Question Mark or Foe classifications.\n\nExplore the reasons behind an asset's classification, screen the covered universe for high-yield Friends, review monthly IQ Score movers, and track historical score changes. You can also analyze a portfolio you provide yourself; IQ Score does not access brokerage accounts. Available data and freshness depend on your membership.\n\nBefore you buy. While you hold. Know the quality behind the yield. Check the IQ Score.\n\nRead-only investment research, not personalized investment advice. IQ Score does not predict price movements or distribution cuts, and cannot trade or place orders.",
        "developerName": "R-Ventures B.V.",
        "category": "Finance",
        "websiteURL": "https://incomequalityscore.com/",
        "supportURL": "https://incomequalityscore.com/contact/",
        "privacyPolicyURL": "https://incomequalityscore.com/privacy-policy/",
        "termsOfServiceURL": "https://incomequalityscore.com/subscription-terms/",
        "defaultPrompt": [
          "Why does ARCC have its IQ Score and classification?",
          "Which CEF Friends have forward yields above 8%, sorted by yield?",
          "Which five income assets had the biggest IQ Score declines last month?"
        ],
        "logo": "./assets/icon.png",
        "composerIcon": "./assets/icon.png",
        "brandColor": "#B57900"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Single covered ticker lookup",
              "prompt": "What is the IQ Score of ARCC?",
              "tools_triggered": "iqs_get_score",
              "expected_behavior": "Call iqs_get_score with ticker ARCC and return the IQ Score, Friend / Question Mark / Foe classification, confidence, score date, and tier-appropriate source metadata."
            },
            {
              "description": "Batch lookup of covered tickers",
              "prompt": "Show IQ Scores for ARCC, MAIN and OBDC.",
              "tools_triggered": "iqs_get_scores",
              "expected_behavior": "Call iqs_get_scores for ARCC, MAIN and OBDC and return one result per ticker plus shared tier-appropriate source metadata."
            },
            {
              "description": "Whitespace and lowercase ticker normalization",
              "prompt": "What is the IQ Score for ' arcc '?",
              "tools_triggered": "iqs_get_score",
              "expected_behavior": "Call iqs_get_score for the supplied ticker; the canonical normalizer trims whitespace and normalizes case so the returned asset is ARCC."
            },
            {
              "description": "Tier-appropriate freshness and source date",
              "prompt": "What classification does ARCC have, what date is the score from, and how fresh is my IQ Score data?",
              "tools_triggered": "iqs_get_score",
              "expected_behavior": "Call iqs_get_score for ARCC. The response source reflects the linked account entitlement: delayed_monthly for Free, latest_monthly for Starter, or current / daily_current for Pro. The user cannot select a fresher source."
            },
            {
              "description": "Batch lookup containing an invalid symbol",
              "prompt": "Give me IQ Scores for ARCC and the invalid symbol 'bad ticker!'.",
              "tools_triggered": "iqs_get_scores",
              "expected_behavior": "Call iqs_get_scores with ARCC and 'bad ticker!'. ARCC returns normally while the invalid symbol returns the canonical invalid_ticker state without fabricating a score or failing the valid result."
            },
            {
              "description": "Explain a classification using recorded reasons and flags",
              "prompt": "Why does ARCC have its IQ Score and classification?",
              "tools_triggered": "iqs_explain_score",
              "expected_behavior": "Call iqs_explain_score for ARCC. Explain the recorded IQ Score, classification, reasons and flags using actual source/as-of information. Do not invent absent signals or imply a future distribution cut."
            },
            {
              "description": "Screen the scored CEF universe for Friends with 8%+ forward yield",
              "prompt": "Which CEF Friends have forward yields above 8%, sorted by yield?",
              "tools_triggered": "iqs_screen_scores",
              "expected_behavior": "Call iqs_screen_scores for CEF, friend classification, min_forward_yield_pct 8, sorted by forward_yield_pct descending. Report the actual results at the permitted freshness; do not present the screen as a buy recommendation."
            },
            {
              "description": "Find monthly score decliners across the scored universe",
              "prompt": "Which five income assets had the biggest IQ Score declines last month?",
              "tools_triggered": "iqs_top_movers",
              "expected_behavior": "Call iqs_top_movers with direction decliners and limit 5 for the latest monthly comparison available to the user. State both compared months and as-of dates; do not imply a price decline or forecast."
            },
            {
              "description": "Review frozen monthly IQ Score history for a specific ticker",
              "prompt": "How has BST's IQ Score changed over the past 12 months?",
              "tools_triggered": "iqs_get_history",
              "expected_behavior": "Call iqs_get_history for BST with frequency monthly and limit 12. Summarize only the returned dated observations and actual classification changes; do not invent missing history or daily measurements."
            },
            {
              "description": "Analyze only a user-supplied hypothetical portfolio",
              "prompt": "Analyze this hypothetical income portfolio: ARCC $10,000, BST $5,000 and MAIN $5,000.",
              "tools_triggered": "iqs_analyze_portfolio",
              "expected_behavior": "Call iqs_analyze_portfolio using the three user-supplied tickers and market values. Explain classification distribution and unscored entries according to tool data. Do not attempt brokerage access or make individualized buy or sell recommendations."
            }
          ],
          "negative": [
            {
              "description": "Trading is outside the read-only IQ Score capability",
              "prompt": "Buy 100 shares of ARCC for me."
            },
            {
              "description": "Brokerage-account access is outside IQ Score MCP; analyzing a user-provided portfolio is supported",
              "prompt": "Show me all positions in my brokerage account."
            },
            {
              "description": "The plugin must not invent a score for an unknown or uncovered symbol",
              "prompt": "What is the IQ Score of ZZZZ?"
            }
          ]
        },
        "commerce": false,
        "commerce_description": "IQ Score does not sell products or process payments through the plugin.",
        "demo_recording_url": "https://www.loom.com/share/b6c654a5a0e2447893eb08a140a530aa"
      },
      "publication": {
        "release_notes": "Marketing and discovery update: highlights score explanations, universe screening, monthly movers, monthly history and user-supplied portfolio analysis for CEFs, BDCs, REITs and income ETFs. Updated three starter prompts and review scenarios. Original MCP configuration, OAuth and visual assets are unchanged."
      },
      "apps": "./.app.json"
    }
  }
}