plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "learnosity-build-aide",
  "version": "1.0.0",
  "description": "Build Learnosity integrations with answers from Learnosity's own documentation and integration Skills.",
  "author": {
    "name": "Learnosity",
    "url": "https://learnosity.com"
  },
  "homepage": "https://mcp.learnosity.com/",
  "keywords": [
    "learnosity",
    "mcp",
    "assessment",
    "developer tools",
    "api integration"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Learnosity Build Aide",
        "shortDescription": "Build Learnosity integrations",
        "longDescription": "Learnosity Build Aide answers from Learnosity's own documentation, API references and guided integration Skills, with citations.\n\nAsk about your integration in plain language. Build Aide searches the Learnosity Help Site, Author Guide, Feedback Aide docs, Demos and public GitHub repositories, reads the relevant documents, and follows integration Skills for the golden path (Author, Items, Reports), request signing, LTS upgrades, content migration and more.\n\nRead-only and authless. There is no account to create and no API key to paste. The server never asks for, receives or stores your consumer key or secret, and it cannot access your Learnosity account, item bank or learner data.\n\nImportant Information about the Learnosity Build Aide MCP\n\nAvailability: The Learnosity Build Aide MCP is provided on an 'as available' basis. It is not subject to any availability, uptime, support, response or resolution commitments applicable to Learnosity Software or Services under a customer agreement.\n\nThird-party agent output: The Learnosity Build Aide MCP makes Learnosity's published documentation and integration guidance available through the Model Context Protocol. The MCP may be used by third-party AI agents, coding assistants and other developer tools. Learnosity is not responsible for, and does not warrant the accuracy, completeness or suitability of, any code, configuration, recommendations or other output generated by those third-party tools using information obtained through the MCP. Any such output should be appropriately reviewed and tested before use, particularly in a production environment.\n\nChanges/rate limits: Learnosity may apply reasonable rate limits and may modify, suspend or discontinue the Learnosity Build Aide MCP from time to time.\n\nPersonal data: Users should not submit personal data or other sensitive information through third-party tools when using the MCP unless they are satisfied that the relevant third-party tool is appropriate for that information.\n\nAlso published in the Learnosity Build Aide MCP Terms of Service: https://help.learnosity.com/hc/en-us/articles/40294187430045-Learnosity-Build-Aide-MCP-Terms-of-Service",
        "developerName": "Learnosity",
        "category": "Developer Tools",
        "capabilities": [],
        "defaultPrompt": [
          "Help me plan a Learnosity integration using the recommended APIs.",
          "How do I sign an Items API request in Node.js?",
          "Find the Learnosity documentation for embedding the Items API."
        ],
        "websiteURL": "https://mcp.learnosity.com/",
        "supportURL": "https://help.learnosity.com/hc/en-us/categories/39503036473373-Learnosity-Build-MCPs",
        "privacyPolicyURL": "https://learnosity.com/legal/privacy-policy/",
        "termsOfServiceURL": "https://help.learnosity.com/hc/en-us/articles/40294187430045-Learnosity-Build-Aide-MCP-Terms-of-Service",
        "logo": "assets/lrn-build-logo.png",
        "composerIcon": "assets/lrn-build-logo.png"
      },
      "review": {
        "prompts": [
          "I'm starting a new Learnosity integration. We need to author tests, deliver them to students and show their scores. Which APIs should I use, and in what order?",
          "How do I embed the Learnosity Items API inline in my web page?",
          "What Learnosity integration guides do you have that involve the Items API?"
        ],
        "test_cases": {
          "positive": [
            {
              "description": "Integration planning from a skill. The user wants the recommended end-to-end Learnosity integration. Passes when the assistant reads the golden-path skill and lays out the three steps in order (Author API, Items API, Reports API) and the identifiers passed between them.",
              "prompt": "I'm starting a new Learnosity integration. We need to author tests, deliver them to students and show their scores. Which APIs should I use, and in what order?",
              "tools_triggered": "skills_search {\"query\": \"author deliver report assessment platform\"} or skills_list {}, then skills_read {\"skill_id\": \"golden-path-author-items-reports\"}",
              "expected_behavior": "Explains the sequence from the skill 'Build a Complete Assessment Platform': 1) Author API to create items and activities, giving an activity_id; 2) Items API to deliver a session for a learner using activity_id, user_id and session_id; 3) Reports API to show results using the same session_id and user_id. Mentions that all three need a server-side HMAC-SHA256 signed security object and that consumer_secret is never sent to the browser."
            },
            {
              "description": "Documentation search followed by a document read (multi-step). Passes when the assistant searches the docs, opens the top help-site article and answers from its contents with the article's help.learnosity.com link.",
              "prompt": "How do I embed the Learnosity Items API inline in my web page?",
              "tools_triggered": "search_docs_sources {\"query\": \"embed Items API inline in a web page\"}, then read_document {\"source\": \"help_site\", \"article_id\": \"360000758317\"}",
              "expected_behavior": "Answers from the article 'Embedding the Items API Into Formative Content With \"Inline\" Rendering': include the Items API script tag with an LTS version (e.g. https://items.learnosity.com/?v2024.2.LTS), define initOptions, sign them server-side with a Learnosity SDK, and initialise Items API. Cites the article URL on help.learnosity.com."
            },
            {
              "description": "Lower-level API with a stated reason. The user gives a genuine reason to use Questions API instead of the recommended Items API. Passes when the assistant passes that reason in off_golden_path_reason, briefly recommends the golden path and why, then answers the question as asked.",
              "prompt": "We're building our own bespoke assessment player, so we have to use the Learnosity Questions API directly rather than Items API. How do we create and validate a custom question type?",
              "tools_triggered": "search_docs_sources {\"query\": \"Questions API custom question validation\", \"off_golden_path_reason\": \"We are building our own bespoke assessment player, so we need Questions API directly rather than Items API.\"}, optionally read_document {\"source\": \"help_site\", \"article_id\": \"360000758817\"}",
              "expected_behavior": "The search response carries a golden_path alert that echoes the reason. The assistant notes that Items API is usually preferred because Questions API leaves activity assembly, session handling and submission to the integrator, then answers using the results, including the 'Creating Custom Questions' article. It does not refuse."
            },
            {
              "description": "Filtering skills by API. Passes when the assistant lists skills with the apis filter set to items-api and names the returned skills with their goals.",
              "prompt": "What Learnosity integration guides do you have that involve the Items API?",
              "tools_triggered": "skills_list {\"apis\": [\"items-api\"]}",
              "expected_behavior": "Lists the matching skills by title, including 'Build Custom Questions and Features', 'Customise the Assessment Player UI', 'Generate and Troubleshoot Request Signatures', 'Build a Complete Assessment Platform' and 'Upgrade Between Learnosity LTS Versions', each with a one-line goal. Offers to open one."
            },
            {
              "description": "Feedback routing. Passes when the assistant fetches the feedback link and shares it instead of collecting feedback in the chat.",
              "prompt": "I found a mistake in one of the Learnosity docs you showed me. How can I report it?",
              "tools_triggered": "get_feedback_link {}",
              "expected_behavior": "Shares a friendly message with the link https://help.learnosity.com/hc/en-us/articles/39542355295389-Provide-Feedback?utm_source=learnosity-mcp. Does not ask for the user's email, credentials, ratings or other details in the chat."
            }
          ],
          "negative": [
            {
              "description": "Writing to a customer account. The server is read-only documentation and has no access to any Learnosity account or item bank. The assistant should say it cannot create content and call no tool to attempt it. It may offer to look up how-to documentation instead.",
              "prompt": "Add a new multiple-choice question about photosynthesis to my Learnosity item bank."
            },
            {
              "description": "Reading customer or learner data. The server holds no assessment sessions, scores or student records. The assistant should say it cannot access the user's account data and call no tool to fetch it. It may point to Reports API documentation.",
              "prompt": "Show me the scores my students got on yesterday's Learnosity quiz."
            },
            {
              "description": "Account administration. The server cannot manage Learnosity accounts, logins or credentials. The assistant should explain this, call no tool, and direct the user to their Learnosity account administrator or support.",
              "prompt": "Reset the password for my Learnosity Console account."
            }
          ]
        },
        "demo_recording_url": "https://drive.google.com/file/d/1x1Ie-F9CQGyNJoYlA2hVRafn17fXu5FY/view?usp=sharing"
      },
      "publication": {
        "release_notes": "Adds Learnosity Build Aide to ChatGPT, with read-only tools to search and read Learnosity documentation, find and read integration Skills, and get the feedback link.",
        "countries": []
      },
      "apps": "./.app.json"
    }
  }
}