io.github.hholen/lodd-mcp-server
Headless web analytics for AI agents. 34 MCP tools for traffic, events, funnels.
Versions
0.1.12latestTools 42
authenticate Start Lodd authentication. Sends a verification code to the provided email. Works for both new and existing accounts.
verify_code Verify the email code and get an API key. After this succeeds, update the MCP server config with the returned API key as LODD_API_KEY and restart the server.
create_trackable_link Create a trackable link for campaign attribution. Append ?ld=<code> to your destination URL when sharing — clicks are attributed to the source in analytics.
list_trackable_links List all trackable links for a site with their click statistics
get_link_clicks Get click data for a specific trackable link, including referrers and countries. Returns up to 1000 most recent clicks.
get_active_actors List distinct actors (opaque hashed identifiers) with their event counts, first/last seen, and total revenue. Actors are customer-hashed — Lodd never sees the original identifier. Only includes events where an actor was set.
get_actor_activity Get the event timeline for a specific actor hash. Shows all events in chronological order with properties and revenue. The actor is an opaque identifier — Lodd does not know who it represents.
get_actor_retention Get weekly cohort retention by actor hash. Groups actors by the week they first appeared, then shows how many returned in weeks 1-4. Actors are opaque hashes — no personal data is stored or exposed. Requires 2+ weeks of data for meaningful results.
get_event_counts Get a summary of all custom events tracked on a site, showing event names with their total count and unique sessions. Optionally segment by country, browser, os, device type, UTM source, or referrer (matched against the session
get_events Get individual custom event records with their properties. Optionally filter by event name.
get_event_timeseries Get event counts bucketed over time for a specific event. Useful for seeing how event frequency changes. Optional filters segment by country, browser, os, device type, UTM source, or referrer (matched against the session
get_realtime Get the number of currently active visitors on a site (visitors with activity in the last 5 minutes)
get_usage Get current month
create_annotation Record a user-facing change that may affect analytics. Call after deploying changes to pages, flows, or tracking. Skip dependency updates, CI config, and refactors with no visible impact.
list_annotations List annotations (deploy notes, change records) for a site within a time period.
get_analytics Get aggregate analytics for a site (visitors, page views, bounce rate, etc.) with automatic comparison to the previous period. Returns average_duration in seconds. Optional filters segment the result by country, browser, os, device type, UTM source, or referrer.
get_snapshot Quick today vs yesterday comparison: visitors, top referrer, top country, and duration trends
get_timeseries Get visitor and page view counts bucketed over time (hourly or daily). Returns an array of {date_label, page_views, unique_visitors} objects. Optional filters segment by country, browser, os, device type, UTM source, or referrer.
get_funnel Compute a conversion funnel across an ordered sequence of pageview URLs and custom events. Returns per-step session counts and conversion rate relative to step 0. Steps must all occur within the same session, in order. Optional filters constrain which sessions enter the funnel.
get_performance Get page load time metrics (average, median, p95) grouped by page URL, device type, country, or browser. Only includes data from pages with load time measurements. Useful for identifying slow pages and correlating performance with engagement.
get_session_paths Find the most common page sequences visitors follow. Returns paths like
get_dropoff_destinations Given a URL, show where visitors go next or if they leave the site. Useful for understanding why people leave key pages like /pricing. The
get_session_scores Classify sessions into engagement buckets: bounced (1 page), browsed (2-3 pages), engaged (4+ pages or event fired), converted (conversion event fired). Optionally specify which event defines
get_event_sequences Given a target event (like
get_content_groups Group pages by URL pattern and get aggregate metrics per group. Useful for comparing how blog vs docs vs app pages perform. Patterns use SQL LIKE syntax where % matches anything.
get_pages Get pages ranked by traffic. Call twice with different periods to compare page performance over time. Optionally filter by URL path and/or segment by country, browser, os, device type, UTM source, or referrer. Returns page titles when available.
get_traffic_sources Get traffic sources: referrers, trackable links, and UTM campaigns combined. Shows where visitors are coming from. Call twice with different periods to compare source mix over time. Optional filters segment by country, browser, os, device type, UTM source, or referrer.
get_countries Get visitor geography breakdown by country. Call twice with different periods (e.g.
get_tech_breakdown Get browser, operating system, and device type distribution in one call. Optional filters segment by country, browser, os, device type, UTM source, or referrer.
get_entry_exit_pages Get entry pages (where sessions start) and exit pages (where sessions end). Shows which pages attract new visits and where users leave. Useful for identifying effective landing pages and high-exit pages that may need improvement. Optional filters segment by country, browser, os, device type, UTM source, or referrer.
get_bot_report Show bot and crawler traffic that
create_api_key Generate a new API key for the current user. Use this to create keys for managed agents, CI pipelines, or other tools that need access to your Lodd analytics. The key is shown only once — save it immediately.
list_api_keys List all API keys for the current user. Shows key prefix, name, creation date, and last used date. Does not reveal full keys.
revoke_api_key Permanently deactivate an API key. The key will immediately stop working. Use list_api_keys to find key IDs. Cannot be undone.
get_conversion_pages Find which pages lead to a specific conversion event. Shows pages viewed before the event in the same session, with conversion rate and average time to convert. Useful for identifying high-converting content.
get_source_conversions Compare traffic sources by conversion rate for a specific event. Shows which referrers, UTM campaigns, and trackable links drive the most conversions, plus average time to convert per source.
list_sites List all websites you have access to with their domains and IDs
create_site Register a new website for analytics tracking. Returns the site ID, tracking secret, and the script tag to embed.
exclude_my_ip Exclude an IP address from analytics tracking for a site. Prevents the user
share_site Give another user access to a site
list_members List all users who have access to a site, with their roles (owner or member).
remove_member Remove a user
Permissions 2
network medium env_vars low