Tagely Analytics

Read-only website analytics from Tagely: traffic, pages, UTM campaigns, referrers and conversions.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
80%
Naming quality
100%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~1,656Tokens (tool definitions)
~2.3 KBTypical response size
Moderate attention impact (1.29% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "analytics": {
      "url": "https://tagely.com/mcp"
    }
  }
}

Remote endpoints

https://tagely.com/mcpstreamable-http

What it can do

Tool inventory

Tools (6)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢get_account

The account's business name and website, its data timezone, how far back data is available, and reference values (conversion event types, device type codes). Call this first.

Input Schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
🟢get_summary(period, start_date, end_date, compare_to_previous)

Headline numbers for a date range: page views (all, and excluding bots), unique visitors, new visitors, conversions, conversion rate and event counts by type. These match the Tagely analytics page. Set compare_to_previous to also get the preceding period.

Input Schema

{
  "type": "object",
  "properties": {
    "period": {
      "type": "string",
      "enum": [
        "today",
        "yesterday",
        "last_7_days",
        "last_30_days",
        "this_month",
        "last_month",
        "custom"
      ],
      "description": "Date range. last_7_days / last_30_days end yesterday (today excluded), as on the Tagely analytics page. Default last_7_days, or custom if start_date is given."
    },
    "start_date": {
      "type": "string",
      "description": "YYYY-MM-DD, for period=custom (inclusive)."
    },
    "end_date": {
      "type": "string",
      "description": "YYYY-MM-DD, for period=custom (inclusive). A custom range covers at most 366 days."
    },
    "compare_to_previous": {
      "type": "boolean",
      "description": "Also return the same figures for the preceding period: the previous calendar month for last_month, the same days of last month so far for this_month, otherwise the period of equal length immediately before."
    }
  },
  "additionalProperties": false
}
🟢get_breakdown(dimension, period, start_date, end_date, limit)

Top values of one dimension for a date range, for visitors and for conversions - the same breakdowns as the Tagely analytics page. url: page views (excluding bots) grouped by URL without query string; conversions not available for url. utm / referer / country / device: visitor counts are new visitors' entry views; conversion counts are conversion events, attributed by the event's own UTMs (utm) or by the converting visitor's entry view (referer, country, device). Bots excluded. Device codes: D desktop, M mobile, T tablet.

Input Schema

{
  "type": "object",
  "properties": {
    "dimension": {
      "type": "string",
      "enum": [
        "url",
        "utm",
        "referer",
        "country",
        "device"
      ]
    },
    "period": {
      "type": "string",
      "enum": [
        "today",
        "yesterday",
        "last_7_days",
        "last_30_days",
        "this_month",
        "last_month",
        "custom"
      ],
      "description": "Date range. last_7_days / last_30_days end yesterday (today excluded), as on the Tagely analytics page. Default last_7_days, or custom if start_date is given."
    },
    "start_date": {
      "type": "string",
      "description": "YYYY-MM-DD, for period=custom (inclusive)."
    },
    "end_date": {
      "type": "string",
      "description": "YYYY-MM-DD, for period=custom (inclusive). A custom range covers at most 366 days."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Number of top values, default 10 (20 for url)."
    }
  },
  "required": [
    "dimension"
  ],
  "additionalProperties": false
}
🟢list_views(period, start_date, end_date, url, url_contains, ...)

Individual page view rows for a date range, newest first, with optional filters. Bots excluded unless include_bots is true. Visitor IP addresses are not included.

Input Schema

{
  "type": "object",
  "properties": {
    "period": {
      "type": "string",
      "enum": [
        "today",
        "yesterday",
        "last_7_days",
        "last_30_days",
        "this_month",
        "last_month",
        "custom"
      ],
      "description": "Date range. last_7_days / last_30_days end yesterday (today excluded), as on the Tagely analytics page. Default last_7_days, or custom if start_date is given."
    },
    "start_date": {
      "type": "string",
      "description": "YYYY-MM-DD, for period=custom (inclusive)."
    },
    "end_date": {
      "type": "string",
      "description": "YYYY-MM-DD, for period=custom (inclusive). A custom range covers at most 366 days."
    },
    "url": {
      "type": "string",
      "description": "Exact page URL."
    },
    "url_contains": {
      "type": "string",
      "description": "Substring of the page URL."
    },
    "country_code": {
      "type": "string",
      "description": "Two-letter country code."
    },
    "device_type": {
      "type": "string",
      "enum": [
        "D",
        "M",
        "T",
        "B"
      ]
    },
    "entry_views_only": {
      "type": "boolean",
      "description": "Only each visitor's first recorded view (new_vid=1)."
    },
    "include_bots": {
      "type": "boolean"
    },
    "utm_source": {
      "type": "string"
    },
    "utm_medium": {
      "type": "string"
    },
    "utm_campaign": {
      "type": "string"
    },
    "utm_term": {
      "type": "string"
    },
    "utm_content": {
      "type": "string"
    },
    "affiliate_id": {
      "type": "string",
      "description": "Tagely affiliate id (tgly_aid)."
    },
    "visitor_id": {
      "type": "string",
      "description": "Tagely visitor id (tgly_vid)."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500,
      "description": "Rows per page, default 100."
    },
    "cursor": {
      "type": "string",
      "description": "next_cursor from the previous page, to continue."
    }
  },
  "additionalProperties": false
}
🟢list_events(period, start_date, end_date, type, conversions_only, ...)

Individual event rows (leads, purchases, subscriptions etc.) for a date range, newest first, each with the URL of the page it fired on. args holds the event's own data (e.g. purchase value), decoded from JSON where possible.

Input Schema

{
  "type": "object",
  "properties": {
    "period": {
      "type": "string",
      "enum": [
        "today",
        "yesterday",
        "last_7_days",
        "last_30_days",
        "this_month",
        "last_month",
        "custom"
      ],
      "description": "Date range. last_7_days / last_30_days end yesterday (today excluded), as on the Tagely analytics page. Default last_7_days, or custom if start_date is given."
    },
    "start_date": {
      "type": "string",
      "description": "YYYY-MM-DD, for period=custom (inclusive)."
    },
    "end_date": {
      "type": "string",
      "description": "YYYY-MM-DD, for period=custom (inclusive). A custom range covers at most 366 days."
    },
    "type": {
      "type": "string",
      "description": "Event type, e.g. lead, purchase, subscribe, subscribeNoConv."
    },
    "conversions_only": {
      "type": "boolean",
      "description": "Only lead, purchase and subscribe."
    },
    "utm_source": {
      "type": "string"
    },
    "utm_medium": {
      "type": "string"
    },
    "utm_campaign": {
      "type": "string"
    },
    "utm_term": {
      "type": "string"
    },
    "utm_content": {
      "type": "string"
    },
    "affiliate_id": {
      "type": "string",
      "description": "Tagely affiliate id (tgly_aid)."
    },
    "visitor_id": {
      "type": "string",
      "description": "Tagely visitor id (tgly_vid)."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500,
      "description": "Rows per page, default 100."
    },
    "cursor": {
      "type": "string",
      "description": "next_cursor from the previous page, to continue."
    }
  },
  "additionalProperties": false
}
🟢get_visitor_journey(visitor_id)

Every view and event recorded for one visitor (up to 500 of each), in time order, as a single timeline. Get visitor_id values from list_views or list_events.

Input Schema

{
  "type": "object",
  "properties": {
    "visitor_id": {
      "type": "string",
      "description": "Tagely visitor id (tgly_vid)."
    }
  },
  "required": [
    "visitor_id"
  ],
  "additionalProperties": false
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded6 tools