@velaro/mcp-server 2.0.133 → 2.0.135
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/package.json +1 -1
- package/parity/campaign-hub.customer.js +46 -0
- package/server.js +1 -1
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@velaro/mcp-server",
|
|
3
|
-
"version": "2.0.
|
|
3
|
+
"version": "2.0.135",
|
|
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": {
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
// MCP parity for `velaro campaigns hub overview | calendar | health` (cli/lib/commands/campaigns.js).
|
|
2
|
+
// Campaign Hub: the 30 day overview, the send calendar and the deliverability health score for your email campaigns.
|
|
3
|
+
// The site comes from the credential only (the server reads it from the token); no tool takes a siteId.
|
|
4
|
+
// Backend: CampaignHubController (GET CampaignHub/Overview, GET CampaignHub/Calendar, GET CampaignHub/HealthScore).
|
|
5
|
+
// Part of the Campaign Hub suite (entitlement CampaignHubSuite); without it the server answers 402 and says to see your plan.
|
|
6
|
+
|
|
7
|
+
const isoDay = (v, n) => {
|
|
8
|
+
const s = String(v);
|
|
9
|
+
if (!/^\d{4}-\d{2}-\d{2}$/.test(s) || Number.isNaN(Date.parse(s))) throw new Error(n + ' must be a date like 2026-11-30');
|
|
10
|
+
return s;
|
|
11
|
+
};
|
|
12
|
+
|
|
13
|
+
export const tools = [
|
|
14
|
+
{
|
|
15
|
+
name: 'campaign_hub_overview',
|
|
16
|
+
description: 'Campaign Hub overview for the last 30 days: emails sent, open rate, click rate, revenue from orders attributed to campaign email, how your list grew (added, unsubscribed, net), your top campaigns, and a 30 point daily series. Use it for "how are my email campaigns doing".',
|
|
17
|
+
inputSchema: { type: 'object', properties: {} },
|
|
18
|
+
},
|
|
19
|
+
{
|
|
20
|
+
name: 'campaign_hub_calendar',
|
|
21
|
+
description: 'Send calendar: broadcasts sent or scheduled and automated sequence emails sent or scheduled between two dates. Defaults to the current month and the weeks after it; the range can be at most 93 days.',
|
|
22
|
+
inputSchema: {
|
|
23
|
+
type: 'object',
|
|
24
|
+
properties: {
|
|
25
|
+
from: { type: 'string', description: 'First day, like 2026-11-01 (optional)' },
|
|
26
|
+
to: { type: 'string', description: 'Day after the last day, like 2026-12-01 (optional)' },
|
|
27
|
+
},
|
|
28
|
+
},
|
|
29
|
+
},
|
|
30
|
+
{
|
|
31
|
+
name: 'campaign_hub_health_score',
|
|
32
|
+
description: 'Deliverability health score from 0 to 100 for your email sending: sender authentication (SPF, DKIM, DMARC), spam complaint rate and bounce rate over the last 30 days, with a plain-language list of what to fix. Use it when email lands in spam or before a big send.',
|
|
33
|
+
inputSchema: { type: 'object', properties: {} },
|
|
34
|
+
},
|
|
35
|
+
];
|
|
36
|
+
|
|
37
|
+
export const handlers = {
|
|
38
|
+
campaign_hub_overview: async (_a, ctx) => ctx.api('GET', '/CampaignHub/Overview'),
|
|
39
|
+
campaign_hub_calendar: async (a, ctx) => {
|
|
40
|
+
const qs = [];
|
|
41
|
+
if (a.from !== undefined && a.from !== '') qs.push('from=' + encodeURIComponent(isoDay(a.from, 'from')));
|
|
42
|
+
if (a.to !== undefined && a.to !== '') qs.push('to=' + encodeURIComponent(isoDay(a.to, 'to')));
|
|
43
|
+
return ctx.api('GET', '/CampaignHub/Calendar' + (qs.length ? '?' + qs.join('&') : ''));
|
|
44
|
+
},
|
|
45
|
+
campaign_hub_health_score: async (_a, ctx) => ctx.api('GET', '/CampaignHub/HealthScore'),
|
|
46
|
+
};
|
package/server.js
CHANGED
|
@@ -5625,7 +5625,7 @@ For multiSelect dynamic options: the variable named in dynamicOptionsVariable mu
|
|
|
5625
5625
|
},
|
|
5626
5626
|
{
|
|
5627
5627
|
name: 'contacts_api_custom_fields',
|
|
5628
|
-
description: "List the site's custom contact field definitions (
|
|
5628
|
+
description: "List the site's custom contact field definitions (secure and internal fields are never returned).",
|
|
5629
5629
|
inputSchema: {"type": "object", "properties": {}},
|
|
5630
5630
|
},
|
|
5631
5631
|
{
|