Once HelpKit is connected, you talk to your assistant the way you always have. There are no commands to learn and no special syntax. This article shows the prompts that work well, and lists everything your assistant can reach, so nothing it does looks mysterious.
Just ask in plain English
Your assistant works out which part of your help center it needs. All of these work as written:
Which of our articles are people rating badly?
What are visitors searching for that we do not cover?
Write a help article about our new Slack integration and put it in Integrations.
If you are not sure it is working yet, ask "check my HelpKit setup status" first. That confirms the connection and names the projects your assistant can reach.
Prompts worth stealing
The weekly docs review
Run a docs review for me. Look at last month's missed searches, the worst rated articles and the questions the AI chatbot handled badly, then give me a shortlist of what to fix, most valuable first.
This is the one most customers settle into. Your assistant pulls all three signals, reads the articles involved before judging them, and comes back with a ranked list rather than raw numbers.
Turn a gap into a draft
Visitors keep searching for "cancel subscription" and we have nothing. Write that article, match the tone of our existing billing articles, and file it under General Info.
Your assistant reads a few of your existing articles first so the new one sounds like you rather than like a chatbot, then writes it into Notion as a draft.
Fix a weak article
Our lowest rated article this quarter is the one about custom domains. Read it, tell me what readers are actually complaining about in the feedback, and propose a rewrite.
Document a new feature
Here are the release notes for what we shipped this week. Draft help articles for anything customers will need, and tell me which existing articles now say something wrong.
Paste the notes straight into the chat. This is where MCP earns its keep, because your assistant can see your product notes and your help center at the same time.
Housekeeping
Our Getting Started category is in a strange order. Put the setup articles first and the troubleshooting ones last.
Feature the widget article on our home page and refresh its Last Updated date.
Check what is actually live
Which articles are published but not yet showing on the site?
A published article only reaches readers after a sync, so this question catches the gap.
Everything your assistant can reach
Most AI tools show you the name of whatever they are calling. Here is what each name means.
Reading your help center
What you see | What it does |
list_projects | Lists the help centers you can reach, so it knows which to work on |
get_setup_status | Checks your connection: plan, Notion access and what it may change |
get_help_center_tree | Your whole structure, categories and articles, drafts included |
get_article | The full text of one article, read live from your Notion |
notion_list_collections | The categories and sub-categories an article can be filed in |
notion_list_articles | Everything inside one category, drafts included |
get_sync_status | Whether your last sync finished, and what it changed |
Understanding your readers
What you see | What it does |
get_search_insights | What visitors searched for, and which searches found nothing |
get_article_feedback | Your best and worst rated articles, with the comments readers left |
get_ai_chat_insights | What people asked your AI chatbot, and where it struggled |
get_page_analytics | Views and traffic, page by page |
Writing into your Notion
Everything in this group needs your Notion pages shared with HelpKit. All of it produces drafts, which stay invisible to readers.
What you see | What it does |
notion_create_article_draft | Writes a new article, unpublished |
notion_update_article | Rewrites or edits an existing one |
notion_create_collection | Adds a new category |
notion_create_subcollection | Adds a sub-category inside one |
notion_update_collection | Renames a category or changes its description |
notion_update_subcollection | Renames a sub-category |
notion_set_article_meta | Features an article, or refreshes its Last Updated date |
notion_set_order | Puts one category's articles into the order you asked for |
notion_prepare_media_upload | Adds an image or a video to an article |
Changing what visitors see
This last group is the only part that can affect your live site, and it is switched off unless you turn it on.
What you see | What it does |
notion_publish_article | Ticks Published on an article you approved |
notion_archive_article | Moves one article to Notion's trash, restorable for 30 days |
notion_archive_collection | Moves a whole category there, after showing you what would go |
sync_article | Pushes your edits to one article that is already live |
sync_help_center | Publishes structural changes: new articles, new categories, removals |
Getting better answers
- Name the project once. If you run more than one help center, say which one in your first message and your assistant sticks with it for the rest of the conversation.
- Ask for the reasoning, not just the list. "Tell me what is wrong with it" gets you further than "is it good".
- Be specific about voice. "Match the tone of our billing articles", "shorter paragraphs", "no marketing language" all produce noticeably better drafts than asking for an article with no direction.
- Review in Notion before anything goes live. Your assistant hands you a Notion link for every draft it writes. Open it, edit what you want, and publish when you are happy.
Powered by