Janus Analytics
About
# Janus Analytics MCP Server An [MCP server](https://modelcontextprotocol.io) that connects AI coding agents to your [Janus](https://addjanus.ca) analytics. Query your dashboard, events, funnels, and usage directly from Claude Code, Cursor, Windsurf, or any MCP-compatible client. ## Setup ### 1. Get a Janus API key…
Details
- License
- MIT
Explore
- All tools are read‑only — data is never modified
- Query event counts, visitors, top pages, and referrers
- Search event logs with filters for type, tags, and date range
- View current month usage vs. tier cap per API key
- List funnels and get per-step conversion rates
- Retrieve API key metadata: names, prefixes, last‑used dates
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
Janus AnalyticsCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
| Environment variable | Required | Description |
|---------------------|----------|-------------|
| JANUS_API_KEY | Yes | Your Janus API key (starts with jns_) |
get_dashboard_stats
Get dashboard analytics: event counts, unique visitors, top pages, referrers, UTM sources, country breakdown, bounce rate, and daily event trends.
query_events
Search and filter the event log. Supports filtering by event type, tags, date range, and API key. Returns paginated results.
get_usage
Check current month's event usage against your tier cap, API key count, and per-key breakdown.
list_journeys
List all defined user journeys (funnels) with their step definitions, match scope, and conversion window.
get_journey_results
Get funnel conversion data for a specific journey — per-step entered/converted/dropped counts, conversion rates, and median time between steps.
list_api_keys
List your Janus API keys with names, prefixes, allowed origins, and last-used dates.
All tools are read-only — the server never modifies your data.
| Tool | Description |
|------|-------------|
| get_dashboard_stats | Event counts, unique visitors, top pages, referrers, UTM sources, countries, bounce rate, and daily trends. Optional apiKeyId filter. |
| query_events | Search the event log with filters for type, tags, date range, API key, and pagination. |
| get_usage | Current month's event usage vs. tier cap, API key count, and per-key breakdown. |
| list_journeys | List all funnels with step definitions, match scope, and conversion windows. |
| get_journey_results | Funnel conversion data — per-step counts, conversion rates, and median time between steps. |
| list_api_keys | Your API keys with names, prefixes, allowed origins, and last-used dates. |
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"janus analytics": {
"janus": {
"command": "npx",
"args": [
"-y",
"@janus-analytics/mcp-server"
],
"env": {
"JANUS_API_KEY": ""
}
}
}
}
}McpServers
{
"janus": {
"command": "npx",
"args": [
"-y",
"@janus-analytics/mcp-server"
],
"env": {
"JANUS_API_KEY": ""
}
}
}An MCP server that connects AI coding agents to your Janus analytics. Query your dashboard, events, funnels, and usage directly from Claude Code, Cursor, Windsurf, or any MCP-compatible client.
Setup
1. Get a Janus API key
Sign up at addjanus.ca and create an API key in Settings.
2. Add to your MCP client
Claude Code
claude mcp add janus -- npx -y @janus-analytics/mcp-server
Then set your API key:
export JANUS_API_KEY=jns_your_key_here
Claude Desktop / Cursor / Windsurf
Add to your MCP config file:
{
"mcpServers": {
"janus": {
"command": "npx",
"args": ["-y", "@janus-analytics/mcp-server"],
"env": {
"JANUS_API_KEY": "jns_your_key_here"
}
}
}
}
Config file locations:
- Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
- Cursor: Settings > MCP Servers
- Windsurf: ~/.windsurf/mcp.json
Tools
All tools are read-only — the server never modifies your data.
| Tool | Description |
|------|-------------|
| get_dashboard_stats | Event counts, unique visitors, top pages, referrers, UTM sources, countries, bounce rate, and daily trends. Optional apiKeyId filter. |
| query_events | Search the event log with filters for type, tags, date range, API key, and pagination. |
| get_usage | Current month's event usage vs. tier cap, API key count, and per-key breakdown. |
| list_journeys | List all funnels with step definitions, match scope, and conversion windows. |
| get_journey_results | Funnel conversion data — per-step counts, conversion rates, and median time between steps. |
| list_api_keys | Your API keys with names, prefixes, allowed origins, and last-used dates. |
Example prompts
Once connected, ask your AI agent things like:
- "How's my traffic looking this week?"
- "Show me the top pages from the last 7 days"
- "What's my funnel conversion rate for the signup journey?"
- "Am I close to my usage limit this month?"
- "Which API key is getting the most events?"
Configuration
| Environment variable | Required | Description |
|---------------------|----------|-------------|
| JANUS_API_KEY | Yes | Your Janus API key (starts with jns_) |
License
MIT
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
