Zovo Client Report
Weekly and monthly KPI reports
¿Debería usar esto?
Calidad y seguridad
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"client-report": {
"url": "https://client-report.zovo.one/mcp"
}
}
}Puntos de conexión remotos
https://client-report.zovo.one/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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
}Comunidad
Evidencia