Back to Directory/Analytics & BI

io.github.hholen/lodd-mcp-server

Headless web analytics for AI agents. 42 MCP tools for traffic, events, funnels.

Analytics & BITypeScriptv0.1.15

@lodd/mcp-server

First-party web analytics for AI agents. You add a 2KB script, Lodd collects your site's traffic, and your agent queries your own data over MCP. It's the analytics platform, not a connector to one.

42 MCP tools covering traffic, events, funnels, conversions, sources, performance, and actor analytics. No dashboard. Your agent queries structured JSON directly.

Quick start

npx -y @lodd/mcp-server

Set LODD_API_KEY in your environment. Get a key at lodd.dev.

Claude Code / Cursor

Add to your MCP config:

{
  "mcpServers": {
    "lodd": {
      "command": "npx",
      "args": ["-y", "@lodd/mcp-server"],
      "env": {
        "LODD_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Desktop / claude.ai

Add https://api.lodd.dev/mcp as an MCP connector. OAuth handles auth automatically.

What you can ask

  • "How's traffic this week?"
  • "Show me the pages with the highest bounce rate"
  • "Build a funnel from homepage to signup to purchase"
  • "Which traffic sources drive the most conversions?"
  • "Something unusual is happening today. Investigate."

Tools

42 tools across analytics, breakdowns, events, conversions, actors, annotations, trackable links, and account management. Full reference at lodd.dev/docs.

REST API

Same data is also available via REST at api.lodd.dev/v1/. API docs at lodd.dev/api. OpenAPI spec at lodd.dev/openapi.yaml.

Pricing

Free up to 2,500 events/month. EUR 9.99/month for 100K events. All tools included on both tiers.

Links

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y @lodd/mcp-server

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-hholen-lodd-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@lodd/mcp-server"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

@lodd/mcp-servernpm

Compatible MCP Clients

io.github.hholen/lodd-mcp-server works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More