MCP server

Kumkuat's MCP server lets an AI assistant work in your workspace through the Model Context Protocol. From Claude, ChatGPT, Microsoft Copilot or Gemini you can show a draft to an audience persona and get its reaction, run a scorecard or an Audience Report, create audiences, compare narratives, and write and check content.

There are two ways to connect:

• The hosted server at https://api.kumkuat.ai/api/chat/mcp (recommended). You sign in with your Kumkuat account, so the assistant acts as you, with your role's access, in the workspace you pick. It works in any assistant that supports remote MCP servers.
• The Claude Desktop extension (kumkuat.mcpb), which runs on your own computer with a workspace API key. See Claude Desktop extension below.

Connect the hosted server

Add a remote (custom) MCP server in your assistant and give it this URL:

https://api.kumkuat.ai/api/chat/mcp

The first time the assistant connects, a Kumkuat sign-in page opens:

1. Sign in the way you sign in to the app: email, Google, or your company's single sign-on.
2. Pick the workspace the assistant should work in.
3. Click Allow.

The assistant now acts as you in that workspace. It can do what your role allows there, and nothing more. To disconnect it, open Settings → Security → Connected apps in the app; the connection stops within a few seconds. It also stops if you leave the workspace.

Assistant	How to add it
Claude (claude.ai and Claude Desktop custom connectors)	Add a custom connector with the URL above. When asked how to register, choose to register automatically.
ChatGPT	Add the URL as a connector with OAuth sign-in. ChatGPT registers itself.
Microsoft Copilot Studio	Add an MCP server tool to your agent and choose dynamic discovery with the URL above.
GitHub Copilot in VS Code	Add an HTTP MCP server with the URL above.
Gemini CLI	Add the URL as an HTTP MCP server in settings.json. Gemini CLI registers itself when it first connects.
Gemini Enterprise	Gemini Enterprise needs a client id and secret registered for it. Ask Kumkuat support for them, then enter the authorization URL https://api.kumkuat.ai/oauth/authorize, the token URL https://api.kumkuat.ai/oauth/token, and the id and secret.

For scripts and automations that should not sign in as a person, send a workspace API key instead, in an X-API-Key header or as Authorization: Bearer <key>.

What the assistant can do

Each tool does what a page of the app does, with the same permissions and checks as the app.

Audiences

Tool	What it does
list_personas	List the audience personas in the workspace, optionally for one audience group.
list_audience_groups	List the audience groups (categories of personas), for example Investors or Regulators.
get_audience	Read one persona's profile: who they are, their tone, interests, concerns and communication style.
chat_with_audience	Show a draft to one persona and get its reaction, or ask it a question, as on Audience Chat. Paste the whole draft; long drafts are passed in full. Pass the returned session_id to continue the conversation, for example with a revised draft.
find_marketplace_audiences	Search the Kumkuat audience marketplace for ready-made personas that match a description, leaving out ones already in the workspace.
create_audience	Create a persona from a name, a description of who they are and what they read for, and an audience group. If the marketplace has a persona with exactly that name, its managed copy is installed instead; if the workspace already has one with that name, that one is used.

Scorecards

Tool	What it does
run_scorecard	Test a document or draft with several personas at once, as on Audience Scorecards: a letter grade per persona, what lands and what misses, evidence and suggested actions. Up to three personas answer straight away; larger groups run in the background.
get_scorecard	Read the latest grades for a document, or the progress of a background scorecard.
list_scorecards	List recent scorecards, grouped by document.
get_audience_summary	What an audience group, or one persona, thinks overall, summarised from its recent scorecards: grade, sentiment, themes, actions and risks.

Audience Reports

Tool	What it does
create_audience_report	Start an Audience Report on a saved document: every chosen persona reads it, then Kumkuat writes a verdict, strengths, gaps with evidence, recommended moves and a score per persona. Takes a few minutes.
get_audience_report	Read a report's progress, or the full report once it is done.
list_audience_reports	List the reports you can see: yours and the ones shared with the workspace.

Narratives

Tool	What it does
list_narrative_themes	List the themes, executives and companies available to compare.
compare_narratives	Compare what executives or companies say on a theme, as on Compare Narratives: at-a-glance points, similarities and differences. Add personas to have them react to each narrative.

Content Writing

Tool	What it does
generate_content	Write a draft as on Content Writing: a content type, optionally in a voice, for target audiences, from a source document, carrying key messages. Saves it as a content draft unless told not to.
save_content_draft	Create a content draft, or update one. An update changes only what you pass.
list_content_drafts / get_content_draft	List the workspace's drafts, or read one with its text.
list_voices	List the voices generate_content can write in: executives and personas set up as voices.
check_content_quality	Check text for grammar, spelling and AI-likeness (how machine-written it reads), with a score per sentence on a 0 to 1 scale. Nothing is saved.

Chat and competitors

Tool	What it does
chat	Kumkuat's assistant chat, the same as in the app.
list_competitors / suggest_competitors	List the workspace's competitors, or suggest more.
add_competitor / remove_competitor	Change the competitor list. Workspace admins only by default.

Who sees which tools

The assistant is offered only the tools your role can use in the workspace:

• Viewers don't get create_audience, create_audience_report, generate_content, save_content_draft, check_content_quality, add_competitor or remove_competitor: the same things the app doesn't let a viewer do. They can still chat with personas, run scorecards, compare narratives and read everything else.
• Members get everything except add_competitor and remove_competitor, by default.
• Owners and admins get every tool.
• If your workspace's permissions take one away from your role, the tools that need it are left out too.

Audience Reports run on the Narrative Testing feature, which Kumkuat sets per workspace (see Feature toggles). If it is off for your workspace, the report tools still appear, and using one says it isn't turned on and that a workspace admin can ask Kumkuat to turn it on.

Assistants keep the tool list from when they connected. After your role or your workspace's features change, disconnect and reconnect the assistant to see the new list. Every request is checked against your current access either way.

Things to try

• "List my workspace's investor personas. If there are none, create three: a sell-side analyst covering our sector, a long-only top-20 holder, and a long/short fund with a bear case. Put them in Investors."
• "Show this draft letter to each investor persona and tell me what each would push back on." (Attach or paste the draft.)
• "Run a scorecard on the revised draft with the Investors group and give me a table of grades."
• "Check the final for grammar and AI-likeness, and rewrite any sentence that scores high."
• "Start an Audience Report on our press release with the Media group and tell me the verdict when it's done."
• "Compare what our CEO and our main competitor's CEO say about AI, and how our Investors group would react."

Claude Desktop extension

The kumkuat.mcpb extension runs the server on your own computer and connects with a workspace API key. It has its own, smaller set of tools, listed below.

Install the extension

1. In the app, open Workspace → Integrations → MCP and download the kumkuat.mcpb extension.
2. Double-click the file, or drag it into Claude Desktop's Extensions settings.
3. When prompted, paste a workspace API key from the same Integrations page. The key binds the extension to that workspace. Leave the API base URL at its default unless the MCP page told you otherwise.

Manual setup

Build the server from the mcp/ directory of the Kumkuat repository and point Claude at it.

Claude Desktop — add to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json; Windows: %APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "kumkuat": {
      "command": "node",
      "args": ["/path/to/kumkuat/mcp/dist/index.js"],
      "env": {
        "KUMKUAT_API_KEY": "your-workspace-api-key",
        "KUMKUAT_API_URL": "https://api.kumkuat.ai"
      }
    }
  }
}

Claude Code:

claude mcp add kumkuat --env KUMKUAT_API_KEY=your-workspace-api-key --env KUMKUAT_API_URL=https://api.kumkuat.ai -- node /path/to/kumkuat/mcp/dist/index.js

Extension tools

Tool	Description
chat	Send messages through Kumkuat's intent-driven chat. Supports general chat and persona mode; reuse session_id for a threaded follow-up.
list_personas	List personas in the workspace.
list_audience_groups	List audience categories with display names and sort order.
get_audience_summary	Get or generate a category summary with grade, trends and status counts.
get_audience_grades	Cached grades and trends for several categories at once.
get_persona_reactions	Reaction insights: how personas responded to documents.
get_reaction_history	Reaction history for one persona and document.
generate_persona_reaction	Generate a reaction for a document.
refresh_audience_cache	Queue a background refresh of the audience summaries.
list_competitors / suggest_competitors / add_competitor / remove_competitor	Manage the workspace's competitors.

Resources and prompts

Resource	URI
Personas	kumkuat://personas
Competitors	kumkuat://competitors
Audience groups	kumkuat://audience-groups

Two prompts ship with the extension: persona-chat starts a conversation with a specific persona, and draft-email drafts an email using workspace audience context.

Environment variables

Variable	Required	Default
KUMKUAT_API_KEY	Yes	—
KUMKUAT_API_URL	No	https://api.kumkuat.ai