@velaro/mcp-server 2.0.28 → 2.0.29
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -1
- package/package.json +1 -1
- package/server.js +24 -0
package/README.md
CHANGED
|
@@ -187,7 +187,8 @@ This works with any MCP client that supports HTTP/SSE transport — including Cl
|
|
|
187
187
|
| `report_roi_summary` | Full ROI report — bot deflections, hours saved, cost savings, AI skill executions, resolution rate, response time, trends vs prior period, monthly breakdown, top skills by call count, channel breakdown |
|
|
188
188
|
| `report_agent_utilization` | Per-agent stats — conversation count, avg handle time, active/away breakdown for any date range |
|
|
189
189
|
| `report_visitor_traffic_overview` | Visitor Traffic report (velaro-messaging) — daily visit trend, top countries and chat-channel breakdown for any date range |
|
|
190
|
-
| `report_campaign_performance` | Email campaign KPIs — open rate, click rate, delivery rate, complaint rate per campaign + aggregate totals |
|
|
190
|
+
| `report_campaign_performance` | Email campaign KPIs — open rate, click rate, delivery rate, complaint rate per campaign + aggregate totals, plus order revenue attributed to campaign email clicks/opens |
|
|
191
|
+
| `campaign_revenue_window_get` / `campaign_revenue_window_set` | Read or change the order revenue attribution window (1-30 days, default 5) |
|
|
191
192
|
| `report_campaign_deliverability` | Deliverability health check — bounce rate, complaint rate, unsubscribe rate, open rate with traffic-light status and fix recommendations |
|
|
192
193
|
| `report_campaign_monthly` | Month-by-month email volume for the last 12 months |
|
|
193
194
|
| `report_audience_growth` | Total active contacts, net contacts (minus unsubscribes), month-by-month additions |
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@velaro/mcp-server",
|
|
3
|
-
"version": "2.0.
|
|
3
|
+
"version": "2.0.29",
|
|
4
4
|
"description": "Velaro MCP server — connect Claude and other AI agents directly to your Velaro account: KB, workflows, bots, conversations, contacts, routing, and more.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
package/server.js
CHANGED
|
@@ -2367,6 +2367,16 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
|
|
|
2367
2367
|
},
|
|
2368
2368
|
},
|
|
2369
2369
|
},
|
|
2370
|
+
{
|
|
2371
|
+
name: 'campaign_revenue_window_get',
|
|
2372
|
+
description: 'Get the order revenue attribution window in days (an order counts toward a campaign when it follows the contact\'s last email click or open within this window). Default 5.',
|
|
2373
|
+
inputSchema: { type: 'object', properties: {} },
|
|
2374
|
+
},
|
|
2375
|
+
{
|
|
2376
|
+
name: 'campaign_revenue_window_set',
|
|
2377
|
+
description: 'Set the order revenue attribution window in days (1-30). Applies to orders attributed from now on.',
|
|
2378
|
+
inputSchema: { type: 'object', properties: { windowDays: { type: 'number', description: '1 to 30' } }, required: ['windowDays'] },
|
|
2379
|
+
},
|
|
2370
2380
|
{
|
|
2371
2381
|
name: 'report_campaign_deliverability',
|
|
2372
2382
|
description: 'Deliverability health check — bounce rate, complaint rate, unsubscribe rate, open rate. Each metric has a traffic-light status (green/yellow/red) and actionable recommendations.',
|
|
@@ -6953,6 +6963,10 @@ reply: ${r?.reply}`;
|
|
|
6953
6963
|
const lines = [
|
|
6954
6964
|
`=== Campaign Performance (last ${days} days, ${s.campaignCount ?? 0} campaigns) ===`,
|
|
6955
6965
|
`Total Sent: ${s.totalSent ?? 0} | Opens: ${s.totalOpened ?? 0} (${s.avgOpenRate ?? 0}%) | Clicks: ${s.totalClicked ?? 0} (${s.avgClickRate ?? 0}%)`,
|
|
6966
|
+
`Attributed revenue: ${s.attributedRevenue ?? 0} from ${s.attributedOrders ?? 0} orders (last email click/open within the attribution window)`,
|
|
6967
|
+
...(Array.isArray(r.revenueByCampaign) && r.revenueByCampaign.length
|
|
6968
|
+
? r.revenueByCampaign.map(x => ` campaign ${x.broadcastId}: ${x.orders} orders, revenue ${x.revenue}`)
|
|
6969
|
+
: []),
|
|
6956
6970
|
'',
|
|
6957
6971
|
'--- Per Campaign ---',
|
|
6958
6972
|
...(Array.isArray(r.campaigns) && r.campaigns.length
|
|
@@ -6964,6 +6978,16 @@ reply: ${r?.reply}`;
|
|
|
6964
6978
|
return lines.join('\n');
|
|
6965
6979
|
}
|
|
6966
6980
|
|
|
6981
|
+
case 'campaign_revenue_window_get': {
|
|
6982
|
+
const r = await api('GET', '/CampaignReports/RevenueSettings');
|
|
6983
|
+
return `Revenue attribution window: ${r.windowDays} days (max ${r.maxWindowDays})`;
|
|
6984
|
+
}
|
|
6985
|
+
|
|
6986
|
+
case 'campaign_revenue_window_set': {
|
|
6987
|
+
const r = await api('PUT', '/CampaignReports/RevenueSettings', { windowDays: args.windowDays });
|
|
6988
|
+
return `Revenue attribution window set to ${r.windowDays} days.`;
|
|
6989
|
+
}
|
|
6990
|
+
|
|
6967
6991
|
case 'report_campaign_deliverability': {
|
|
6968
6992
|
const days = args.days ?? 30;
|
|
6969
6993
|
const r = await api('GET', `/CampaignReports/Deliverability?days=${days}`);
|