Skip to main content
Glama
Helpjuice MCP Server
by OfirOhan

Helpjuice MCP Server

CI MCP License: MIT

A Model Context Protocol server for Helpjuice. It lets Claude, Cursor, ChatGPT and other AI agents search and read your knowledge base, draft and update articles, and audit stale content.

Unofficial. This is a community project and is not affiliated with Helpjuice. It was built from Helpjuice's public API v3 docs.

What you can ask your agent

  • "Search our knowledge base for how SSO is set up and answer this customer's question, with a link to the article."

  • "Which published articles in Billing haven't been touched in a year? Give me a table, oldest first."

  • "Turn this Slack thread into a draft help article in the Integrations category. Don't publish it."

  • "Our pricing page changed. Find every article that mentions the old 'Starter' plan and propose edits."

  • "What did the team publish or edit this week?"

Related MCP server: kb-intelligence

Tools

Tool

What it does

Writes?

search_knowledge_base

Full-text search with clean text samples

No

get_article

Read an article as clean plain text (internal blocks expanded) or HTML for editing

No

list_articles

Filter by category, published/draft, visibility, dates, language

No

find_stale_articles

Published articles not updated in N days, oldest first

No

list_categories / get_category

Category tree with article counts, or one category's articles

No

list_recent_activity

Who created, edited or published what

No

get_account

Account settings

No

create_article

New article, saved as a draft by default; accepts HTML or plain text

Yes

update_article

Change only the fields you pass

Yes

create_category

New category or subcategory

Yes

delete_article

Delete an article

Destructive

Design notes:

  • Article bodies come back as readable text instead of raw HTML, which keeps answers grounded and saves tokens. Ask for format: "html" when editing.

  • New articles are unpublished drafts unless you explicitly set published: true, so an agent can't put content in front of customers by accident.

  • Lists return compact rows (id, title, visibility, views, last updated) so an agent can scan hundreds of articles in one call.

  • All tools carry MCP annotations (readOnlyHint, destructiveHint), so clients can ask before writing.

Setup

  1. In Helpjuice, go to Settings → API Credentials, enable token-based API access and copy your API key.

  2. Build it:

git clone https://github.com/OfirOhan/helpjuice-mcp.git
cd helpjuice-mcp && npm install && npm run build

Claude Desktop

Add this to claude_desktop_config.json:

{
  "mcpServers": {
    "helpjuice": {
      "command": "node",
      "args": ["/absolute/path/to/helpjuice-mcp/dist/index.js"],
      "env": { "HELPJUICE_ACCOUNT": "yourcompany", "HELPJUICE_API_KEY": "your-api-key" }
    }
  }
}

Claude Code / Cursor / other MCP clients

claude mcp add helpjuice -e HELPJUICE_ACCOUNT=yourcompany -e HELPJUICE_API_KEY=your-api-key -- node /path/to/helpjuice-mcp/dist/index.js

For Cursor and other clients, use the same command with the variables below in the environment.

Variable

Default

Notes

HELPJUICE_API_KEY

(required)

Your Helpjuice API key

HELPJUICE_ACCOUNT

(required)

Your subdomain, e.g. yourcompany for yourcompany.helpjuice.com

HELPJUICE_BASE_URL

https://<account>.helpjuice.com/api/v3

Override for testing

Development

npm install
npm test   # builds, runs unit tests and an end-to-end MCP stdio test against a fake Helpjuice API

The tests run on Node 20, 22 and 24 in CI.

Author

Built by Ofir Ohana, an AI agents engineer. Issues and PRs are welcome.

License

MIT

Available Tools

12 tools
create_articleCreate articleA

Create a new article. Saved as an unpublished draft unless published=true. body accepts HTML or plain text (blank lines become paragraphs).

Inputs: body (required), name (required), codename, language, +3 more.

create_categoryCreate categoryC

Create a knowledge base category, optionally nested under a parent.

Inputs: name (required), parentId, description, accessibility.

delete_articleDelete articleA
Destructive

Delete an article from the knowledge base. Confirm with the user first; consider unpublishing instead.

Inputs: articleId (required).

find_stale_articlesFind stale articlesA
Read-only

Find published articles that have not been updated in N days (default 180), oldest first. Useful for content audits before a release.

Inputs: days, limit, categoryId.

get_accountAccount settingsA
Read-only

Get the knowledge base account settings (name, subdomain, internal KB flag, contact email).

Inputs: no named parameters.

get_articleRead articleA
Read-only

Read one article. Returns the body as clean plain text by default (internal blocks expanded), or as HTML for editing.

Inputs: articleId (required), format, language.

get_categoryGet categoryA
Read-only

Get one category with its published and draft articles.

Inputs: categoryId (required).

list_articlesList articlesB
Read-only

List articles with filters (category, published, visibility, created/updated dates, language). Returns compact rows.

Inputs: page, limit, language, published, +4 more.

list_categoriesList categoriesA
Read-only

List knowledge base categories (id, name, parent, visibility, article counts).

Inputs: language.

list_recent_activityRecent activityA
Read-only

Recent knowledge base activity (who created, edited or published what), newest first.

Inputs: page, limit, actionType, trackableType.

search_knowledge_baseSearch knowledge baseA
Read-only

Full-text search across the Helpjuice knowledge base. Returns matching articles with a short text sample. Use get_article to read the full answer before quoting it.

Inputs: query (required), categoryId.

update_articleUpdate articleA
Idempotent

Update an article's title, body, summary, categories or published state. Only the fields you pass are changed. Read the article first with get_article(format='html') when editing the body.

Inputs: articleId (required), body, name, published, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 12 tools

    Disambiguation4/5

    Most tools target clearly distinct actions and resources, with article CRUD, category listing/creation, and account/activity reads separated well. The main possible confusion is between search_knowledge_base, list_articles, and find_stale_articles, though their descriptions clarify the intended use cases.

    Naming Consistency5/5

    All tool names follow a consistent snake_case verb_noun pattern such as search_knowledge_base, get_article, list_articles, create_article, and delete_article. The convention is predictable throughout the set.

    Tool Count5/5

    Twelve tools is well-scoped for a knowledge base server, covering article and category management plus search and activity inspection. No tool appears redundant or gratuitous at the surface level.

    Completeness4/5

    Article lifecycle coverage is strong with search, read, list, create, update, delete, and stale-content auditing. Category management is less complete because categories can be listed, fetched, and created but not updated or deleted.

    Related MCP Connectors

    Related MCP Servers