claude-plugin-wordpress-manager 2.3.1 → 2.4.0

package/hooks/hooks.json

@@ -60,6 +60,24 @@
             "prompt": "The agent is about to DELETE a WooCommerce webhook. This will stop notifications to the configured delivery URL. Verify the user explicitly requested this deletion and understands that external integrations depending on this webhook will stop receiving events."
           }
         ]
+      },
+      {
+        "matcher": "mcp__wp-rest-bridge__mc_send_campaign",
+        "hooks": [
+          {
+            "type": "prompt",
+            "prompt": "The agent is about to SEND a Mailchimp email campaign. This will deliver emails to all subscribers in the target audience. Verify the user explicitly requested this send and has reviewed the campaign content. Respond 'approve' only if the send was clearly intentional."
+          }
+        ]
+      },
+      {
+        "matcher": "mcp__wp-rest-bridge__sg_send_email",
+        "hooks": [
+          {
+            "type": "prompt",
+            "prompt": "The agent is about to SEND an email via SendGrid. Verify the user explicitly requested this email send and the recipient list is correct. Respond 'approve' only if intentional."
+          }
+        ]
       }
     ]
   }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "claude-plugin-wordpress-manager",
-  "version": "2.3.1",
-  "description": "Unified WordPress management and development plugin for Claude Code. Orchestrates Hostinger MCP, WP REST API bridge (85 tools incl. 30 WooCommerce + 10 Multisite + 4 Webhooks), and WordPress.com MCP with 33 skills, 11 agents, and security hooks. v2.3.0 adds programmatic SEO, content-commerce attribution, and multi-language network skills.",
+  "version": "2.4.0",
+  "description": "Unified WordPress management and development plugin for Claude Code. Orchestrates Hostinger MCP, WP REST API bridge (103 tools incl. 30 WooCommerce + 10 Multisite + 4 Webhooks + 7 Mailchimp + 5 Buffer + 6 SendGrid), and WordPress.com MCP with 34 skills, 12 agents, and security hooks. v2.4.0 adds social/email distribution connectors (Mailchimp, Buffer, SendGrid).",
   "author": {
     "name": "vinmor",
     "email": "morreale.v@gmail.com"
@@ -41,7 +41,13 @@
     "attribution",
     "multilingual",
     "hreflang",
-    "international-seo"
+    "international-seo",
+    "mailchimp",
+    "buffer",
+    "sendgrid",
+    "social-media",
+    "email-marketing",
+    "content-distribution"
   ],
   "repository": {
     "type": "git",

package/servers/wp-rest-bridge/build/tools/buffer.d.ts

@@ -0,0 +1,3 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const bufferTools: Tool[];
+export declare const bufferHandlers: Record<string, Function>;

package/servers/wp-rest-bridge/build/tools/buffer.js

@@ -0,0 +1,205 @@
+import { makeBufferRequest, hasBuffer } from '../wordpress.js';
+import { z } from 'zod';
+// ── Zod Schemas ─────────────────────────────────────────────────
+const bufListProfilesSchema = z.object({}).strict();
+const bufCreateUpdateSchema = z.object({
+    profile_ids: z.array(z.string())
+        .describe('Array of Buffer profile IDs to post to'),
+    text: z.string()
+        .describe('Text content of the social media post'),
+    media: z.object({
+        link: z.string().optional().describe('URL to attach'),
+        description: z.string().optional().describe('Description for the media'),
+        picture: z.string().optional().describe('URL of an image to attach'),
+    }).optional()
+        .describe('Optional media attachment (link, description, picture)'),
+    scheduled_at: z.string().optional()
+        .describe('Scheduled publish time in ISO 8601 format'),
+    shorten: z.boolean().optional()
+        .describe('Whether to shorten links in the post'),
+}).strict();
+const bufListPendingSchema = z.object({
+    profile_id: z.string().describe('Buffer profile ID'),
+    count: z.number().optional()
+        .describe('Number of updates to return'),
+    page: z.number().optional()
+        .describe('Page number for pagination'),
+}).strict();
+const bufListSentSchema = z.object({
+    profile_id: z.string().describe('Buffer profile ID'),
+    count: z.number().optional()
+        .describe('Number of updates to return'),
+    page: z.number().optional()
+        .describe('Page number for pagination'),
+}).strict();
+const bufGetAnalyticsSchema = z.object({
+    update_id: z.string().describe('Buffer update ID'),
+}).strict();
+// ── Tool Definitions ────────────────────────────────────────────
+export const bufferTools = [
+    {
+        name: "buf_list_profiles",
+        description: "Lists all Buffer social media profiles connected to the account",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    {
+        name: "buf_create_update",
+        description: "Creates a new social media post (update) via Buffer",
+        inputSchema: {
+            type: "object",
+            properties: {
+                profile_ids: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Array of Buffer profile IDs to post to",
+                },
+                text: { type: "string", description: "Text content of the social media post" },
+                media: {
+                    type: "object",
+                    properties: {
+                        link: { type: "string", description: "URL to attach" },
+                        description: { type: "string", description: "Description for the media" },
+                        picture: { type: "string", description: "URL of an image to attach" },
+                    },
+                    description: "Optional media attachment (link, description, picture)",
+                },
+                scheduled_at: { type: "string", description: "Scheduled publish time in ISO 8601 format" },
+                shorten: { type: "boolean", description: "Whether to shorten links in the post" },
+            },
+            required: ["profile_ids", "text"],
+        },
+    },
+    {
+        name: "buf_list_pending",
+        description: "Lists pending (scheduled) updates for a Buffer profile",
+        inputSchema: {
+            type: "object",
+            properties: {
+                profile_id: { type: "string", description: "Buffer profile ID" },
+                count: { type: "number", description: "Number of updates to return" },
+                page: { type: "number", description: "Page number for pagination" },
+            },
+            required: ["profile_id"],
+        },
+    },
+    {
+        name: "buf_list_sent",
+        description: "Lists sent updates for a Buffer profile with engagement stats",
+        inputSchema: {
+            type: "object",
+            properties: {
+                profile_id: { type: "string", description: "Buffer profile ID" },
+                count: { type: "number", description: "Number of updates to return" },
+                page: { type: "number", description: "Page number for pagination" },
+            },
+            required: ["profile_id"],
+        },
+    },
+    {
+        name: "buf_get_analytics",
+        description: "Gets interaction analytics for a specific Buffer update",
+        inputSchema: {
+            type: "object",
+            properties: {
+                update_id: { type: "string", description: "Buffer update ID" },
+            },
+            required: ["update_id"],
+        },
+    },
+];
+// ── Handlers ────────────────────────────────────────────────────
+export const bufferHandlers = {
+    buf_list_profiles: async (_params) => {
+        if (!hasBuffer()) {
+            return { toolResult: { isError: true, content: [{ type: "text", text: "Buffer not configured. Add buffer_access_token to WP_SITES_CONFIG." }] } };
+        }
+        try {
+            const response = await makeBufferRequest("GET", "profiles.json");
+            return { toolResult: { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] } };
+        }
+        catch (error) {
+            const errorMessage = error.response?.data?.message || error.message;
+            return { toolResult: { isError: true, content: [{ type: "text", text: `Error listing Buffer profiles: ${errorMessage}` }] } };
+        }
+    },
+    buf_create_update: async (params) => {
+        if (!hasBuffer()) {
+            return { toolResult: { isError: true, content: [{ type: "text", text: "Buffer not configured. Add buffer_access_token to WP_SITES_CONFIG." }] } };
+        }
+        try {
+            const { profile_ids, text, media, scheduled_at, shorten } = params;
+            const body = { profile_ids, text };
+            if (media)
+                body.media = media;
+            if (scheduled_at)
+                body.scheduled_at = scheduled_at;
+            if (shorten !== undefined)
+                body.shorten = shorten;
+            const response = await makeBufferRequest("POST", "updates/create.json", body);
+            return { toolResult: { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] } };
+        }
+        catch (error) {
+            const errorMessage = error.response?.data?.message || error.message;
+            return { toolResult: { isError: true, content: [{ type: "text", text: `Error creating Buffer update: ${errorMessage}` }] } };
+        }
+    },
+    buf_list_pending: async (params) => {
+        if (!hasBuffer()) {
+            return { toolResult: { isError: true, content: [{ type: "text", text: "Buffer not configured. Add buffer_access_token to WP_SITES_CONFIG." }] } };
+        }
+        try {
+            const { profile_id, count, page } = params;
+            const query = {};
+            if (count !== undefined)
+                query.count = count;
+            if (page !== undefined)
+                query.page = page;
+            const qs = Object.entries(query).map(([k, v]) => `${k}=${v}`).join('&');
+            const endpoint = `profiles/${profile_id}/updates/pending.json${qs ? '?' + qs : ''}`;
+            const response = await makeBufferRequest("GET", endpoint);
+            return { toolResult: { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] } };
+        }
+        catch (error) {
+            const errorMessage = error.response?.data?.message || error.message;
+            return { toolResult: { isError: true, content: [{ type: "text", text: `Error listing pending updates: ${errorMessage}` }] } };
+        }
+    },
+    buf_list_sent: async (params) => {
+        if (!hasBuffer()) {
+            return { toolResult: { isError: true, content: [{ type: "text", text: "Buffer not configured. Add buffer_access_token to WP_SITES_CONFIG." }] } };
+        }
+        try {
+            const { profile_id, count, page } = params;
+            const query = {};
+            if (count !== undefined)
+                query.count = count;
+            if (page !== undefined)
+                query.page = page;
+            const qs = Object.entries(query).map(([k, v]) => `${k}=${v}`).join('&');
+            const endpoint = `profiles/${profile_id}/updates/sent.json${qs ? '?' + qs : ''}`;
+            const response = await makeBufferRequest("GET", endpoint);
+            return { toolResult: { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] } };
+        }
+        catch (error) {
+            const errorMessage = error.response?.data?.message || error.message;
+            return { toolResult: { isError: true, content: [{ type: "text", text: `Error listing sent updates: ${errorMessage}` }] } };
+        }
+    },
+    buf_get_analytics: async (params) => {
+        if (!hasBuffer()) {
+            return { toolResult: { isError: true, content: [{ type: "text", text: "Buffer not configured. Add buffer_access_token to WP_SITES_CONFIG." }] } };
+        }
+        try {
+            const { update_id } = params;
+            const response = await makeBufferRequest("GET", `updates/${update_id}/interactions.json`);
+            return { toolResult: { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] } };
+        }
+        catch (error) {
+            const errorMessage = error.response?.data?.message || error.message;
+            return { toolResult: { isError: true, content: [{ type: "text", text: `Error getting update analytics: ${errorMessage}` }] } };
+        }
+    },
+};

package/servers/wp-rest-bridge/build/tools/index.js

@@ -15,6 +15,9 @@ import { wcSettingTools, wcSettingHandlers } from './wc-settings.js';
 import { multisiteSiteTools, multisiteSiteHandlers } from './multisite-sites.js';
 import { multisiteNetworkTools, multisiteNetworkHandlers } from './multisite-network.js';
 import { wcWebhookTools, wcWebhookHandlers } from './wc-webhooks.js';
+import { mailchimpTools, mailchimpHandlers } from './mailchimp.js';
+import { bufferTools, bufferHandlers } from './buffer.js';
+import { sendgridTools, sendgridHandlers } from './sendgrid.js';
 // Combine all tools
 export const allTools = [
     ...unifiedContentTools, // 8 tools
@@ -34,6 +37,9 @@ export const allTools = [
     ...multisiteSiteTools, // 5 tools
     ...multisiteNetworkTools, // 5 tools
     ...wcWebhookTools, // 4 tools
+    ...mailchimpTools, // 7 tools
+    ...bufferTools, // 5 tools
+    ...sendgridTools, // 6 tools
 ];
 // Combine all handlers
 export const toolHandlers = {
@@ -54,4 +60,7 @@ export const toolHandlers = {
     ...multisiteSiteHandlers,
     ...multisiteNetworkHandlers,
     ...wcWebhookHandlers,
+    ...mailchimpHandlers,
+    ...bufferHandlers,
+    ...sendgridHandlers,
 };

package/servers/wp-rest-bridge/build/tools/mailchimp.d.ts

@@ -0,0 +1,3 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const mailchimpTools: Tool[];
+export declare const mailchimpHandlers: Record<string, Function>;

package/servers/wp-rest-bridge/build/tools/mailchimp.js

@@ -0,0 +1,265 @@
+import { makeMailchimpRequest, hasMailchimp } from '../wordpress.js';
+import { z } from 'zod';
+// ── Zod Schemas ─────────────────────────────────────────────────
+const mcListAudiencesSchema = z.object({}).strict();
+const mcGetAudienceMembersSchema = z.object({
+    list_id: z.string().describe('Audience (list) ID'),
+    status: z.enum(['subscribed', 'unsubscribed', 'cleaned', 'pending']).optional()
+        .describe('Filter members by subscription status'),
+    count: z.number().optional().default(100)
+        .describe('Number of members to return (default 100)'),
+    offset: z.number().optional()
+        .describe('Number of members to skip (for pagination)'),
+}).strict();
+const mcCreateCampaignSchema = z.object({
+    type: z.enum(['regular', 'plaintext', 'absplit'])
+        .describe('Campaign type'),
+    list_id: z.string().describe('Audience (list) ID to send to'),
+    subject_line: z.string().describe('Email subject line'),
+    from_name: z.string().describe('Sender name shown to recipients'),
+    reply_to: z.string().describe('Reply-to email address'),
+}).strict();
+const mcUpdateCampaignContentSchema = z.object({
+    campaign_id: z.string().describe('Campaign ID'),
+    html: z.string().describe('HTML content for the campaign email'),
+}).strict();
+const mcSendCampaignSchema = z.object({
+    campaign_id: z.string().describe('Campaign ID to send'),
+}).strict();
+const mcGetCampaignReportSchema = z.object({
+    campaign_id: z.string().describe('Campaign ID to get report for'),
+}).strict();
+const mcAddSubscriberSchema = z.object({
+    list_id: z.string().describe('Audience (list) ID'),
+    email_address: z.string().describe('Subscriber email address'),
+    status: z.enum(['subscribed', 'unsubscribed', 'cleaned', 'pending'])
+        .describe('Subscription status'),
+    merge_fields: z.record(z.any()).optional()
+        .describe('Merge fields (e.g. FNAME, LNAME)'),
+    tags: z.array(z.string()).optional()
+        .describe('Tags to assign to the subscriber'),
+}).strict();
+// ── Tool Definitions ────────────────────────────────────────────
+export const mailchimpTools = [
+    {
+        name: "mc_list_audiences",
+        description: "Lists all Mailchimp audiences (lists) with member counts and stats",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    {
+        name: "mc_get_audience_members",
+        description: "Gets members of a Mailchimp audience with optional status filter",
+        inputSchema: {
+            type: "object",
+            properties: {
+                list_id: { type: "string", description: "Audience (list) ID" },
+                status: {
+                    type: "string",
+                    enum: ["subscribed", "unsubscribed", "cleaned", "pending"],
+                    description: "Filter members by subscription status",
+                },
+                count: { type: "number", description: "Number of members to return (default 100)" },
+                offset: { type: "number", description: "Number of members to skip (for pagination)" },
+            },
+            required: ["list_id"],
+        },
+    },
+    {
+        name: "mc_create_campaign",
+        description: "Creates a new Mailchimp email campaign",
+        inputSchema: {
+            type: "object",
+            properties: {
+                type: {
+                    type: "string",
+                    enum: ["regular", "plaintext", "absplit"],
+                    description: "Campaign type",
+                },
+                list_id: { type: "string", description: "Audience (list) ID to send to" },
+                subject_line: { type: "string", description: "Email subject line" },
+                from_name: { type: "string", description: "Sender name shown to recipients" },
+                reply_to: { type: "string", description: "Reply-to email address" },
+            },
+            required: ["type", "list_id", "subject_line", "from_name", "reply_to"],
+        },
+    },
+    {
+        name: "mc_update_campaign_content",
+        description: "Sets the HTML content of a Mailchimp campaign",
+        inputSchema: {
+            type: "object",
+            properties: {
+                campaign_id: { type: "string", description: "Campaign ID" },
+                html: { type: "string", description: "HTML content for the campaign email" },
+            },
+            required: ["campaign_id", "html"],
+        },
+    },
+    {
+        name: "mc_send_campaign",
+        description: "Sends a Mailchimp campaign to its audience (DESTRUCTIVE — triggers real emails)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                campaign_id: { type: "string", description: "Campaign ID to send" },
+            },
+            required: ["campaign_id"],
+        },
+    },
+    {
+        name: "mc_get_campaign_report",
+        description: "Gets performance report for a sent Mailchimp campaign (opens, clicks, bounces)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                campaign_id: { type: "string", description: "Campaign ID to get report for" },
+            },
+            required: ["campaign_id"],
+        },
+    },
+    {
+        name: "mc_add_subscriber",
+        description: "Adds or updates a subscriber in a Mailchimp audience",
+        inputSchema: {
+            type: "object",
+            properties: {
+                list_id: { type: "string", description: "Audience (list) ID" },
+                email_address: { type: "string", description: "Subscriber email address" },
+                status: {
+                    type: "string",
+                    enum: ["subscribed", "unsubscribed", "cleaned", "pending"],
+                    description: "Subscription status",
+                },
+                merge_fields: { type: "object", description: "Merge fields (e.g. FNAME, LNAME)" },
+                tags: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Tags to assign to the subscriber",
+                },
+            },
+            required: ["list_id", "email_address", "status"],
+        },
+    },
+];
+// ── Handlers ────────────────────────────────────────────────────
+export const mailchimpHandlers = {
+    mc_list_audiences: async (_params) => {
+        if (!hasMailchimp()) {
+            return { toolResult: { isError: true, content: [{ type: "text", text: "Mailchimp not configured. Add mailchimp_api_key to WP_SITES_CONFIG." }] } };
+        }
+        try {
+            const response = await makeMailchimpRequest("GET", "/lists");
+            return { toolResult: { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] } };
+        }
+        catch (error) {
+            const errorMessage = error.response?.data?.detail || error.message;
+            return { toolResult: { isError: true, content: [{ type: "text", text: `Error listing audiences: ${errorMessage}` }] } };
+        }
+    },
+    mc_get_audience_members: async (params) => {
+        if (!hasMailchimp()) {
+            return { toolResult: { isError: true, content: [{ type: "text", text: "Mailchimp not configured. Add mailchimp_api_key to WP_SITES_CONFIG." }] } };
+        }
+        try {
+            const { list_id, status, count, offset } = params;
+            const query = {};
+            if (status)
+                query.status = status;
+            if (count !== undefined)
+                query.count = count;
+            if (offset !== undefined)
+                query.offset = offset;
+            const qs = Object.entries(query).map(([k, v]) => `${k}=${v}`).join('&');
+            const endpoint = `/lists/${list_id}/members${qs ? '?' + qs : ''}`;
+            const response = await makeMailchimpRequest("GET", endpoint);
+            return { toolResult: { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] } };
+        }
+        catch (error) {
+            const errorMessage = error.response?.data?.detail || error.message;
+            return { toolResult: { isError: true, content: [{ type: "text", text: `Error getting audience members: ${errorMessage}` }] } };
+        }
+    },
+    mc_create_campaign: async (params) => {
+        if (!hasMailchimp()) {
+            return { toolResult: { isError: true, content: [{ type: "text", text: "Mailchimp not configured. Add mailchimp_api_key to WP_SITES_CONFIG." }] } };
+        }
+        try {
+            const { type, list_id, subject_line, from_name, reply_to } = params;
+            const body = {
+                type,
+                recipients: { list_id },
+                settings: { subject_line, from_name, reply_to },
+            };
+            const response = await makeMailchimpRequest("POST", "/campaigns", body);
+            return { toolResult: { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] } };
+        }
+        catch (error) {
+            const errorMessage = error.response?.data?.detail || error.message;
+            return { toolResult: { isError: true, content: [{ type: "text", text: `Error creating campaign: ${errorMessage}` }] } };
+        }
+    },
+    mc_update_campaign_content: async (params) => {
+        if (!hasMailchimp()) {
+            return { toolResult: { isError: true, content: [{ type: "text", text: "Mailchimp not configured. Add mailchimp_api_key to WP_SITES_CONFIG." }] } };
+        }
+        try {
+            const { campaign_id, html } = params;
+            const response = await makeMailchimpRequest("PUT", `/campaigns/${campaign_id}/content`, { html });
+            return { toolResult: { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] } };
+        }
+        catch (error) {
+            const errorMessage = error.response?.data?.detail || error.message;
+            return { toolResult: { isError: true, content: [{ type: "text", text: `Error updating campaign content: ${errorMessage}` }] } };
+        }
+    },
+    mc_send_campaign: async (params) => {
+        if (!hasMailchimp()) {
+            return { toolResult: { isError: true, content: [{ type: "text", text: "Mailchimp not configured. Add mailchimp_api_key to WP_SITES_CONFIG." }] } };
+        }
+        try {
+            const { campaign_id } = params;
+            const response = await makeMailchimpRequest("POST", `/campaigns/${campaign_id}/actions/send`);
+            return { toolResult: { content: [{ type: "text", text: JSON.stringify(response ?? { success: true, message: "Campaign sent successfully" }, null, 2) }] } };
+        }
+        catch (error) {
+            const errorMessage = error.response?.data?.detail || error.message;
+            return { toolResult: { isError: true, content: [{ type: "text", text: `Error sending campaign: ${errorMessage}` }] } };
+        }
+    },
+    mc_get_campaign_report: async (params) => {
+        if (!hasMailchimp()) {
+            return { toolResult: { isError: true, content: [{ type: "text", text: "Mailchimp not configured. Add mailchimp_api_key to WP_SITES_CONFIG." }] } };
+        }
+        try {
+            const { campaign_id } = params;
+            const response = await makeMailchimpRequest("GET", `/reports/${campaign_id}`);
+            return { toolResult: { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] } };
+        }
+        catch (error) {
+            const errorMessage = error.response?.data?.detail || error.message;
+            return { toolResult: { isError: true, content: [{ type: "text", text: `Error getting campaign report: ${errorMessage}` }] } };
+        }
+    },
+    mc_add_subscriber: async (params) => {
+        if (!hasMailchimp()) {
+            return { toolResult: { isError: true, content: [{ type: "text", text: "Mailchimp not configured. Add mailchimp_api_key to WP_SITES_CONFIG." }] } };
+        }
+        try {
+            const { list_id, email_address, status, merge_fields, tags } = params;
+            const body = { email_address, status };
+            if (merge_fields)
+                body.merge_fields = merge_fields;
+            if (tags)
+                body.tags = tags;
+            const response = await makeMailchimpRequest("POST", `/lists/${list_id}/members`, body);
+            return { toolResult: { content: [{ type: "text", text: JSON.stringify(response, null, 2) }] } };
+        }
+        catch (error) {
+            const errorMessage = error.response?.data?.detail || error.message;
+            return { toolResult: { isError: true, content: [{ type: "text", text: `Error adding subscriber: ${errorMessage}` }] } };
+        }
+    },
+};

package/servers/wp-rest-bridge/build/tools/sendgrid.d.ts

@@ -0,0 +1,3 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const sendgridTools: Tool[];
+export declare const sendgridHandlers: Record<string, Function>;