Kayzen Analytics
About
Integrates with Kayzen Analytics API to access and analyze marketing campaign data, providing tools for report listing, data fetching with date filtering, and performance optimization insights.
Details
- Author
- springwq
- Repository
- springwq/kayzen-mcp
- GitHub stars
- 1
- Downloads
- 539
- Categories
- Cloud Service, Other, API, Developer Tools, AI, Infrastructure
- Tags
- #data-science, #analytics
Jump to
Automated Authentication: Built-in token management with automatic refresh mechanism
Report Management: Easy access to Kayzen analytics reports
Error Handling: Comprehensive error handling for API interactions
TypeScript Support: Full TypeScript implementation with type definitions
- Environment Based Configuration: Simple setup using environment variables
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Kayzen AnalyticsCommand (node, npx, python, etc.)npxArguments-
Argument 1
-y -
Argument 2
@feedmob-ai/kayzen-mcp
Environment-
KAYZEN_PASSWORD
pasword -
KAYZEN_USERNAME
username -
KAYZEN_BASIC_AUTH
auth token
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
import { KayzenMCPServer } from '@feedmob-ai/kayzen-mcp';
const server = new KayzenMCPServer();
server.start();
To use this with Claude Desktop, add the following to your claude_desktop_config.json:
npm install
list_reports
Lists all available reports from Kayzen Analytics. Returns an array of report objects containing id, name, and type.
get_report_results
Retrieves results for a specific report. Parameters: report_id (string, required), start_date (string, optional in YYYY-MM-DD format), end_date (string, optional in YYYY-MM-DD format). Returns report data and metadata.
analyze_report_results
Analyzes report results and provides insights. Parameters: report_id (string). Analysis includes performance metrics, key trends, areas for optimization, and unusual patterns or anomalies.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"kayzen analytics": {
"env": {
"KAYZEN_PASSWORD": "pasword",
"KAYZEN_USERNAME": "username",
"KAYZEN_BASIC_AUTH": "auth token"
},
"args": [
"-y",
"@feedmob-ai/kayzen-mcp"
],
"command": "npx"
}
}
}Linux
{
"env": {
"KAYZEN_PASSWORD": "pasword",
"KAYZEN_USERNAME": "username",
"KAYZEN_BASIC_AUTH": "auth token"
},
"args": [
"-y",
"@feedmob-ai/kayzen-mcp"
],
"command": "npx"
}Macos
{
"env": {
"KAYZEN_PASSWORD": "pasword",
"KAYZEN_USERNAME": "username",
"KAYZEN_BASIC_AUTH": "auth token"
},
"args": [
"-y",
"@feedmob-ai/kayzen-mcp"
],
"command": "npx"
}Windows
{
"env": {
"KAYZEN_PASSWORD": "pasword",
"KAYZEN_USERNAME": "username",
"KAYZEN_BASIC_AUTH": "auth token"
},
"args": [
"/c",
"npx",
"-y",
"@feedmob-ai/kayzen-mcp"
],
"command": "cmd"
}Kayzen Analytics MCP Server
A Model Context Protocol (MCP) server implementation for interacting with Kayzen Analytics API. This package enables AI models to access and analyze Kayzen advertising campaign data through a standardized interface.
Features
Automated Authentication: Built-in token management with automatic refresh mechanism
Report Management: Easy access to Kayzen analytics reports
Error Handling: Comprehensive error handling for API interactions
TypeScript Support: Full TypeScript implementation with type definitions
Environment Based Configuration: Simple setup using environment variables
Installation
npm install @feedmob-ai/kayzen-mcp
Configuration
Create a .env file with your Kayzen credentials:
KAYZEN_USERNAME=your_username
KAYZEN_PASSWORD=your_password
KAYZEN_BASIC_AUTH=your_basic_auth_token
KAYZEN_BASE_URL=https://api.kayzen.io/v1 # Optional, defaults to this value
Usage
Basic Setup
import { KayzenMCPServer } from '@feedmob-ai/kayzen-mcp';
const server = new KayzenMCPServer();
server.start();
Available Tools
1. list_reports
Lists all available reports from Kayzen Analytics.
Inputs: None
Returns: Array of report objects containing:
- id: Report identifier
- name: Report name
- type: Report type
const reports = await server.tools.list_reports();
2. get_report_results
Retrieves results for a specific report.
Inputs:
- report_id (string, required): ID of the report to fetch
- start_date (string, optional): Start date in YYYY-MM-DD format
- end_date (string, optional): End date in YYYY-MM-DD format
Returns: Report data and metadata
const results = await server.tools.get_report_results({
report_id: 'report_id',
start_date: '2024-01-01', // optional
end_date: '2024-01-31' // optional
});
3. analyze_report_results (Prompt)
Analyzes report results and provides insights.
Inputs:
- report_id (string): ID of the report to analyze
- Analysis includes:
- Key trends
- Areas for optimization
- Unusual patterns or anomalies
Setup
Usage with Claude Desktop
To use this with Claude Desktop, add the following to yourclaude_desktop_config.json:
NPX
{
"mcpServers": {
"github": {
"command": "npx",
"args": [
"-y",
"@feedmob-ai/kayzen-mcp"
],
"env": {
"KAYZEN_USERNAME": "username",
"KAYZEN_PASSWORD": "pasword",
"KAYZEN_BASIC_AUTH": "auth token"
}
}
}
}
Development
Prerequisites
- Node.js (v16 or higher)
- npm (v7 or higher)
- Kayzen API credentials
Scripts
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
