Zovo Client Report
Weekly and monthly KPI reports
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
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": {
"client-report": {
"url": "https://client-report.zovo.one/mcp"
}
}
}Remote endpoints
https://client-report.zovo.one/mcpstreamable-httpWhat it can do
Tool inventory
Tools (2)
🟢generate_client_report(client_name, metrics, data, file, period, ...)
Use this when the user wants a weekly or monthly client report, a monthly marketing report, a KPI report or a client report template filled with their numbers: metrics for this period and the previous period, typed ("Sessions 12,400 vs 10,900"), pasted as a table, or an uploaded CSV/Excel export with a date column (Google Analytics, Search Console, Meta Ads, Shopify). Returns the changes (absolute and %), rates recomputed from totals (CTR = clicks / impressions), highlights stated from the computed changes only, and a client-ready PDF (title, client, period, KPI tiles with arrows, change chart, optional notes from the user) plus Excel and CSV. Does not connect to analytics or ad accounts, does not invent numbers or reasons, and is not for forecasts.
Input Schema
{
"type": "object",
"properties": {
"client_name": {
"description": "Optional: the client's name for the report title, e.g. \"Northwind Dental\". Default: Client.",
"type": [
"string",
"number"
]
},
"metrics": {
"description": "The metrics, this period and the previous period. Any of: a list like [{\"name\":\"Sessions\",\"current\":12400,\"previous\":10900},{\"name\":\"Revenue\",\"current\":\"$8,450\",\"previous\":\"$7,900\"}]; an object like {\"Sessions\":[12400,10900]}; or text like \"Sessions: 12,400 vs 10,900; Clicks 1,180 vs 1,010\". Values may be strings with $, %, k or commas. Optional fields per metric: format (number, money, percent, ratio, duration), higher_is_better (false for cost per click, bounce rate).",
"anyOf": [
{
"type": "array",
"items": {}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "string"
}
]
},
"data": {
"description": "Optional: a pasted CSV/TSV table instead of metrics. Either a daily or weekly export with a Date column and metric columns (e.g. \"Date,Sessions,Clicks,Impressions\\n2026-10-01,410,22,1900\"), or a Metric | This month | Last month table.",
"type": "string",
"maxLength": 400000
},
"file": {
"type": "object",
"properties": {
"download_url": {
"type": "string",
"description": "Temporary download link for the file, supplied by ChatGPT."
},
"file_id": {
"type": "string",
"description": "ChatGPT file id, e.g. file_abc123."
},
"mime_type": {
"description": "Media type if known, e.g. application/pdf.",
"type": "string"
},
"file_name": {
"description": "Original file name if known, e.g. statement.pdf.",
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"description": "Optional: an uploaded CSV or Excel (.xlsx) export, e.g. ga4-sessions.csv, search-console-dates.csv, meta-ads.xlsx or shopify-sales.csv. A Date column plus metric columns, or a Metric | This period | Previous period table."
},
"period": {
"description": "Optional for exports with dates: week, month, quarter or auto (default). auto compares calendar months when the data covers whole months, otherwise the latest half of the dates against the half before. Example: month.",
"type": "string",
"maxLength": 40
},
"current_period": {
"description": "Optional: dates of this period, e.g. \"2026-10-01 to 2026-10-31\" or \"Oct 2026\". Used to split a dated export and as the label in the report.",
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": [
"string",
"number"
]
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
]
},
"previous_period": {
"description": "Optional: dates or label of the previous period, e.g. \"Sep 2026\". Default: the same length right before current_period.",
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": [
"string",
"number"
]
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
]
},
"pair_order": {
"description": "Optional: current_first (default: \"Sessions 1200 1000\" means 1,200 now, 1,000 before) or previous_first. Words such as vs, from ... to, or column headers like This month / Last month always win.",
"type": "string",
"maxLength": 30
},
"date_order": {
"description": "Optional: MDY (US, default) or DMY for dates such as 03/10/2026.",
"type": "string",
"maxLength": 20
},
"currency": {
"description": "Optional: currency for money metrics without a symbol, e.g. USD, EUR, GBP. Default USD.",
"type": "string",
"maxLength": 10
},
"lower_is_better": {
"description": "Optional: metric names where a decrease is good, beyond the built-in ones (cost per click, CPA, CPM, bounce rate, position, churn), e.g. [\"Refund requests\"].",
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "string"
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
]
},
"report_title": {
"description": "Optional: report title, e.g. \"Monthly SEO report\". Default: Weekly report, Monthly report or Performance report from the period.",
"type": "string",
"maxLength": 80
},
"prepared_by": {
"description": "Optional: your name or agency name shown in the header, e.g. \"Brightside Marketing\".",
"type": "string",
"maxLength": 80
},
"notes": {
"description": "Optional: your own commentary for the client, printed word for word under Notes, e.g. \"We launched the new landing page on Oct 14.\" Never invented by the tool.",
"type": "string",
"maxLength": 100000
},
"accent_color": {
"description": "Optional: brand colour for the header bar, hex like #1F3A5F or a name like navy, teal. Default navy.",
"type": "string",
"maxLength": 20
},
"paper": {
"description": "Optional: letter (default) or A4.",
"type": "string",
"maxLength": 20
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"headline": {
"type": "string"
},
"client": {
"type": "string"
},
"title": {
"type": "string"
},
"period": {
"type": "object",
"properties": {
"current": {
"type": "string"
},
"previous": {
"type": "string"
},
"current_start": {
"type": [
"string",
"null"
]
},
"current_end": {
"type": [
"string",
"null"
]
},
"previous_start": {
"type": [
"string",
"null"
]
},
"previous_end": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
}
},
"required": [
"current",
"previous",
"current_start",
"current_end",
"previous_start",
"previous_end",
"source"
],
"additionalProperties": false
},
"counts": {
"type": "object",
"properties": {
"metrics": {
"type": "number"
},
"shown": {
"type": "number"
},
"improved": {
"type": "number"
},
"worsened": {
"type": "number"
},
"unchanged": {
"type": "number"
},
"neutral": {
"type": "number"
}
},
"required": [
"metrics",
"shown",
"improved",
"worsened",
"unchanged",
"neutral"
],
"additionalProperties": false
},
"metrics": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"format": {
"type": "string"
},
"current": {
"type": "number"
},
"previous": {
"type": "number"
},
"change": {
"type": "number"
},
"change_pct": {
"type": [
"number",
"null"
]
},
"current_display": {
"type": "string"
},
"previous_display": {
"type": "string"
},
"change_display": {
"type": "string"
},
"change_pct_display": {
"type": "string"
},
"direction": {
"type": "string"
},
"verdict": {
"type": "string"
},
"computed": {
"type": "boolean"
},
"note": {
"type": "string"
}
},
"required": [
"name",
"format",
"current",
"previous",
"change",
"change_pct",
"current_display",
"previous_display",
"change_display",
"change_pct_display",
"direction",
"verdict",
"computed",
"note"
],
"additionalProperties": false
}
},
"highlights": {
"type": "array",
"items": {
"type": "string"
}
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"downloads": {
"type": "object",
"properties": {
"pdf": {
"type": "string"
},
"xlsx": {
"type": "string"
},
"csv": {
"type": "string"
}
},
"required": [
"pdf",
"xlsx",
"csv"
],
"additionalProperties": false
}
},
"required": [
"headline",
"client",
"title",
"period",
"counts",
"metrics",
"highlights",
"assumptions",
"warnings",
"downloads"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢summarize_metric_changes(metrics, data, file, period, current_period, ...)
Use this when the user wants a quick period-over-period (week over week, month over month) change table for their metrics without a PDF: "what changed vs last month", "month over month change", "calculate % change for these KPIs". Takes the same inputs as generate_client_report (typed pairs, a pasted table or a CSV/Excel export with dates) and returns absolute and % changes, rates recomputed from totals, computed highlights, and Excel and CSV files. Use generate_client_report when the user wants a client-ready PDF report. Does not connect to analytics accounts and does not explain why numbers changed.
Input Schema
{
"type": "object",
"properties": {
"metrics": {
"description": "The metrics, this period and the previous period. Any of: a list like [{\"name\":\"Sessions\",\"current\":12400,\"previous\":10900},{\"name\":\"Revenue\",\"current\":\"$8,450\",\"previous\":\"$7,900\"}]; an object like {\"Sessions\":[12400,10900]}; or text like \"Sessions: 12,400 vs 10,900; Clicks 1,180 vs 1,010\". Values may be strings with $, %, k or commas. Optional fields per metric: format (number, money, percent, ratio, duration), higher_is_better (false for cost per click, bounce rate).",
"anyOf": [
{
"type": "array",
"items": {}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "string"
}
]
},
"data": {
"description": "Optional: a pasted CSV/TSV table instead of metrics. Either a daily or weekly export with a Date column and metric columns (e.g. \"Date,Sessions,Clicks,Impressions\\n2026-10-01,410,22,1900\"), or a Metric | This month | Last month table.",
"type": "string",
"maxLength": 400000
},
"file": {
"type": "object",
"properties": {
"download_url": {
"type": "string",
"description": "Temporary download link for the file, supplied by ChatGPT."
},
"file_id": {
"type": "string",
"description": "ChatGPT file id, e.g. file_abc123."
},
"mime_type": {
"description": "Media type if known, e.g. application/pdf.",
"type": "string"
},
"file_name": {
"description": "Original file name if known, e.g. statement.pdf.",
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"description": "Optional: an uploaded CSV or Excel (.xlsx) export, e.g. ga4-sessions.csv, search-console-dates.csv, meta-ads.xlsx or shopify-sales.csv. A Date column plus metric columns, or a Metric | This period | Previous period table."
},
"period": {
"description": "Optional for exports with dates: week, month, quarter or auto (default). auto compares calendar months when the data covers whole months, otherwise the latest half of the dates against the half before. Example: month.",
"type": "string",
"maxLength": 40
},
"current_period": {
"description": "Optional: dates of this period, e.g. \"2026-10-01 to 2026-10-31\" or \"Oct 2026\". Used to split a dated export and as the label in the report.",
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": [
"string",
"number"
]
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
]
},
"previous_period": {
"description": "Optional: dates or label of the previous period, e.g. \"Sep 2026\". Default: the same length right before current_period.",
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": [
"string",
"number"
]
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
]
},
"pair_order": {
"description": "Optional: current_first (default: \"Sessions 1200 1000\" means 1,200 now, 1,000 before) or previous_first. Words such as vs, from ... to, or column headers like This month / Last month always win.",
"type": "string",
"maxLength": 30
},
"date_order": {
"description": "Optional: MDY (US, default) or DMY for dates such as 03/10/2026.",
"type": "string",
"maxLength": 20
},
"currency": {
"description": "Optional: currency for money metrics without a symbol, e.g. USD, EUR, GBP. Default USD.",
"type": "string",
"maxLength": 10
},
"lower_is_better": {
"description": "Optional: metric names where a decrease is good, beyond the built-in ones (cost per click, CPA, CPM, bounce rate, position, churn), e.g. [\"Refund requests\"].",
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "string"
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"headline": {
"type": "string"
},
"client": {
"type": "string"
},
"title": {
"type": "string"
},
"period": {
"type": "object",
"properties": {
"current": {
"type": "string"
},
"previous": {
"type": "string"
},
"current_start": {
"type": [
"string",
"null"
]
},
"current_end": {
"type": [
"string",
"null"
]
},
"previous_start": {
"type": [
"string",
"null"
]
},
"previous_end": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
}
},
"required": [
"current",
"previous",
"current_start",
"current_end",
"previous_start",
"previous_end",
"source"
],
"additionalProperties": false
},
"counts": {
"type": "object",
"properties": {
"metrics": {
"type": "number"
},
"shown": {
"type": "number"
},
"improved": {
"type": "number"
},
"worsened": {
"type": "number"
},
"unchanged": {
"type": "number"
},
"neutral": {
"type": "number"
}
},
"required": [
"metrics",
"shown",
"improved",
"worsened",
"unchanged",
"neutral"
],
"additionalProperties": false
},
"metrics": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"format": {
"type": "string"
},
"current": {
"type": "number"
},
"previous": {
"type": "number"
},
"change": {
"type": "number"
},
"change_pct": {
"type": [
"number",
"null"
]
},
"current_display": {
"type": "string"
},
"previous_display": {
"type": "string"
},
"change_display": {
"type": "string"
},
"change_pct_display": {
"type": "string"
},
"direction": {
"type": "string"
},
"verdict": {
"type": "string"
},
"computed": {
"type": "boolean"
},
"note": {
"type": "string"
}
},
"required": [
"name",
"format",
"current",
"previous",
"change",
"change_pct",
"current_display",
"previous_display",
"change_display",
"change_pct_display",
"direction",
"verdict",
"computed",
"note"
],
"additionalProperties": false
}
},
"highlights": {
"type": "array",
"items": {
"type": "string"
}
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"downloads": {
"type": "object",
"properties": {
"xlsx": {
"type": "string"
},
"csv": {
"type": "string"
}
},
"required": [
"xlsx",
"csv"
],
"additionalProperties": false
}
},
"required": [
"headline",
"client",
"title",
"period",
"counts",
"metrics",
"highlights",
"assumptions",
"warnings",
"downloads"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}Community
Evidence