MCP tool referenceReads and changes

knowledge_hub: the brand facts every audit reads

knowledge_hub reads and edits a brand's Knowledge Hub: the brand profile, the content guideline, the target audiences and the topic clusters each audience asks about. AI Visibility, the Website Audit, Insights and Automations all read it, so an edit here changes what they work from.

Read it with a view. Change it with an action: patch the profile or guideline, add, edit or remove audiences and topic clusters, or let AI draft new clusters. Audiences and clusters are named, never addressed by id.

Views and actions01

What it can read and do

Every call names a brand and either a view (what to read) or, on the audit and Knowledge Hub tools, an action (what to change). With neither, the tool returns its default view.

Views (reads)
hubDefault
The profile, the content guideline, and each audience with its topic clusters (description, funnel stage, keywords), plus the plan limits.
overview
For each audience and topic cluster, how many AI Visibility prompts, audited pages and Insights questions cover it, planned against created.
Actions (changes)
update_profile
Change brand profile fields: description, products and services, value proposition, markets, competitors and more. Only the fields you send change.
update_guideline
Change the content guideline: tone of voice, content pillars, topics to avoid, formats and more.
add_audience
Add a target audience. fields.name is required. The first audience stays the primary one.
update_audience
Change the fields of the audience named in audience.
remove_audience
Remove the audience named in audience, with its topic clusters. A brand keeps at least one audience.
add_cluster
Add a topic cluster under audience (default: the primary audience). fields.name is required; keywords take up to 10 real search queries.
update_cluster
Change the cluster named in cluster. Put an audience name in fields.audience to move it.
remove_cluster
Remove the cluster named in cluster.
draft_clusters
AI drafts topic clusters: for every audience without any, otherwise two more each, up to the brand's limit. It runs for about a minute; read view hub until status is ready.
Credits02

What a call costs

  • Reads and edits are free, and work even when the balance is empty.
  • draft_clusters calls an AI model, so it costs the 1-credit call fee.
Parameters03

Input parameters

Every parameter the tool's input schema accepts. Your assistant fills these in from what you ask; you never type them yourself.

ParameterWhat it does
brandRequiredThe brand's name, case-insensitive, as brand_insights lists it.
viewWhat to read: hub (default) or overview.
actionWhat to change. Leave it out to read.
audienceA target audience's name: the one to update or remove, the audience a new cluster goes under, or which audience's cluster you mean when two share a name.
clusterupdate_cluster and remove_cluster: the topic cluster's name.
fieldsThe fields to set, as an object. Updates are patches: fields you leave out stay as they are.
Example prompts04

Questions that use this tool

Ask in plain language and the assistant picks the view or action. These make good first questions.

  • “Show me [brand]'s target audiences and their topic clusters.”
  • “Add a 'First-time buyers' audience for [brand], aged 22–30, who compare prices on TikTok.”
  • “Add three keywords to the 'Pricing' cluster for Busy Moms.”
  • “Draft topic clusters for [brand]'s new audience.”
  • “Which topic clusters have no AI Visibility prompts or pages yet?”
FAQ05

Questions about this tool

Does editing the Knowledge Hub change my audits?

Yes. AI Visibility and the Website Audit read the hub, so new audiences and clusters flow into them. Existing results stay as they are.

Can it delete things?

remove_audience and remove_cluster take them off the brand. Removing an audience removes its clusters too. Past results that name them keep working.

Why is it free?

Only draft_clusters calls an AI model, so only it is charged. Reading and editing your own brand facts costs nothing.