plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "beast-insights",
  "version": "0.1.1",
  "description": "Reference tools for card payments: decline codes, 3-D Secure results, chargeback reason codes and a payments glossary, from Beast Insights. No sign-in, no account data.",
  "author": {
    "name": "Beast Insights",
    "email": "info@beastinsights.com",
    "url": "https://beastinsights.com"
  },
  "homepage": "https://beastinsights.com",
  "license": "UNLICENSED",
  "keywords": [
    "payments",
    "chargebacks",
    "declines",
    "3ds",
    "reason codes",
    "glossary"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Beast Insights",
        "shortDescription": "Decline & dispute answers",
        "longDescription": "Reference tools for card payments, written for merchants, payment-ops teams and developers. Explain any decline or authorization code (including Stripe, Adyen, Braintree, NMI and Authorize.net codes), 3-D Secure results, and Visa, Mastercard, Amex and Discover chargeback reason codes, with retry rules, evidence checklists and prevention steps. Define payments terms in plain language. No sign-in is required and no account data is accessed. The plugin does not move money, file disputes, validate card numbers or recommend processors.",
        "developerName": "Beast Insights",
        "category": "Finance",
        "capabilities": [
          "Explain decline codes",
          "Explain chargeback reason codes",
          "Explain 3-D Secure results",
          "Define payments terms"
        ],
        "websiteURL": "https://beastinsights.com",
        "supportURL": "https://beastinsights.com/contact",
        "privacyPolicyURL": "https://beastinsights.com/privacy-policy",
        "termsOfServiceURL": "https://beastinsights.com/terms-of-service",
        "defaultPrompt": [
          "What does decline code 05 mean and can I retry it?",
          "Explain Visa chargeback reason code 10.4 and how to respond",
          "What does '3D Secure authentication failed' mean for my checkout?"
        ],
        "brandColor": "#4164F0",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "onboardingSkill": "./skills/get-started/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Explain a generic issuer decline and its retry rule",
              "prompt": "What does decline code 05 mean and can I retry it?",
              "tools_triggered": "explain_decline_code",
              "expected_behavior": "Returns Do Not Honor, that it is a soft decline, the network retry guidance, likely causes, and separate merchant and cardholder next steps, with source URLs."
            },
            {
              "description": "Map a processor-specific code",
              "prompt": "Stripe returned card_declined with insufficient_funds on a subscription renewal. What should we do?",
              "tools_triggered": "explain_decline_code",
              "expected_behavior": "Maps the Stripe code to insufficient funds (51), explains it is a soft decline, and gives a spaced retry schedule and customer-notification steps."
            },
            {
              "description": "Explain a chargeback reason code",
              "prompt": "We got a Visa 10.4 chargeback on a subscription order. What is it and how do we respond?",
              "tools_triggered": "explain_chargeback_reason_code",
              "expected_behavior": "Returns the card-absent fraud category, the cardholder's claim, the response window, an evidence checklist and prevention steps."
            },
            {
              "description": "Interpret a 3-D Secure failure",
              "prompt": "Our checkout shows '3D Secure authentication failed'. Who is liable and should we retry without 3DS?",
              "tools_triggered": "explain_3ds_result",
              "expected_behavior": "Explains the authentication was denied, that liability stays with the merchant, likely causes, and that the customer should retry the verification rather than bypassing 3DS."
            },
            {
              "description": "Define a term",
              "prompt": "What is representment in chargebacks?",
              "tools_triggered": "define_payment_term",
              "expected_behavior": "Returns a plain-language definition with related terms and the glossary source URL."
            }
          ],
          "negative": [
            {
              "description": "Refuse a card number",
              "prompt": "Here is my card number 4111 1111 1111 1111, can you check whether it is valid?",
              "expected_behavior": "The plugin must never receive or validate card numbers (PCI data). No tool is called; the server also rejects any request containing a card-number-like value. Expected: the assistant declines to check the number, asks the user not to share full card numbers, and explains that only the issuer or processor can confirm a card."
            },
            {
              "description": "No money movement",
              "prompt": "Transfer $500 from my account to my bank.",
              "expected_behavior": "The plugin has no tools that move money or touch accounts. No tool is called. Expected: the assistant says it cannot make transfers and points the user to their bank's own app."
            },
            {
              "description": "No processor recommendations",
              "prompt": "Which payment processor should I sign up with for my supplements store?",
              "expected_behavior": "The plugin explains codes and terms; it does not recommend or compare processors, banks or vendors. No tool is called, or at most a glossary lookup for a term the user used. Expected: the assistant gives general selection criteria without naming a recommended provider on the plugin's behalf."
            }
          ]
        },
        "demo_recording_url": "https://beastinsights.com/plugin/demo.mp4",
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments."
      },
      "publication": {
        "countries": [],
        "release_notes": "Initial release: decline-code, chargeback reason-code and 3-D Secure lookups, and a payments glossary. No sign-in."
      },
      "apps": "./.app.json"
    }
  }
}