# KnowledgeOwl MCP MCP

> KnowledgeOwl connects your AI client directly to a professional knowledge base. Use this MCP to search support documentation, audit category structures, and retrieve specific article content instantly. It lets you manage an entire help center's data—from project settings to glossary terms—without leaving your agent's chat window.

## Overview
- **Category:** customer-support
- **Price:** Free
- **Tags:** help-center, documentation, knowledge-base, content-retrieval, support-automation

## Description

Okay, so here’s the deal. If your job involves anything with structured documentation, this MCP is for you. Instead of clicking through five different internal tabs just to find out what a specific product term means or how a category is organized, you talk to your agent. Your AI client handles the complexity; it knows whether you need the full text from an article or if you just want to list all available categories in the project.

This MCP gives your agent deep access into the knowledge base's architecture. You can run smart searches against all help center content, and if that’s not enough, you can ask it to check the underlying structure—like listing custom fields or reviewing template options. It keeps documentation consistent by letting you pull project-wide settings directly. Connecting this through Vinkius means you get full access to the catalog's power from any compatible client, making content management feel like a conversation.

## Tools

### list_kb_articles
Generates a list of every article currently stored in the knowledge base for review or browsing.

### get_article_content
Retrieves the complete, detailed text for a single specified article.

### list_kb_categories
Outputs a complete list of all top-level and sub-categories defined within the project structure.

### get_category_details
Fetches specific information about one designated content category.

### search_help_center
Performs a general search across all articles in the help center based on natural language input.

### list_kb_glossary
Retrieves a comprehensive list of all defined terminology and their official definitions.

### list_project_settings
Displays global project configurations, such as access controls or branding parameters.

### list_article_templates
Lists all available document templates, helping you know what format to use when writing new content.

### list_kb_custom_fields
Lists every custom data field you've added to track specific metadata about your articles.

### get_kb_project_info
Gets high-level system details and settings for the entire knowledge base project.

## Prompt Examples

**Prompt:** 
```
Search my help center for 'SSO setup'
```

**Response:** 
```
I've found 3 articles about SSO setup: 'Configuring SAML 2.0', 'Okta Integration Guide', and 'Troubleshooting Login Issues'. Which one would you like me to read for you?
```

**Prompt:** 
```
List all categories in my Knowledge Base
```

**Response:** 
```
Your knowledge base has 5 main categories: 'Getting Started', 'User Management', 'API Reference', 'Billing', and 'Integrations'. I can explore any of these for you.
```

**Prompt:** 
```
Get the content of the article with ID 'art_123'
```

**Response:** 
```
Retrieved content for 'User Management Policy'. The article covers user roles, permission levels, and invited user limitations. Would you like a summary of the roles section?
```

## Capabilities

### Search Help Center Content
Find relevant articles across your entire knowledge base using natural language queries.

### Retrieve Article Details
Get the complete, detailed text content for any specific help article.

### Audit Content Structure
List and examine your category hierarchy to ensure documentation is properly grouped.

### Examine Project Metadata
Access high-level project data, including settings, custom fields, and glossary terms for consistency checking.

### Browse Content Types
List available article templates or examine the existing collection of articles within the base.

## Use Cases

### A developer needs to know what data points are available.
The dev asks their agent: 'What unique pieces of metadata can I attach to articles?' The agent calls `list_kb_custom_fields` and reports back the list, saving the developer from having to check the admin panel themselves.

### A support rep needs policy details for a niche product.
The rep asks: 'What is our official stance on SSO setup?' The agent uses `search_help_center` and retrieves key articles, providing immediate links to the most relevant documentation.

### A content manager needs to audit the category structure.
The manager asks: 'Show me the full map of our support topics.' The agent calls `list_kb_categories`, giving a clear, hierarchical breakdown that helps them identify orphaned or poorly grouped material.

### A team is updating old documentation and needs to check definitions.
The writer asks: 'What does 'user consent' mean in our official vocabulary?' The agent uses `list_kb_glossary` to pull the precise, approved definition from the knowledge base.

## Benefits

- Search results are precise. Instead of just getting a list of articles, the `search_help_center` tool lets your agent find exactly what you mean, minimizing manual cross-referencing.
- Maintain consistency across departments. You can check project standards instantly by calling `list_project_settings`, ensuring all documentation adheres to global rules before publishing.
- Never get lost in the folder structure again. Use `list_kb_categories` to map out your entire content flow, confirming that every topic has a designated home.
- Quickly update terminology. If a product name changes, you can verify its official definition and scope using `list_kb_glossary`, keeping all documentation accurate immediately.
- Build better articles from day one. By calling `list_article_templates`, your agent helps guide you toward the correct format for new content, saving time on formatting checks.

## How It Works

The bottom line is, your agent uses this connection to turn vague questions about documentation into precise, actionable data retrieval tasks.

1. First, subscribe to this MCP and input your KnowledgeOwl API key into your client's configuration.
2. Then, use natural language prompts with your agent. You don't need to know the exact tool name; you just ask for what you need (e.g., 'What are my main categories?').
3. The MCP translates that request into the correct function call and returns structured data—whether it’s a list of articles or the full text of one.

## Frequently Asked Questions

**How do I search my help center using the `search_help_center` tool?**
You simply ask your agent what you're looking for, like 'Tell me about SSO setup.' The agent uses `search_help_center` to find all relevant articles and presents them to you.

**What is the difference between `list_kb_articles` and `list_kb_categories`?**
`list_kb_categories` shows the folder structure (the groups). `list_kb_articles` lists every individual document that lives inside those folders.

**If I want to check a term's definition, should I use `get_article_content` or `list_kb_glossary`?**
Use `list_kb_glossary`. This tool is specifically designed to pull the official definitions and scope of your approved terminology.

**How do I check what global rules apply to my documentation using `get_kb_project_info`?**
The agent calls `get_kb_project_info` to retrieve high-level data. This tells you about overarching system settings that affect all your content, like user access or branding.

**How do I check what custom fields are available for my documentation using `list_kb_custom_fields`?**
The tool retrieves a list of every defined metadata field. This lets your AI client know the exact schema it can read or write against, ensuring consistency across all project articles.

**If I need to understand the full scope and subcategories of a specific area, what should I use: `get_category_details`?**
Using `get_category_details` provides more than just names. It maps out associated articles and nested sub-sections, which is crucial for understanding deep documentation hierarchies.

**What kind of format should a new article take? Can I see the required structure using `list_article_templates`?**
Running `list_article_templates` shows the approved structures for your content. This ensures that when your agent generates documentation, it matches your established style and formatting standards.

**What's the best way to retrieve content for a large number of articles? Should I use `get_article_content`?**
You should process these requests in batches. When calling `get_article_content`, keep an eye on potential rate limits; fetching massive volumes requires careful scheduling within your agent's workflow.

**Where do I find my KnowledgeOwl API Key?**
Log in to KnowledgeOwl, click on your name in the top right corner, select **Your Profile**, and look for the **API Key** tab.

**Can I read private articles?**
Yes, as long as your API Key has the necessary permissions, the `get_article_content` tool can retrieve any article in your project.

**Does this support Markdown?**
Yes, the presenter renders article titles and high-level status in Markdown for clear reading in your chat client.