@logly-uk/mcp

v1.0.2

Published

a month ago

Model Context Protocol server for Logly — privacy-first web analytics. Query stats, breakdowns, funnels and real-time visitors from Claude, Cursor or any MCP client.

Downloads

382

0High
0Medium
0Low

loglyuk

mcp model-context-protocol logly analytics web-analytics privacy claude cursor

Logly MCP server

Query your Logly web analytics from Claude, Cursor, or any Model Context Protocol client.

Logly is privacy-first web analytics — under 1 KB, cookie-free, GDPR compliant by design. This server exposes your analytics over MCP so an AI assistant can answer questions like "how did traffic change this week?" or "where is my signup funnel losing people?" — and even hand you the install snippet for a new site.

Requirements

Node.js 18 or newer
A Logly account and an API key — create one in Settings → API keys in your Logly dashboard. The key looks like logly_a1b2c3... and is shown only once.

Setup

The server runs via npx — no install step needed.

Claude Desktop

Edit claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "logly": {
      "command": "npx",
      "args": ["-y", "@logly-uk/mcp"],
      "env": { "LOGLY_API_KEY": "logly_your_key_here" }
    }
  }
}

Restart Claude Desktop.

Claude Code

claude mcp add logly -e LOGLY_API_KEY=logly_your_key_here -- npx -y @logly-uk/mcp

Cursor

Add to .cursor/mcp.json in your project (or the global one):

{
  "mcpServers": {
    "logly": {
      "command": "npx",
      "args": ["-y", "@logly-uk/mcp"],
      "env": { "LOGLY_API_KEY": "logly_your_key_here" }
    }
  }
}

Tools

| Tool | What it does | |---|---| | logly_list_sites | List every site in your account with its site ID — start here. | | logly_stats | Pageviews, sessions, visitors, bounce rate, avg duration, daily series, previous-period comparison. | | logly_breakdown | Top pages, referrers, countries and device/browser split. | | logly_realtime | Visitors active right now. | | logly_events | Custom event counts. | | logly_funnels | List a site's conversion funnels and their steps. | | logly_funnel_results | Completion counts and drop-off per funnel step. | | logly_install_snippet | The <script> tag to add Logly to a site's <head>. |

Date filters

Stats tools accept a days window (7, 30 or 90 — defaults to 30) or an explicit from / to pair (YYYY-MM-DD). If both are given, from/to wins.

Environment variables

| Variable | Required | Purpose | |---|---|---| | LOGLY_API_KEY | yes | Your Logly API key. | | LOGLY_API_BASE | no | Override the API base URL (default https://app.logly.uk). |

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme