Claude Desktop and Claude Code

The Kumkuat MCP server connects Claude Desktop and Claude Code to your workspace through the Model Context Protocol. Chat with audience personas, read audience grades, generate reactions and manage competitors without leaving Claude.

Install the extension (recommended)

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

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 server: persona-chat starts a conversation with a specific persona, and draft-email drafts an email using workspace audience context.

Things to try

• "List my workspace personas."
• "Chat with Jeremy Siegel about our Q2 strategy."
• "Show me audience grades across all categories."
• "How did the trade press react to the latest press release?"
• "Draft an email to our investor audience about quarterly results."

Environment variables

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