{"count":8,"next_page":null,"page":1,"page_count":1,"per_page":30,"previous_page":null,"articles":[{"id":39503171212189,"url":"https://learnositysupport.zendesk.com/api/v2/help_center/en-us/articles/39503171212189.json","html_url":"https://help.learnosity.com/hc/en-us/articles/39503171212189-About-Learnosity-Build-Aide-MCP","author_id":29234975706397,"comments_disabled":false,"draft":false,"promoted":false,"position":0,"vote_sum":0,"vote_count":0,"upvote_count":0,"downvote_count":0,"section_id":39503070619933,"created_at":"2026-09-29T04:58:20Z","updated_at":"2026-11-02T11:35:14Z","name":"About Learnosity Build Aide MCP","title":"About Learnosity Build Aide MCP","source_locale":"en-us","locale":"en-us","outdated":false,"outdated_locales":[],"edited_at":"2026-11-02T09:32:54Z","user_segment_id":null,"permission_group_id":89809,"content_tag_ids":[],"label_names":[],"body":"

The Learnosity Build Aide MCP server is a hosted Model Context Protocol service that connects compatible AI coding assistants to Learnosity documentation and integration guidance.

Once connected, your AI coding assistant can answer questions about Learnosity, look up API and SDK information, create API request blueprints, and guide you through common integration workflows using Learnosity documentation as its source.

There is nothing to install or maintain on your own infrastructure. Connect your MCP-compatible client to the Learnosity Build Aide MCP server to get started.

Who should use Learnosity Build Aide MCP

What Learnosity Build Aide MCP does

What Learnosity Build Aide MCP does not do

The Learnosity Build Aide MCP server operates entirely at development time. It does not:

The server returns guidance, request blueprints, and reference material. Signing, credential handling, persistence, and request execution all remain the responsibility of your application and its runtime.

Every tool the server exposes is read-only. The tools cannot write, modify, or delete data.

 

","user_segment_ids":[]},{"id":39503747254813,"url":"https://learnositysupport.zendesk.com/api/v2/help_center/en-us/articles/39503747254813.json","html_url":"https://help.learnosity.com/hc/en-us/articles/39503747254813-Getting-started-with-Learnosity-Build-Aide-MCP","author_id":29234975706397,"comments_disabled":false,"draft":false,"promoted":false,"position":1,"vote_sum":0,"vote_count":0,"upvote_count":0,"downvote_count":0,"section_id":39503070619933,"created_at":"2026-09-29T05:40:09Z","updated_at":"2026-11-04T10:16:55Z","name":"Getting started with Learnosity Build Aide MCP","title":"Getting started with Learnosity Build Aide MCP","source_locale":"en-us","locale":"en-us","outdated":false,"outdated_locales":[],"edited_at":"2026-11-04T10:16:55Z","user_segment_id":null,"permission_group_id":89809,"content_tag_ids":[],"label_names":[],"body":"

Before you begin

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
RequirementDetail
MCP-compatible clientVS Code, Cursor, Kiro, Claude Code, or any client supporting the MCP HTTP transport
Network accessOutbound HTTPS to mcp.learnosity.com\n
AuthenticationNone. The server is open and requires no API key or account

No Learnosity credentials are required to use this MCP server. You will of course need them to run the integration you build.

Connect to Learnosity Build Aide MCP

Install Learnosity Build Aide MCP from your client

The Learnosity Build Aide MCP server is distributed through the marketplaces, extension directories, and plugin stores of all major MCP-compatible clients. In most cases, connecting takes two steps:

    \n
  1. Open your client's MCP server directory, extension marketplace, or plugin store.
    2. \n
  2. Search for Learnosity Build Aide MCP, then click Install (or Connect, depending on the client).
    3. \n

There is no account to create, no API key to paste, and no configuration file to edit.

Connect to Learnosity Build Aide MCP manually

If your client does not list the Learnosity Build Aide MCP server in its directory, or you prefer to configure it yourself, add the following to your mcp.json:

{\n  \"mcpServers\": {\n    \"learnosity-build-aide\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.learnosity.com/build/build-aide\"\n    }\n  }\n}

Confirm your connection

Restart or reload your client, then open its MCP servers panel. The Learnosity Build Aide MCP server (or learnosity-build-aide, if you connected manually) should appear as learnosity-build-aide should appear as Connected, with the Learnosity tools listed beneath it.

Try one of these prompts to confirm the MCP server is actually being consulted. For example:

If your assistant answers without referencing the server, prompt it explicitly - most clients let you name a server directly.

","user_segment_ids":[]},{"id":39537602360477,"url":"https://learnositysupport.zendesk.com/api/v2/help_center/en-us/articles/39537602360477.json","html_url":"https://help.learnosity.com/hc/en-us/articles/39537602360477-Using-Learnosity-Build-Aide-MCP","author_id":29234975706397,"comments_disabled":false,"draft":false,"promoted":false,"position":2,"vote_sum":0,"vote_count":0,"upvote_count":0,"downvote_count":0,"section_id":39503070619933,"created_at":"2026-09-30T08:51:30Z","updated_at":"2026-11-02T11:34:53Z","name":"Using Learnosity Build Aide MCP","title":"Using Learnosity Build Aide MCP","source_locale":"en-us","locale":"en-us","outdated":false,"outdated_locales":[],"edited_at":"2026-11-02T09:48:51Z","user_segment_id":null,"permission_group_id":89809,"content_tag_ids":[],"label_names":[],"body":"

Documentation available through Learnosity Build Aide MCP

The Learnosity Build Aide MCP server indexes Learnosity's published documentation and makes it searchable and retrievable by your assistant. Learnosity Build Aide MCP retrieves information from these sources to provide documentation-grounded guidance.

Because the assistant retrieves from these sources directly, it can cite where an answer came from, and will tell you when documentation does not cover a topic rather than filling the gap with a guess.

Tools

The server exposes eight read-only tools in three groups:

Some documentation tools accept a source identifier to specify which documentation sources to use. The available source identifiers are:

Documentation tools

list_docs_sources

Lists the configured documentation sources. Use this tool to identify the available sources and their source identifiers.

This tool does not require any parameters. It returns the source identifier, type, and title for each configured source.

list_docs_categories

Lists the available documentation categories.

\n\n\n\n\n\n\n\n\n\n\n\n\n
ParameterTypeRequiredDescription
sourcestring or nullNoSource identifier to retrieve categories from. The default is null, which returns categories from all sources.

The response includes the source, category identifier, and category name. Results are sorted by source and then by category name.

Categories are available for the Learnosity help site and author guide. Feedback Aide, Learnosity demos, and GitHub do not use categories.

search_docs_sources

Searches the indexed Learnosity documentation. Use this as the primary tool for discovering relevant documentation.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ParameterTypeRequiredDescription
querystringYesSearch query.
sourcesarray of string or nullNoSource identifiers to search. The default is null, which searches all sources.
category_idstring or nullNoCategory identifier used to filter the results.
limitintegerNoMaximum number of results to return. The default is 10. Valid values are 1 through 100.
off_golden_path_reasonstring or nullNoReason for searching for a lower-level API instead of the recommended API. See Search and the golden path gate.

The response includes the query, applied category filter, and matching results. Each result can include the source, article identifier, resource URI, title, URL, section and category information, a content snippet, match type, and images.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldTypeDescription
sourcestringSource identifier containing the document.
article_idstringIdentifier of the document.
resource_uristringThe learnosity:// URI for the document.
titlestringDocument title.
urlstringPublished URL of the document.
section_idstring or nullIdentifier of the section containing the document.
section_namestringName of the section containing the document.
category_idstring or nullIdentifier of the category containing the document.
category_namestringName of the category containing the document.
snippetstringExtract of the matching content.
match_typestringThe type of match that returned the result.
imagesarray of objectImages referenced by the document.

The response also includes an alerts array, but only when the golden path gate is triggered by the query or by one of the results. It is absent from every other response. See What the golden path gate does.

An invalid source identifier returns an error.

read_document

Retrieves an indexed document.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ParameterTypeRequiredDescription
sourcestringYesSource identifier containing the document.
article_idstringYesIdentifier of the document to retrieve.

The response includes the source, article identifier, title, URL, section and category information, last-updated date, markdown content, and images.

Images are returned separately from the markdown content in an images array.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldTypeDescription
sourcestringSource identifier containing the document.
article_idstringIdentifier of the document.
titlestringDocument title.
urlstringPublished URL of the document.
section_idstring or nullIdentifier of the section containing the document.
section_namestringName of the section containing the document.
category_idstring or nullIdentifier of the category containing the document.
category_namestringName of the category containing the document.
updated_atstringDate the document was last updated.
body_textstringDocument content in Markdown format.
imagesarray of objectImages referenced by the document.

Skills tools

skills_list

Lists the available Learnosity skills.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ParameterTypeRequiredDescription
limitintegerNoMaximum number of skills to return. The default is 200. Valid values are 1 through 2000.
apisarray of string or nullNoFilters skills by the APIs they use. The default is null, which does not apply an API filter.

When you specify apis, the response includes only skills that declare every specified API. API matching is case-insensitive.

Each result includes the skill identifier, resource URI, size, title, goal, and APIs covered by the skill.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldTypeDescription
idstringIdentifier of the Skill.
resource_uristringThe learnosity:// URI for the Skill.
size_bytesintegerSize of the Skill content in bytes.
titlestringTitle of the Skill.
goalstringWhat the Skill helps you achieve.
apisarray of stringAPIs covered by the Skill.

skills_read

Retrieves a skill and returns its content in markdown format.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ParameterTypeRequiredDescription
skill_idstringYesIdentifier of the skill to retrieve. Skill identifiers use kebab case.
max_bytesintegerNoMaximum amount of skill content to return. The default is 200000 bytes. Valid values are 1024 through 2000000 bytes.

If the skill exceeds max_bytes, its content is truncated at a character boundary and the response indicates that the content has been truncated.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldTypeDescription
idstringIdentifier of the Skill.
resource_uristringThe learnosity:// URI for the Skill.
size_bytesintegerSize of the Skill content in bytes.
truncatedbooleanWhether the content was truncated to max_bytes.
max_bytesintegerThe byte limit applied to the response.
contentstringSkill content in Markdown format.

skills_search

Searches skills by identifier, title, goal, declared APIs, or content.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ParameterTypeRequiredDescription
querystringYesSearch query.
limitintegerNoMaximum number of results to return. The default is 20. Valid values are 1 through 200.

The response includes matching skills, the field containing the match, and a content snippet.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldTypeDescription
idstringIdentifier of the Skill.
resource_uristringThe learnosity:// URI for the Skill.
titlestringTitle of the Skill.
match_fieldstringThe field that matched the query.
snippetstringExtract of the matching content.

Feedback tools

get_feedback_link

Retrieves the URL of the Learnosity Build Aide MCP feedback page, where you can submit feedback about Learnosity Build Aide MCP.

This tool does not require any parameters. It returns a message for your AI coding assistant to display and the feedback page URL.

The tool does not collect or submit feedback. Your AI coding assistant provides the link, which you can use to access the feedback page and submit your feedback.

Resources

Alongside tools, the server publishes MCP resources under the learnosity:// scheme. Resources suit clients that prefer addressable reads to tool calls, and they return the same content.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ResourceServes
learnosity://sources/indexThe configured documentation sources
learnosity://skills/indexEvery available skill, with identifier, title, goal, and APIs
learnosity://skills/skill/{skill_id}One skill's markdown body
learnosity://help-site/indexArticle metadata for the help site
learnosity://help-site/article/{article_id}One help site article in full
learnosity://author-guide/indexArticle metadata for the author guide
learnosity://author-guide/article/{article_id}One author guide article in full
learnosity://feedback-aide/indexEndpoint metadata for Feedback Aide
learnosity://feedback-aide/article/{article_id}One Feedback Aide endpoint document
learnosity://demos/indexPage metadata for the demo site
learnosity://demos/article/{article_id}One demos page
learnosity://github/indexRepository metadata for Learnosity's public GitHub organisation
learnosity://github/article/{article_id}One repository README

Note that resource URIs use hyphens where source identifiers use underscores - the help site is help_site as a tool argument and help-site in a resource URI. Every search result includes its own resource URI, so you rarely need to construct one by hand.

Transport and sessions management

Learnosity Build Aide MCP uses the MCP Streamable HTTP transport. Clients send JSON-RPC requests in the body of a HTTP POST request. The server returns responses as an HTTP event stream, allowing progress notifications to be sent before the final result.

The Accept header must include both application/json and text/event-stream. Requests that specify only one of these content types receive a HTTP 406 Not Acceptable response.

Clients that establish a connection using an initialization handshake receive a Mcp-Session-Id header in the initial response. Include this session identifier in all subsequent requests, including the GET request that opens the server-to-client event stream and the DELETE request that terminates the session.

Clients using MCP protocol version 2026-07-28 or later send self-contained requests and do not receive a session identifier.

To check service availability, send a GET request to /health-check. The endpoint returns 200 while the service is still serving, so read the response body rather than the status code.

Errors

The documentation and Skills tools can return the following errors:

Search and the golden path gate

How search works

Learnosity Build Aide MCP combines lexical and semantic search to find relevant information in the indexed documentation. Results from both search methods are merged and ranked, and each result identifies the type of match.

Title matches are ranked higher than body-content matches. Release log articles are given a lower priority so that documentation explaining a feature is prioritized over release notes that only mention it.

If semantic search is unavailable, Learnosity Build Aide MCP returns lexical search results instead.

The golden path

The golden path represents the recommended APIs for a typical Learnosity integration:

Author API → Items API → Reports API

Author API is used to create assessment content and Activities. Items API delivers the Activity and creates a learner session. Reports API uses the Activity and session information to report on the results. The golden path skill provides guidance for this end-to-end workflow.

Learnosity also publishes lower-level APIs for custom builds. They are fully supported and documented, but the recommended API is generally a better starting point for common integration workflows.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Lower-level APIPreferWhy
Questions APIItems APIRenders standalone Questions, leaving Activity assembly, session handling, and submission to your application.
Assess APIItems APIProvides the assessment player without Item sourcing or session management.
Question Editor APIAuthor APIEdits an individual Question without Item or Activity authoring.

What the golden path gate does

When search_docs_sources identifies a search for Questions API, Assess API, or Question Editor API, it can return a golden path alert recommending the corresponding higher-level API.

The golden path gate can produce the following outcomes:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldTypeDescription
typestringAlways golden_path.
messagestringThe recommendation to use the golden path.
content_withheldintegerNumber of results withheld. 0 for an advisory outcome.
required_parameterstringThe parameter needed to retrieve the withheld results. Present only when results were withheld.
next_request_instructionstringHow to repeat the request. Present only when results were withheld.
reasonstringThe off_golden_path_reason supplied with the request. Present only when a reason was given.

Using off_golden_path_reason

Use off_golden_path_reason to explain why your integration needs a lower-level API instead of the recommended API. Specify the parameter on each applicable search request because the value does not persist between searches.

search_docs_sources(\n  query = \"Assess API initialisation options\",\n  off_golden_path_reason = \"Existing player built on Assess API; migrating is out of scope this quarter\"\n)

If the reason does not identify a specific requirement for using the lower-level API, Learnosity Build Aide MCP can continue to recommend the golden path.

The golden path gate applies only to discovery through search_docs_sources. It does not prevent direct access to documentation, Skills, or MCP resources.

Skills

Skills are the most substantial part of the server. Skills provide guided workflows for specific Learnosity integration tasks. A skill can provide the steps, decisions, supporting documentation, and guidance needed to complete a workflow.

Skills are composable - a skill can reference another skill. This means you get consistent, non-contradictory advice regardless of which entry point you start from.

Available skills catalog

The catalog is continuously expanding. Skills currently available:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
SkillIdentifierWhat it covers
Golden Path (Author, Items, Reports)golden-path-author-items-reportsThe core end-to-end integration path - authoring content, delivering an assessment, and reporting on results
Signature Generationgenerate-and-troubleshoot-request-signaturesSignature construction, HMAC-SHA256, SDK usage per language, and the common failure modes: localhost-vs-live domain mismatch, incorrect credentials, and encoded characters in keys or secrets
LTS Upgrade Pathslts-upgrade-pathsEnd-to-end upgrade methodology and common breaking changes, including multi-version jumps
Customise Assessment / UI Regionscustomise-assessment-ui-regionsAssessment player customisation - moving the table of contents, triggering standard and custom dialogs programmatically, and the core UI Region patterns
SDK Install / set-upinstall-and-set-up-the-sdkWorking with Learnosity supported SDKs (PHP, Python, Node.js, Ruby, Java, and .NET/C#) and pointing to the right direction
Content Migrationcontent-migrationData API migration patterns, @learnosity/lib-qti-converter import workflow, QTI conversion, and the SET ITEMS step required to make imported content visible in Authoring
Multi-Tenancymulti-tenancyCustomer segregation, recommended architecture patterns, and common pitfalls
Build Custom Questions and Featuresbuild-custom-questions-and-featuresBuilding a custom Question or Feature - choosing between the two, sequencing the module, scorer and authoring schema, hosting the built assets, and catching the failures that report nothing

Ask your assistant to list the currently available skills for an authoritative, up-to-date answer.

Example: Upgrade to a newer Learnosity LTS version

This illustrates the intended workflow. Exact assistant behavior varies by client and model.

1. Establish the upgrade path

\"Use the Learnosity Build Aide MCP LTS Upgrade Paths skill to plan an upgrade from the LTS version we're pinned to up to the current release. We're five versions behind.\"

The assistant retrieves the LTS Upgrade Paths skill and returns the upgrade methodology, the releases between your current and target version, and the breaking changes introduced at each one. A multi-version jump is returned as a sequence rather than a single hop, so you can see which release introduced each change.

2. Narrow the breaking changes to your integration

\"Which of those breaking changes affect Items API and Reports API? We don't use Author API.\"

The assistant filters the upgrade guidance to the APIs and features your integration actually uses, and cites the documentation behind each change so you can confirm the detail rather than taking it on trust.

If the upgrade also means moving to a newer SDK, ask for that skill directly:

\"Now use the SDK Install / set-up skill to show me how to move our Node.js SDK to the version that supports the target LTS.\"

3. Verify your configuration against the target version

\"Check my Items API initialization options against the target LTS and flag anything removed or renamed.\"

The assistant validates your initialization object against the published reference for the target version and flags options that have been removed, renamed, or given new defaults.

 

","user_segment_ids":[]},{"id":39537846634653,"url":"https://learnositysupport.zendesk.com/api/v2/help_center/en-us/articles/39537846634653.json","html_url":"https://help.learnosity.com/hc/en-us/articles/39537846634653-Learnosity-Build-Aide-MCP-security-data-handling-and-limitations","author_id":29234975706397,"comments_disabled":false,"draft":false,"promoted":false,"position":3,"vote_sum":0,"vote_count":0,"upvote_count":0,"downvote_count":0,"section_id":39503070619933,"created_at":"2026-09-30T08:59:15Z","updated_at":"2026-11-02T11:34:36Z","name":"Learnosity Build Aide MCP security, data handling, and limitations","title":"Learnosity Build Aide MCP security, data handling, and limitations","source_locale":"en-us","locale":"en-us","outdated":false,"outdated_locales":[],"edited_at":"2026-11-02T09:52:34Z","user_segment_id":null,"permission_group_id":89809,"content_tag_ids":[],"label_names":[],"body":"

Security and data handling

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ConcernHow it is handled
CredentialsThe server never requests, receives, or stores consumer keys or secrets. Signing happens entirely in your application.
AuthenticationNone required. The server exposes public documentation and guidance only. See Why Learnosity Build Aide MCP does not require authentication.
Write accessNone. Every tool is read-only, and no tool changes state.
Usage dataAnonymised operational metrics (tool name, timing, error type) are collected to monitor service health. Client identifiers are a keyed digest of the connecting address, which the server cannot reverse. Raw IP addresses are not retained in metrics.
Proprietary contentRaw documentation source files remain server-side. Clients receive structured responses, not the underlying corpus.

Note: Learnosity cannot control what you paste into your AI assistant, or how that assistant's model handles it. The MCP server itself will never ask for a secret - but standard practice applies: keep credentials in environment variables and out of your chat window, whatever tooling you are using.

Why Learnosity Build Aide MCP does not require authentication

The Learnosity Build Aide MCP server does not require authentication because it provides access only to publicly available Learnosity documentation and integration guidance. The server does not store credentials or sign API requests, and all available tools are read-only.

Rate limits help protect the service from excessive requests and maintain availability for users. For more information, see Rate limits.

This authentication model applies to the currently available tools and documentation sources. Introducing tools that modify data or provide access to nonpublic information would require a review of the authentication and security requirements.

Rate limits

MCP-protocol requests are rate limited at three levels to protect service quality for all users.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
LimitThresholdWindow
Per session20 requests5 seconds
Per client, across all sessions100 requests5 seconds
Global (all clients)900 requests5 seconds

When a limit is exceeded, the client receives a JSON-RPC error with code -32000. Health-check endpoints are not affected. The error message names the scope, the limit, and how long to wait before retrying.

These limits are set well above normal interactive use. A single developer working conversationally will not encounter them. If you are consistently hitting the per-session limit, it usually indicates an agent looping - check your assistant's tool-call behavior before assuming a service problem.

Content freshness

The server always serves current Learnosity documentation. It refreshes automatically from the published sources, so there is no local copy to maintain, no cache to clear, and no redeployment or client update required on your side.

Reporting a security issue

If you believe you have identified a security vulnerability in the Learnosity Build Aide MCP server, submit a support ticket and identify it as a security issue.

Include the affected tool or resource and the steps required to reproduce the issue.

The Learnosity support team forwards security reports directly to the Learnosity security team.

Do not use the Learnosity MCP feedback page to report security vulnerabilities. Submit a support ticket to ensure the issue is directed to the appropriate team.

Limitations

 

","user_segment_ids":[]},{"id":39539272308253,"url":"https://learnositysupport.zendesk.com/api/v2/help_center/en-us/articles/39539272308253.json","html_url":"https://help.learnosity.com/hc/en-us/articles/39539272308253-Troubleshooting-Learnosity-Build-Aide-MCP","author_id":29234975706397,"comments_disabled":false,"draft":false,"promoted":false,"position":4,"vote_sum":0,"vote_count":0,"upvote_count":0,"downvote_count":0,"section_id":39503070619933,"created_at":"2026-09-30T09:38:41Z","updated_at":"2026-11-02T11:34:21Z","name":"Troubleshooting Learnosity Build Aide MCP","title":"Troubleshooting Learnosity Build Aide MCP","source_locale":"en-us","locale":"en-us","outdated":false,"outdated_locales":[],"edited_at":"2026-11-02T10:00:39Z","user_segment_id":null,"permission_group_id":89809,"content_tag_ids":[],"label_names":[],"body":"

The Learnosity Build Aide MCP server does not show as Connected

    \n
  1. Fully restart your client. Some clients do not pick up newly installed MCP servers on reload alone.
    2. \n
  2. Check outbound HTTPS access to mcp.learnosity.com - corporate proxies and VPNs are a frequent blocker.
    3. \n
  3. Confirm the server is enabled in your client's MCP panel. Some clients install a server in a disabled state.
    4. \n
  4. If you connected manually rather than through a marketplace, validate your configuration - see Connect to Learnosity Build Aide MCP manually under the Getting started with Learnosity Build Aide MCP article.
    5. \n

The AI assistant does not use Learnosity Build Aide MCP to answer questions

Name it explicitly: \"Using the Learnosity Build Aide MCP, …\". Most clients also provide a way to inspect which tools were called for a given response - worth checking if answers seem generic.

A search returned fewer results than expected, with a golden path alert

Learnosity Build Aide MCP may withhold search results for a lower-level API when the golden path gate is triggered. Review the golden path alert to see which results were withheld. If you need to use the lower-level API, run the search again and set off_golden_path_reason to the reason for using that API.

For more information, see Search and the golden path gate in the Using Learnosity Build Aide MCP article.

I receive an unknown source error

The source identifier is not recognized by the Learnosity Build Aide MCP server. Ask your AI coding assistant to call list_docs_sources to retrieve the available source identifiers.

Source identifiers use underscores, such as help_site, while resource URIs use hyphens, such as help-site.

I receive an article not found error

The article identifier is not available in the current documentation index. Run the search again to retrieve the current article identifier.

I receive a JSON-RPC -32000 error

You have hit a rate limit. Wait a few seconds and retry. If it recurs during ordinary use, your assistant is likely looping tool calls.

The response received is incorrect or incomplete

Please report it. Documentation gaps are the single largest source of incorrect agent answers, and specific reports are the fastest route to a fix. See Provide Feedback.

 

","user_segment_ids":[]},{"id":39542230495517,"url":"https://learnositysupport.zendesk.com/api/v2/help_center/en-us/articles/39542230495517.json","html_url":"https://help.learnosity.com/hc/en-us/articles/39542230495517-Frequently-asked-questions","author_id":29234975706397,"comments_disabled":false,"draft":false,"promoted":false,"position":5,"vote_sum":0,"vote_count":0,"upvote_count":0,"downvote_count":0,"section_id":39503070619933,"created_at":"2026-09-30T11:07:19Z","updated_at":"2026-11-02T11:34:10Z","name":"Frequently asked questions","title":"Frequently asked questions","source_locale":"en-us","locale":"en-us","outdated":false,"outdated_locales":[],"edited_at":"2026-11-02T10:00:20Z","user_segment_id":null,"permission_group_id":89809,"content_tag_ids":[],"label_names":[],"body":"

Does it cost anything?

No. The Learnosity Build Aide MCP server is provided at no cost.

Do I need a Learnosity account or API credentials to connect?

No. The server requires no authentication. You will need credentials to run the integration you build, but not to use the MCP server.

Which AI assistants and IDEs are supported?

Any client supporting the MCP HTTP transport. This includes VS Code, Cursor, Kiro, and Claude Code, among others - all of which have been tested.

How many tools does the server expose?

The Learnosity Build Aide MCP server exposes eight tools. The list_docs_sources, list_docs_categories, search_docs_sources, and read_document tools provide access to documentation. The skills_list, skills_read, and skills_search tools provide access to Skills. The get_feedback_link tool provides a link for sharing feedback.

For more information, see Tools in the Using Learnosity Build Aide MCP article.

What is the difference between tools and resources?

Tools and resources provide access to the same content in different ways. Your AI coding assistant calls tools, while resources are accessed using a learnosity:// URI. Search results include both an article identifier and the corresponding resource URI.

Why did my search return a golden path alert?

A golden path alert can appear when your search query or its results reference a lower-level API. The alert recommends the corresponding API from the Learnosity golden path and can indicate when results for the lower-level API have been withheld.

For more information, see Search and the golden path gate.

Can I turn the golden path gate off?

No. To retrieve results for a lower-level API when the golden path gate withholds them, set off_golden_path_reason to the reason your integration requires that API. Specify the parameter on each applicable search request because the value does not persist between requests.

Can it write code for me?

Your assistant writes the code. The MCP server supplies accurate Learnosity knowledge for it to work from - which is the difference between code that runs and code that looks like it should.

Will it sign my requests?

No, and this is deliberate. Signing requires your secret, and your secret should never leave your environment. The server explains signing thoroughly; your application performs it.

How current is the information?

The documentation index refreshes every 24 hours from the published Learnosity sources, so answers reflect the current documentation.

Which documentation does it cover?

The Learnosity Help site, the Author Guide site, Feedback Aide backend documentation, the Learnosity Demos site, and Learnosity's public GitHub repositories. For more information, see Documentation available through Learnosity Build Aide MCP in the Using Learnosity Build Aide MCP article.

Does it support version-specific (LTS) guidance?

Yes, LTS-aware guidance is supported, and the LTS Upgrade Paths Skill is built around it. Coverage continues to expand as version-aware documentation rolls out.

Is my code or prompt data sent to Learnosity?

Only the tool your assistant calls reaches the server. Learnosity collects anonymised operational metrics - tool name, timing, error type - to monitor service health. Your source code is not transmitted.

What if a Skill I need does not exist yet?

The catalog is driven directly by customer pain points. Tell us what you need - see Provide Feedback.

 

","user_segment_ids":[]},{"id":39542355295389,"url":"https://learnositysupport.zendesk.com/api/v2/help_center/en-us/articles/39542355295389.json","html_url":"https://help.learnosity.com/hc/en-us/articles/39542355295389-Provide-Feedback","author_id":29234975706397,"comments_disabled":false,"draft":false,"promoted":false,"position":6,"vote_sum":0,"vote_count":0,"upvote_count":0,"downvote_count":0,"section_id":39503070619933,"created_at":"2026-09-30T11:11:27Z","updated_at":"2026-11-02T11:33:34Z","name":"Provide Feedback","title":"Provide Feedback","source_locale":"en-us","locale":"en-us","outdated":false,"outdated_locales":[],"edited_at":"2026-09-30T23:42:08Z","user_segment_id":null,"permission_group_id":89809,"content_tag_ids":[],"label_names":[],"body":"

The skills catalog is prioritized from real integration problems reported by real customers. If something is missing, wrong, or harder than it should be, that is useful information.

There are two ways to reach us:

When reporting, the most helpful detail is:

 

","user_segment_ids":[]},{"id":40294187430045,"url":"https://learnositysupport.zendesk.com/api/v2/help_center/en-us/articles/40294187430045.json","html_url":"https://help.learnosity.com/hc/en-us/articles/40294187430045-Learnosity-Build-Aide-MCP-Terms-of-Service","author_id":29234975706397,"comments_disabled":false,"draft":false,"promoted":false,"position":7,"vote_sum":0,"vote_count":0,"upvote_count":0,"downvote_count":0,"section_id":39503070619933,"created_at":"2026-10-30T11:43:40Z","updated_at":"2026-11-02T11:33:15Z","name":"Learnosity Build Aide MCP: Terms of Service","title":"Learnosity Build Aide MCP: Terms of Service","source_locale":"en-us","locale":"en-us","outdated":false,"outdated_locales":[],"edited_at":"2026-10-30T11:43:55Z","user_segment_id":null,"permission_group_id":89809,"content_tag_ids":[],"label_names":[],"body":"

The Learnosity Build Aide MCP makes Learnosity's published documentation and integration guidance available through the Model Context Protocol (MCP). Third-party AI agents can use it to help you build with Learnosity.

Read the information below before you use the Learnosity Build Aide MCP.

Availability

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.

Third-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.

Changes/rate limits

Learnosity may apply reasonable rate limits and may modify, suspend or discontinue the Learnosity Build Aide MCP from time to time.

Personal 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.

","user_segment_ids":[]}],"sort_by":"position","sort_order":"asc"}