Janus Analytics MCP Server

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