Category

How to Manage Knowledge Base Content Using the BoldDesk MCP Server

Updated:

The hosted BoldDesk MCP Server enables users to manage Knowledge Base content through natural language conversations with AI using the Model Context Protocol (MCP). Users can perform a wide range of Knowledge Base operations, including creating, retrieving, searching, listing, and updating articles, as well as creating, retrieving, and updating categories and reviewing the Knowledge Base category and section hierarchy.

There is no need to manually select or execute individual MCP tools. Simply describe the Knowledge Base task you want to perform and provide the relevant details, such as the article, category, brand, location, or content. The AI automatically determines and executes the appropriate BoldDesk MCP operations required to fulfill the request.

All Knowledge Base operations are performed using the identity, permissions, and brand access associated with the BoldDesk agent account whose API key is configured for the MCP connection.

This article outlines the supported Knowledge Base capabilities, the information to provide when working with AI, current limitations, and troubleshooting guidance.

Prerequisites

Before using the Knowledge Base capabilities of the BoldDesk MCP Server, ensure that:

  • AI is connected to the hosted BoldDesk MCP Server.
  • A valid BoldDesk API key is configured for the connection.
  • The API key was generated by a licensed BoldDesk agent.
  • The authenticated agent has the required Knowledge Base permissions.
  • The authenticated agent has access to the applicable brand.
  • The required Knowledge Base capabilities appear under Tools from this server.
  • The required category or section exists when creating an article, unless the category will also be created as part of the request.
  • MCP operations use the authenticated BoldDesk agent’s identity, permissions, and brand access.
  • Use an agent account with only the Knowledge Base permissions and brand access required for the intended operations.

Understand the Supported Knowledge Base Capabilities

The BoldDesk MCP Server provides tools for managing Knowledge Base articles, categories, and the content hierarchy.

Knowledge Base Article Tools

Tool Purpose
create_kb_article Creates a Knowledge Base article and returns the created article’s ID and details.
get_kb_article_details Retrieves the complete details of a Knowledge Base article by ID.
list_kb_articles Retrieves a paginated list of Knowledge Base articles using supported filtering, sorting, and view-based queries.
search_kb_articles Searches Knowledge Base articles using free text and returns paginated matching results.
update_kb_article Updates the content of an existing Knowledge Base article.

Knowledge Base Category and Hierarchy Tools

Tool Purpose
create_kb_category Creates a Knowledge Base category used to organize articles and sections.
get_kb_category_details Retrieves the details of a Knowledge Base category.
update_kb_category Updates an existing Knowledge Base category.
get_section_tree_view Retrieves the Knowledge Base category and section hierarchy as a tree, optionally filtered by brand.
  • The available tools, parameters, and supported properties can change as the BoldDesk MCP Server is updated.
  • Use only the capabilities currently displayed under Tools from this server.

Understand How Knowledge Base Operations Work

A typical Knowledge Base operation follows this sequence:

  1. AI connects to the hosted BoldDesk MCP Server.
  2. The connection is authenticated using a BoldDesk API key.
  3. AI discovers the tools available from the server.
  4. The user describes the required Knowledge Base operation.
  5. AI determines which available operation or combination of operations is required.
  6. BoldDesk validates the authenticated agent’s permissions and brand access.
  7. The permitted operation is completed.
  8. The result is returned to the user.

For example, when an article must be updated, AI can locate the article, retrieve its complete content, apply the requested changes, and retrieve the article again to verify the saved result.

  • The MCP connection does not bypass BoldDesk role permissions, Knowledge Base permissions, brand access, or content controls.
  • AI can perform only the operations available through the MCP Server and permitted for the authenticated agent.

What to Consider When Communicating with AI

Clearly describe the required outcome and provide the information needed to complete the operation accurately. You do not need to mention an MCP tool name because AI determines which available BoldDesk MCP operations are required.

Knowledge Base Operation Information to Provide Important Considerations
Review the Knowledge Base hierarchy Brand, article topic, preferred category or section, visibility requirement, and any known category name Review the hierarchy when the correct content location is unknown, a category or section ID is required, or an existing category must be confirmed. This helps prevent content from being placed under the wrong brand, category, or section.
Create a Knowledge Base category Category name, description, brand, visibility, expected content, and related categories Confirm that an equivalent category does not already exist. After creation, verify the Category ID, name, description, brand, visibility, and position in the hierarchy.
Retrieve category details Category ID or the exact category name and brand when the ID is unavailable Use the Category ID whenever possible. Review the category name, description, brand, visibility, and other available settings before requesting an update.
Update a Knowledge Base category Category ID, properties to change, properties to preserve, and expected result Retrieve the current category details first. Specify exactly what must change, require all unrelated settings to remain unchanged, and retrieve the category again to verify the saved result.
Search for Knowledge Base articles Exact or partial title, product or feature name, error message, error code, configuration name, Article ID, brand, category, and relevant keywords Use specific search terms. For example, 550 5.7.1 transport rule rejection is more precise than email issue. Review additional result pages when the required article is not shown initially.
List Knowledge Base articles Number of articles, page size, brand, view, supported filters, sort field, sort order, and review purpose Use listing when reviewing a collection of articles. Use search when looking for content about a particular title, topic, feature, or error code.
Retrieve article details Article ID or the exact title and brand when the ID is unavailable Retrieve the complete article before requesting changes. Review its title, content, brand, category, section, visibility, available status information, and other returned settings. Do not rely only on a search-result summary or list preview.
Create a Knowledge Base article Title, complete content, brand, category or section, visibility, intended audience, technical references, and required status when supported Search for related content first, review the hierarchy, confirm the destination, and verify links, navigation paths, limits, warnings, and code samples. After creation, retrieve the article and confirm that it was saved in the correct location.
Update a Knowledge Base article Article ID, exact section to update, confirmed new information, outdated content to remove, content to preserve, required links, formatting requirements, and expected result Retrieve the complete article first. Modify only the requested content, avoid adding duplicate information, preserve unrelated sections and formatting, and retrieve the article again to verify the saved changes.
Add information to an article Article ID, destination section, exact information to add, and content that must remain unchanged Confirm that the information is not already present. Place the new content in the most relevant existing section instead of creating a duplicate section.
Correct outdated information Article ID, outdated statement, confirmed replacement, supporting reference, and affected section Replace the outdated statement without changing unrelated confirmed content. Check the Frequently Asked Questions, troubleshooting guidance, notes, and warnings for other instances of the same outdated information.
Remove duplicate content Article ID, repeated content, preferred version, and sections containing the duplicated information Retain the clearest and most complete version. Remove repeated wording without deleting unique information or required context.
Improve article clarity Article ID, sections to improve, intended audience, preferred tone, and confirmed technical information to preserve Improve structure and wording without changing the article’s technical meaning, documented behavior, limitations, navigation paths, or supported values.
Improve RAG friendliness Article ID, relevant sections, required terminology, confirmed product behavior, and content that must remain unchanged Use explicit headings, precise BoldDesk terminology, self-contained explanations, direct answers, and clear limitations. Avoid ambiguous references, unexplained pronouns, and incomplete descriptions.
Find and update an existing article Topic, expected article, confirmed update, content to preserve, and verification requirement Search first, retrieve the most relevant article, apply only the confirmed change, preserve unrelated content, and verify the saved result.
Avoid duplicate articles Proposed title, topic, feature names, error codes, relevant keywords, and criteria for determining whether an article is suitable Create a new article only when no existing article answers the requirement or can accept the required addition without changing its intended scope.
Create an article in the correct location Brand, topic, intended audience, category requirements, visibility, complete content, and any preferred section Review the hierarchy and existing related content before creation. Confirm the final brand, category, section, and visibility after the article is created.
Create a category and article Category criteria, duplicate-category check, brand, visibility, article title, complete article content, and intended audience Create the category only when no suitable category exists. Verify the category before creating the article under it.
Update a category safely Category ID, current details, exact properties to change, settings to preserve, and expected result Retrieve the category first, confirm its identity, apply only the requested changes, and verify the saved category afterward.
Review recently modified articles Date range, number of articles, page size, brand, sort order, and review criteria Define what the review should identify, such as outdated navigation, missing limitations, duplicate content, broken links, SEO improvements, or RAG-friendliness issues.
Find content by error code Exact error code, complete error text when available, related product or feature, brand, and expected article type Search using the exact code first, and then use distinctive parts of the accompanying message. Avoid broad terms such as error or failure.
Improve an article without changing its meaning Article ID, sections to improve, confirmed information to preserve, intended audience, and required writing style Require all confirmed product behavior, technical limitations, supported values, links, and navigation paths to remain accurate after the revision.
  • Search for existing content before creating a Knowledge Base article. If an existing article already covers the requirement, update that article instead of creating duplicate documentation.
  • Before updating an article, retrieve its complete content and clearly identify what must change and what must remain unchanged. Do not replace a complete article with a partial revision.

Troubleshooting

An Article Cannot Be Created

Verify that:

  • The authenticated agent has permission to create articles.
  • The selected brand is accessible to the agent.
  • The destination category or section exists.
  • The category or section identifier is correct.
  • All required article values were provided.
  • The provided values use formats supported by the server.

An Article Cannot Be Retrieved

Verify that:

  • The Article ID is correct.
  • The article exists.
  • The authenticated agent can access the article.
  • The article belongs to a brand accessible to the agent.
  • The article has not been permanently removed.

An Article Cannot Be Updated

Verify that:

  • The correct Article ID was provided.
  • The article exists.
  • The authenticated agent can edit the article.
  • The article belongs to an accessible brand.
  • The requested change uses supported properties and values.
  • The current article state permits the requested change.

The Article Was Added to the Wrong Location

Review the Knowledge Base category and section hierarchy before future article-creation requests.

If the available MCP tools do not provide a supported way to move the article, correct the category or section through the BoldDesk Knowledge Base interface.

Frequently Asked Questions

  1. Must I Search Before Creating an Article?
    Searching is strongly recommended because it helps identify existing content and prevents duplicate articles.

  2. Should I Retrieve an Article Before Updating It?
    Yes. Retrieving the complete article allows existing content to be preserved while only the required information is modified.

  3. Are MCP Operations Restricted by BoldDesk Permissions?
    Yes. MCP operations use the authenticated agent’s identity, Knowledge Base permissions, and brand access.

  4. Can AI Update an Article Without Human Review?
    An update can be performed when the authenticated agent has the required permission. However, human review is recommended before changing public or business-critical documentation.

Related Articles

  1. Overview of BoldDesk MCP Server
  2. List of Available MCP Tools in BoldDesk
  3. How to Create and Manage Knowledge Base Articles in BoldDesk
  4. Get Started with Knowledge Base in BoldDesk
  5. Generate and Manage API Keys in BoldDesk
Was this article useful?
Like
Dislike
Help us improve this page
Please provide feedback or comments
Comments (0)
Access denied
Access denied
Access denied
Access denied

No articles or sections found
No articles or sections found