Connect Janus to your AI coding agent

Check your analytics without opening a dashboard. Your agent queries Janus directly.

The Payoff

What your agent can do

Once connected, your agent can:

• •Pull dashboard stats: event counts, unique visitors, top pages, traffic sources.
• •Search the event log by type, tags, date range, or API key.
• •Check funnel conversion rates and drop-off.
• •Show how close you are to your monthly event cap.

Step 1

Get a full-access API key

Sign up at addjanus.ca, verify your email, and generate a key in Settings. Keys start with jns_. Set the scope to Full access. The MCP server reads your analytics, and the default Ingest scope only sends events. Generate a separate key rather than reusing the one on your website: a full-access key in browser code lets anyone who views source read your data.

jns_a1b2c3d4e5f6...

Step 2

Add the MCP server

One command in Claude Code:

claude mcp add janus -e JANUS_API_KEY=jns_your_key -- npx -y @janus-analytics/mcp-server

For Cursor, Windsurf, or Claude Desktop, add this to your MCP config file:

{
  "mcpServers": {
    "janus": {
      "command": "npx",
      "args": ["-y", "@janus-analytics/mcp-server"],
      "env": {
        "JANUS_API_KEY": "jns_your_key_here"
      }
    }
  }
}

Available Tools

6 tools, all read-only

• •get_dashboard_stats: event counts, unique visitors, top pages, referrers, countries, bounce rate, daily trends.
• •query_events: search and filter the event log by type, tags, date range, and API key.
• •get_usage: monthly event usage vs. tier cap, API key count, per-key breakdown.
• •list_journeys: all funnels with step definitions and conversion windows.
• •get_journey_results: per-step conversion rates, drop-off counts, median time between steps.
• •list_api_keys: your keys with names, prefixes, allowed origins, and last-used dates.

Limits

Same rules as the API

• •MCP tool calls share your API rate limits (Free: 100 requests/min).
• •Data access follows your tier. Journey results require Pro. Event caps still apply.
• •Read queries don’t count toward your monthly event cap.

Frequently Asked Questions