Lyearn MCP capability reference

Read operations and saved proposals

The company, people, learning, productivity, relationship, and analytics tools below retrieve information. The two organisation proposal tools save reviewable records in Lyearn. An administrator reviews and publishes accepted organisational changes.

Using the reference

You can ask questions in plain language; you do not need to name a tool. Your AI app selects tools from the capabilities exposed to your connection. For integrations that inspect the MCP interface directly, use tools/list for the current exposed names, descriptions, and input schemas.

Company knowledge

Tool	What it does
`companyProfile`	Read the company profile recorded in Lyearn, including its business and industry context.
`companyKnowledge`	List or filter recorded products, competitors, capabilities, risks, metrics, markets, segments, initiatives, and strategy.
`knowledgeRetrieve`	Search recorded company knowledge by topic or question.

People and organisation

Tool	What it does
`findPeople`	Find people by name, email, team, role, or location.
`findLocations`	Explore workplaces, their hierarchy, and position occupancy.
`findPositions`	Find filled or vacant positions, including roles currently open for hire.
`getJobArchitecture`	Explore job families and profiles.
`getOrgTree`	Read the organisation hierarchy, unit heads, filled positions, and open positions.
`getReportingChain`	Follow a current management chain or reporting subtree.
`getOrgChanges`	Read recorded changes to the organisation over a time period.
`getRelationshipHistory`	Review the recorded history of reporting, position, or unit relationships.
`orgBriefing`	Get an overview of structure, management spans, layers, findings, and open drafts.
`runOrgReport`	Run headcount, management-span, organisational-depth, or structural-anomaly reports.

Learning resources

Tool	What it does
`listLearningContent`	Find accessible learning items by title or type.
`getLearningContentDetails`	Read a learning item’s description, objectives, structure, skills, duration, certificate information, and your status where available.
`searchLearningContent`	Find passages across accessible, searchable course and article material.
`askLearningContent`	Ask a question about the searchable material in one course or article.
`summarizeLearningContent`	Summarise one course or article from its searchable material.
`recommendLearningContent`	Find relevant learning resources using a learning focus, role requirements, and available profile information.

Learning profiles and activity

Tool	What it does
`getLearnerProfile`	Read role context, required and preferred skills, and available MGSA information.
`getLearnerActivity`	Review enrolments, learning status, progress, and due or completion dates.
`getCompanyLearningActivity`	Review team or company learning activity, including completion and overdue counts.
`getContentLearners`	Review who is enrolled in a learning item and their progress.
`getCertificates`	List certificates earned by a learner.
`getBadges`	List badges earned by a learner.
`getPoints`	Review a learner’s points and recent awards.

Productivity and insights

Tool	What it does
`productivityBriefing`	Explore enabled productivity models, available analyses, and scoring coverage.
`listModels`	List enabled productivity models and their identifiers.
`describeSubject`	Inspect the metrics and relationships a model defines for a subject type.
`getAttributes`	Read a subject’s recorded attributes, such as role, region, or organisational context.
`getMetrics`	Read the current metric values available for a subject in a model.
`getMgsa`	Read available overall and dimension-level MGSA scores.
`getLatestMgsa`	Inspect the latest scoring breakdown, underlying metric values, and evidence coverage.
`listPersonsByMgsa`	Find people whose latest overall MGSA score falls within a requested band, where permitted.
`benchmarkMetric`	Compare an available metric with peers in the same role and region.
`getInsights`	Read current or historical insight records about a subject.
`getPriorInsights`	Read previously delivered guidance that remains valid.
`getTimeline`	Review recent recorded interactions and outcomes.
`getRelated`	Explore entities connected to a subject through a supported relationship.
`describeAnalyses`	List the population analyses available in a model and their supported inputs.
`runAnalysis`	Run one of a model’s defined analyses with supported parameters and filters.

Entity and relationship lookup

Tool	What it does
`describeSchema`	Inspect the available entity types and relationships.
`findEntities`	Find an entity by type and name.
`getNode`	Read an entity’s recorded attributes and description.
`getNeighbors`	Inspect recorded relationship edges and their confidence information.

Analytics

Tool	What it does
`listAnalyticsReports`	Discover available analytics reports and what each report covers.
`describeAnalyticsReport`	Inspect a report’s columns, aggregations, filters, and access scope.
`listAnalyticsValues`	Inspect available values in a report column before filtering.
`runAnalyticsReport`	Run a supported report query using grouping, aggregation, filtering, and sorting.
`listSavedReports`	List saved reports you own or that are shared with you.
`runSavedReport`	Run a saved report with its saved columns, filters, and sorting.
`listDashboards`	Find dashboards and their listed tiles.

Organisation proposals and drafts

Tool	What it does
`createOrgDraft`	Save a named draft of proposed organisational changes for human review.
`proposeOrgChanges`	Submit proposed corrections to the organisation’s review queue.

Access and interpretation

Learning resources are limited to the accessible library. Reading another person’s learning information requires the relevant team or organisation-wide permission. Productivity metrics depend on enabled models and available evidence; an absent score is unavailable information rather than a score of zero.

Organisational headcount can count filled positions rather than all people on record. Reports and searches may return limited or paginated results. Use any completeness or data-quality notices when interpreting the answer.

Important limits

Capability	Limit or behaviour
Course and article search or summaries	Require searchable material. Listing another learning format does not establish that its full content can be searched or summarised.
Learning recommendations	Exclude resources the learner has already started or completed.
Analytics report queries	Return up to 12 grouped or result rows per run. Ask for aggregation when you need totals.
Model analyses	Use defined analyses and supported parameters; arbitrary analyses are not available through runAnalysis.
Organisation drafts	A named draft can contain up to 200 proposed changes. Each change remains subject to human review.
Organisation history	An empty history can mean no events are recorded; it does not prove that no changes occurred.

Support

For questions about tool access or results, contact support@lyearn.com. Include the tool or capability involved and any error or correlation ID, if provided.

Get connectedRead the setup guide