Tools reference

Once connected, your assistant has the tools below. They map directly to the REST API, so the responses and the permission rules are identical. All are read-only.

search_mereon

Search the organization’s business knowledge base (processes, policies, facts, and source documents and transcripts). This is usually the first tool to call: it returns type-tagged results with snippets, relevance scores, and web links.

Input	Type	Notes
query	string	Natural-language search query. Required.
types	string[]	Restrict to topic and/or chapter. Defaults to all.
limit	number	Max results, 1–50. Default 10.

get_topic

Fetch a knowledge topic by id: its description, category, the items under it (processes, policies, facts), and related topics. Use after search_mereon to read a topic in full.

Input	Type	Notes
topicId	string	Topic id from search results or related topics. Required.

get_item

Fetch a single item (process, policy, or fact) by id, including its child items and the source evidence backing it: quotes, video timestamps, document ranges, and confidence, with links to the original content.

Input	Type	Notes
itemId	string	Item id from a topic’s items list. Required.

get_content

Fetch a single content resource by id: its title, type (document, video, or guide), summary, duration (for video), and link. Use to look up a resource’s metadata once you have its id. For the full wording use get_content_text; to find a resource by title use list_content.

Input	Type	Notes
contentId	string	Content id from search results, list_content, or item evidence. Required.

get_content_text

Fetch the full text of a source document, or the transcript of a video, split into chapters. Use when search snippets are not enough and you need the original wording.

Input	Type	Notes
contentId	string	Content id from search results or item evidence. Required.

get_duties

Find who is Responsible, Accountable, Consulted, or Informed for a topic, item, space, or category, including duties inherited from parent entities. Answers “who owns this process” and “who should I ask about this”.

Input	Type	Notes
entityType	string	One of TOPIC, ITEM, SPACE, CATEGORY. Required.
entityId	string	The entity id. Required.

list_issues

List the organization’s data-quality issues (conflicts, duplicates, content and structure gaps, stale or misclassified knowledge), most recent first.

Input	Type	Notes
status	string	OPEN, IN_PROGRESS, RESOLVED, or DISMISSED.
type	string	CONFLICT, DUPLICATE, MISCLASSIFICATION, STALE, CONTENT_GAP, STRUCTURE_GAP, or OTHER.
severity	string	CRITICAL, HIGH, MEDIUM, or LOW.
assignedToMe	boolean	Only issues assigned to the connected user, either directly or through a role they currently hold.
cursor	string	Pagination cursor from a previous response.
limit	number	Max issues, 1–100. Default 50.

get_content_knowledge

List the topics a resource contributed knowledge to, with how many items came from it. Use to answer “what did we learn from this document” without reading the whole text.

Latest-only: archived and superseded records are excluded, so this is what the resource currently supports.

Input	Type	Notes
contentId	string	Content id, from search results or list_content.

get_content_usage

List what depends on a resource: the lessons that teach it, and the topics it is the only evidence for. Use before suggesting a change to a document — the sole-evidence topics are the ones that would lose their basis without it.

Lessons are limited to the ones you can see. Each list carries a true count plus a preview of at most 20 entries.

Input	Type	Notes
contentId	string	Content id, from search results or list_content.

list_third_parties

List the external organizations that hold duties in this knowledge base — vendors, contractors, regulators. They own areas of the work alongside internal roles.

Takes no inputs.

get_third_party

Read one third party. For what it answers for, use list_third_party_duties.

Input	Type	Notes
thirdPartyId	string	Third party id, from list_third_parties.

list_third_party_duties

List everything a third party answers for: each topic, item, space, or category it holds a duty on, the level, and whether the duty is inherited from an ancestor rather than assigned directly.

This is the holder’s side of get_duties, which instead names who owns a given topic. Limited to entities you can read.

Input	Type	Notes
thirdPartyId	string	Third party id, from list_third_parties.
entityType	string	Restrict to TOPIC, ITEM, SPACE or CATEGORY.
cursor	string	Pagination cursor from a previous response.
limit	number	Rows per page, 1–100. Default 50.

list_role_duties

List everything a role answers for, in the same shape as list_third_party_duties. Each row also carries how far the duty reaches across the role’s advancement path, so a duty covering only senior levels is distinguishable from one covering the whole role.

A duty on a topic inherits down to every item on that topic, so an unfiltered list is mostly item rows. Pass entityType: "TOPIC" for the summary a person would recognize.

Input	Type	Notes
companyRoleId	string	Company role id, from list_company_roles.
entityType	string	Restrict to TOPIC, ITEM, SPACE or CATEGORY.
cursor	string	Pagination cursor from a previous response.
limit	number	Rows per page, 1–100. Default 50.

list_categories

List the organization’s categories, with the titles and descriptions it uses itself. Categories are the top of the structure — a category holds spaces, a space holds topics, a topic holds items — so start here when you do not know where a subject lives.

Takes no inputs.

get_issue

Read one data-quality issue in full. Each target carries the affected content itself (an item target’s block type and text), so you can explain what conflicts, duplicates, or is stale rather than only naming it. Closed issues carry the resolution strategy.

Input	Type	Notes
issueId	string	Issue id, from list_issues.

list_spaces

List the spaces the organization’s knowledge is grouped into. A category holds spaces, a space holds topics, so this is how to see the shape of the graph before drilling into it.

Input	Type	Notes
categorySlug	string	Restrict to one category, e.g. operations, hr, finance. An unrecognized slug is an error rather than a silent match-everything.

get_space

Read one space and the topics it groups. Topics are limited to those you can see, and to the current graph (nothing archived or superseded).

Input	Type	Notes
spaceId	string	Space id, from list_spaces.

list_content

List viewable content resources (documents, videos, audio, and guides), most recent first. Use to find a specific resource by name or browse a type. For questions about what the content says, use search_mereon instead.

Input	Type	Notes
query	string	Title keywords. Every word must appear in the title, any order, case-insensitive.
type	string	Restrict to one of document, video, guide.
cursor	string	Pagination cursor from a previous response.
limit	number	Max resources, 1–100. Default 50.

list_lessons

List lessons in the catalog (authored training units), most recent first. For the raw source videos and documents use list_content; for what the material says use search_mereon.

Input	Type	Notes
query	string	Title keywords. Every word must appear in the lesson title.
cursor	string	Pagination cursor from a previous response.
limit	number	Max lessons, 1–100. Default 50.

get_lesson

Fetch one lesson in detail: its metadata and the source content pieces it teaches, in order.

Input	Type	Notes
lessonId	string	The lesson id. Required.

list_company_roles

List the organization’s company roles (named org-chart positions), sorted alphabetically by name. Each result carries how many people hold the role and the role it reports to. Available only when the connected user can read the org chart.

Input	Type	Notes
query	string	Case-insensitive match on the role name.
cursor	string	Pagination cursor from a previous response.
limit	number	Max roles, 1–100. Default 50.

get_company_role

Fetch one company role in detail: its reporting parent and member count, its training curriculum (the lessons and topics everyone in the role must complete), and its current members.

Input	Type	Notes
companyRoleId	string	The company role id. Required.

list_content_review_requests

List content-review requests — proposed content and issue-resolutions awaiting (or past) review. A reviewer sees the whole organization’s queue; everyone else sees only their own submissions (pass mine=true to force that). Requires content-review read access.

Input	Type	Notes
status	string	PENDING, APPROVED, REJECTED, CHANGES_REQUESTED, CANCELED, or SUPERSEDED.
resourceType	string	document, video, audio, or guide.
kind	string	content, content-resolves-issue, or issue-only.
submitterId	string	Reviewers only: restrict to one submitter.
mine	boolean	Only the connected user’s own submissions.
cursor	string	Pagination cursor from a previous response.
limit	number	Max requests, default 50 (max 100).

get_content_review_request

Fetch one content-review request by id: its workflow state, the content or issue it concerns, the submitter and reviewer, and any notes. A reviewer can read any request in the org; everyone else only their own.

Input	Type	Notes
requestId	string	The content-review request id. Required.

get_maturity

Get the organization’s knowledge-base maturity: its level (UNDOCUMENTED → OPTIMIZED), the signals behind it (topic ownership, structured content, verification cadence, category coverage, open issues), and ranked recommendations for what to improve next. Readable by any member who can read the organization.

Input	Type	Notes
categorySlug	string	Scope to one category (e.g. operations, hr). Omit for org-wide maturity.

list_category_health

List every category (always 14) with its maturity level, or null when the category has too few topics to score. The “which areas are weakest” overview. Readable by any member who can read the organization. No inputs.

Note

Tools return the same data as their REST equivalents, scoped to what the connected user can see and always reflecting the latest state of the knowledge base. See Lifecycle & history for how superseded and archived records are handled.