Used as an HTTP client for making API requests to the Kayzen Analytics API.
Enables environment-based configuration for Kayzen credentials through .env files.
Provides the runtime environment for the MCP server, requiring v16 or higher.
Package manager used for installation and running scripts, requiring v7 or higher.
Provides type safety with full TypeScript implementation and type definitions.
Used for schema validation and type safety in API interactions.
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
Configuration
Create a .env
file with your Kayzen credentials:
Usage
Basic Setup
Available Tools
1. list_reports
Lists all available reports from Kayzen Analytics.
Inputs: None
Returns: Array of report objects containing:
id
: Report identifiername
: Report nametype
: Report type
2. get_report_results
Retrieves results for a specific report.
Inputs:
report_id
(string, required): ID of the report to fetchstart_date
(string, optional): Start date in YYYY-MM-DD formatend_date
(string, optional): End date in YYYY-MM-DD format
Returns: Report data and metadata
3. analyze_report_results
(Prompt)
Analyzes report results and provides insights.
Inputs:
report_id
(string): ID of the report to analyze
Analysis includes:
Performance metrics
Key trends
Areas for optimization
Unusual patterns or anomalies
Setup
Usage with Claude Desktop
To use this with Claude Desktop, add the following to your claude_desktop_config.json
:
NPX
Development
Prerequisites
Node.js (v16 or higher)
npm (v7 or higher)
Kayzen API credentials
Scripts
Project Structure
Dependencies
Main dependencies:
@modelcontextprotocol/sdk
: ^1.7.0axios
: ^1.8.3dotenv
: ^16.4.7zod
: ^3.24.2
Error Handling
The server handles various error scenarios:
Authentication failures
Invalid API requests
Network issues
Token expiration and refresh
Invalid parameters
License
MIT License
Author
FeedMob
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
An implementation that enables AI models to access and analyze Kayzen advertising campaign data through a standardized interface with features like automated authentication and report management.
Related MCP Servers
- AsecurityAlicenseAqualityEnables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.Last updated -8416Apache 2.0
- -securityAlicense-qualityEnables iterative deep research by integrating AI agents with search engines, web scraping, and large language models for efficient data gathering and comprehensive reporting.Last updated -3275MIT License
- -securityFlicense-qualityEnables users to analyze, manage, and optimize digital advertising campaigns through natural language conversations in Claude, offering performance insights, interactive visualizations, and campaign management for platforms like Amazon Ads.Last updated -4
- -securityFlicense-qualityAllows AI models to query and retrieve analytics data from Plausible Analytics through the Plausible API, enabling natural language interactions with website statistics.Last updated -1