# Helpjuice MCP

> Helpjuice connects your knowledge base directly to any AI agent, letting you manage all documentation tasks through conversation. Use this MCP to list articles, create new content drafts, update existing guides, and run detailed analytics on usage trends without touching a CMS dashboard. It gives your AI client full control over internal and external support documentation.

## Overview
- **Category:** customer-support
- **Price:** Free
- **Tags:** knowledge-base, documentation, self-service-support, article-management, search-optimization, internal-wiki

## Description

You can treat your entire knowledge base like an extension of your chat window. Instead of clicking through complex folders or filling out forms in a separate system, you just talk to your agent about what you need done with your articles.

Want to write a new guide? Just ask the agent; it drafts and saves the article for you. Need to know if an article is popular? You can pull up engagement statistics instantly. If a user searches something that yields zero results, the AI can check recent search trends to tell you what content is actually missing.

The system handles everything from listing all your categories to checking which internal users have permission to edit guides. This makes your AI client act less like an assistant and more like a dedicated documentation specialist. Accessing this functionality through Vinkius means connecting one time gives your agent instant, deep access to the whole catalog of knowledge tools.

## Tools

### create_article
Generates a brand new article title and body within the knowledge base.

### downvote_article
Records that an article was unhelpful to the user.

### get_article_details
Retrieves all metadata and the full text content for a specific guide.

### get_article_stats
Pulls up key usage data, including views and votes, for one article.

### get_search_trends
Lists the most common search terms used by site visitors over a period of time.

### list_articles
Provides an overview list of every article in your knowledge base.

### list_categories
Shows all the main organizational sections used to group articles.

### list_kb_groups
Retrieves a list of internal user permission groups defined in the system.

### list_kb_users
Lists all internal contributors and authors who have access to edit guides.

### search_kb
Searches the entire knowledge base content for articles matching a given query.

### update_article
Modifies the title or body of an existing article guide.

### upvote_article
Records that an article was helpful to the user.

## Prompt Examples

**Prompt:** 
```
Find articles related to 'OAuth integration'.
```

**Response:** 
```
Searching knowledge base... I found 3 relevant articles: 'Setting up OAuth 2.0', 'API Authentication Guide', and 'Troubleshooting Connection Issues'. Would you like the full content for the 'Setting up OAuth 2.0' article?
```

**Prompt:** 
```
List all categories in my knowledge base.
```

**Response:** 
```
I've retrieved your categories. You have 5 main sections: 'Getting Started', 'User Guides', 'Developer API', 'Release Notes', and 'FAQs'. Should I list the articles inside the 'Developer API' category?
```

**Prompt:** 
```
Show me the engagement stats for article ID 1021.
```

**Response:** 
```
Retrieving analytics... Article ID 1021 ('Advanced Filtering') has had 450 views and 32 upvotes this month. It is currently one of your top-performing pieces of documentation. Would you like to see recent search terms that led users here?
```

## Capabilities

### Search Documentation
Find existing answers across your entire knowledge base using natural language queries.

### Create and Modify Articles
Draft brand new articles or make changes to the body and metadata of guides directly from chat prompts.

### Analyze Content Usage
Pull up key metrics, like view counts and user voting records, for specific pieces of documentation.

### Manage Structure
List and organize your content into defined categories, giving you a map of all available guides.

### Monitor Content Health
Review recent search terms or list contributors to identify gaps in documentation coverage.

## Use Cases

### A guide is falling out of date and needs an overhaul.
The writer asks the agent to check `get_article_stats` for 'Billing FAQs'. The stats show low engagement and many downvotes. The writer then uses `get_article_details` to pull the old content, drafts a new version, and finally uses `update_article` to push the fix.

### The Support team needs to know what documentation is missing.
Instead of having agents manually check user feedback against existing guides, the manager runs `get_search_trends`. The agent reports that 'OAuth error codes' is a top search term with no matching articles, allowing immediate content creation.

### A new product feature needs to be documented and categorized.
The creator first uses `list_categories` to see where the guide fits. They then run `create_article` for the draft, specifying the title and body content before requesting the agent to list all articles again to confirm placement.

### Checking permissions across different teams.
The ops engineer uses `list_kb_groups` to see who can edit guides. Then they use `list_kb_users` to check specific team members against those groups, ensuring proper access control before deployment.

## Benefits

- Stop digging through CMS menus. Instead of manually listing articles using `list_articles`, just ask your agent for 'all published guides' and get the list instantly.
- Quickly spot content gaps by running `get_search_trends`. If users are searching for 'API limits' but no article exists, you know exactly what to write next.
- Content changes become simple. You can update an entire guide using `update_article` without ever needing to log into the backend editor.
- Track content performance with one command: `get_article_stats`. See which guides are viewed often and which ones need a refresh.
- Improve quality control by running user checks, like listing contributors via `list_kb_users`, so you know who owns what documentation section.

## How It Works

The bottom line is, you never have to navigate your documentation platform manually again; your AI client does it for you.

1. Subscribe to this MCP and provide your Helpjuice API Key and Subdomain credentials.
2. Your AI client connects to the service, authorizing access to all knowledge base tools.
3. You give a command in chat—for example, 'Find articles about X'—and the agent uses the appropriate tool to fetch or modify data.

## Frequently Asked Questions

**How does Helpjuice help with article creation?**
You can use the `create_article` tool to generate a new draft guide directly from chat. This bypasses opening any content management system (CMS) and saves time.

**Can I check if an article is popular using Helpjuice MCP?**
Yes, use `get_article_stats` to pull up engagement statistics. You'll see detailed metrics like view counts and how many users gave it a helpful vote.

**How do I find out what questions customers are asking that aren't covered?**
Run the `get_search_trends` tool to list recent search terms. This shows you exact gaps in your knowledge base, guiding where you need to write new content.

**Does Helpjuice MCP let me organize my guides into sections?**
Yes, you can use `list_categories` to see your current structure and then manage the grouping of articles through the agent's conversational commands.

**If I update a guide, do I need to manually publish it again with Helpjuice MCP?**
The MCP handles the publishing flow. You simply ask to `update_article`, and the system manages pushing that revision live within your knowledge base.