pulsemcp-cms-admin-mcp-server 0.9.27 → 0.10.0

package/build/local/src/index.integration-with-mock.js

@@ -7,7 +7,7 @@
  *
  * Mock data is passed via the PULSEMCP_MOCK_DATA environment variable.
  */
-import { readFileSync } from 'fs';
+import { existsSync, readFileSync } from 'fs';
 import { dirname, join } from 'path';
 import { fileURLToPath } from 'url';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
@@ -15,11 +15,25 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import { createMCPServer } from 'pulsemcp-cms-admin-mcp-server-shared';
 // Import the mock client factory from the shared module
 import { createMockPulseMCPAdminClient } from '../../shared/src/pulsemcp-admin-client/pulsemcp-admin-client.integration-mock.js';
-// Read version from package.json
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const packageJsonPath = join(__dirname, '..', 'package.json');
-const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
-const VERSION = packageJson.version;
+// Read version from package.json. The integration build emits this entry into a
+// nested build/ layout (build/local/src/), so walk up from the module directory
+// to locate the package.json that carries the version rather than assuming a
+// fixed depth.
+function readVersion() {
+    let dir = dirname(fileURLToPath(import.meta.url));
+    for (let i = 0; i < 6; i++) {
+        const candidate = join(dir, 'package.json');
+        if (existsSync(candidate)) {
+            return JSON.parse(readFileSync(candidate, 'utf-8')).version;
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return '0.0.0';
+}
+const VERSION = readVersion();
 async function main() {
     const transport = new StdioServerTransport();
     // Parse mock data from environment variable

package/build/shared/src/pulsemcp-admin-client/lib/create-post.js

@@ -7,7 +7,11 @@ export async function createPost(apiKey, baseUrl, params) {
     formData.append('post[title]', params.title);
     formData.append('post[body]', params.body);
     formData.append('post[slug]', params.slug);
-    formData.append('post[author_id]', params.author_id.toString());
+    // Rails permits only post[author_ids][] — send one entry per author id, in
+    // order (index 0 is the primary author).
+    params.author_ids.forEach((id) => {
+        formData.append('post[author_ids][]', id.toString());
+    });
     // Optional fields
     if (params.status)
         formData.append('post[status]', params.status);

package/build/shared/src/pulsemcp-admin-client/lib/get-posts.js

@@ -43,7 +43,7 @@ export async function getPosts(apiKey, baseUrl, params) {
                 short_description: post.short_description,
                 category: post.category,
                 status: post.status,
-                author_id: post.author_id,
+                author_ids: post.author_ids,
                 created_at: post.created_at,
                 updated_at: post.updated_at,
                 last_updated: post.last_updated,

package/build/shared/src/pulsemcp-admin-client/lib/update-post.js

@@ -10,8 +10,13 @@ export async function updatePost(apiKey, baseUrl, slug, params) {
         formData.append('post[body]', params.body);
     if (params.slug !== undefined)
         formData.append('post[slug]', params.slug);
-    if (params.author_id !== undefined)
-        formData.append('post[author_id]', params.author_id.toString());
+    // Rails permits only post[author_ids][] — send one entry per author id, in
+    // order (index 0 is the primary author).
+    if (params.author_ids !== undefined) {
+        params.author_ids.forEach((id) => {
+            formData.append('post[author_ids][]', id.toString());
+        });
+    }
     if (params.status !== undefined)
         formData.append('post[status]', params.status);
     if (params.category !== undefined)

package/build/shared/src/pulsemcp-admin-client/pulsemcp-admin-client.integration-mock.js

@@ -4,15 +4,18 @@ export function createMockPulseMCPAdminClient(mockData) {
         title: 'Test Post',
         body: '<p>Test content</p>',
         slug: 'test-post',
-        author_id: 1,
         status: 'draft',
         category: 'newsletter',
         created_at: '2024-01-01T00:00:00Z',
         updated_at: '2024-01-01T00:00:00Z',
-        author: {
-            id: 1,
-            name: 'Test Author',
-        },
+        // Ordered author ids from the list endpoint (no names).
+        author_ids: [1, 2],
+        // Ordered authors array (id + name) from the show endpoint; source of truth
+        // for reads.
+        authors: [
+            { id: 1, name: 'Test Author' },
+            { id: 2, name: 'Second Author' },
+        ],
     };
     return {
         async getPosts(params) {

package/build/shared/src/tools/draft-newsletter-post.js

@@ -166,10 +166,11 @@ Use cases:
                 const { author_slug, featured_mcp_server_slugs, featured_mcp_client_slugs, ...otherParams } = validatedArgs;
                 // Look up author by slug
                 const author = await client.getAuthorBySlug(author_slug);
-                // Always create as draft
+                // Always create as draft. author_ids is an ordered array; this tool sets
+                // a single primary author (length 1).
                 const createParams = {
                     ...otherParams,
-                    author_id: author.id,
+                    author_ids: [author.id],
                     status: 'draft',
                 };
                 // Convert slugs to IDs if provided
@@ -192,8 +193,11 @@ Use cases:
                 content += `**Slug:** ${post.slug}\n`;
                 content += `**Status:** ${post.status}\n`;
                 content += `**Category:** ${post.category}\n`;
-                if (post.author) {
-                    content += `**Author:** ${post.author.name}\n`;
+                // The ordered `authors` array is the source of truth for authorship.
+                const responseAuthors = post.authors ?? [];
+                if (responseAuthors.length > 0) {
+                    const label = responseAuthors.length > 1 ? 'Authors' : 'Author';
+                    content += `**${label}:** ${responseAuthors.map((a) => a.name).join(', ')}\n`;
                 }
                 content += `**Created:** ${new Date(post.created_at).toLocaleDateString()}\n\n`;
                 if (post.short_description) {

package/build/shared/src/tools/get-newsletter-post.js

@@ -12,7 +12,7 @@ export function getNewsletterPost(_server, clientFactory) {
         description: `Retrieve complete details for a specific newsletter post by its unique slug identifier. Returns formatted markdown with all post metadata and content.
 
 The response is formatted as markdown with sections for:
-- Post title and basic metadata (slug, status, category, author, dates)
+- Post title and basic metadata (slug, status, category, author(s), dates)
 - Summary/short description
 - Full HTML content (body field) as raw HTML
 - Complete metadata including all URLs, SEO tags, and featured items
@@ -20,7 +20,7 @@ The response is formatted as markdown with sections for:
 
 All available fields from the post are included:
 - title, slug, status, category
-- author (id and name)
+- authors (ordered list; the primary author is listed first)
 - created_at, updated_at, last_updated
 - short_title, short_description
 - body (raw HTML content)
@@ -55,28 +55,36 @@ Use cases:
             const client = clientFactory();
             try {
                 const post = await client.getPost(validatedArgs.slug);
-                // Fetch author details if we have an author_id
-                let authorSlug;
-                let authorName;
-                if (post.author_id) {
+                // The supervisor show endpoint returns the ordered `authors` array (id +
+                // name), which is the source of truth for authorship.
+                const baseAuthors = post.authors ?? [];
+                // Enrich each author with its slug (the authors array only carries id +
+                // name). Preserve position order so the primary author renders first.
+                const authorLines = [];
+                for (const a of baseAuthors) {
+                    let slug;
+                    let name = a.name;
                     try {
-                        const author = await client.getAuthorById(post.author_id);
-                        if (author) {
-                            authorSlug = author.slug;
-                            authorName = author.name;
+                        const fullAuthor = await client.getAuthorById(a.id);
+                        if (fullAuthor) {
+                            slug = fullAuthor.slug;
+                            if (!name)
+                                name = fullAuthor.name;
                         }
                     }
                     catch (error) {
-                        // If we can't fetch author, we'll just skip showing author info
+                        // If we can't fetch the author, fall back to whatever name we have.
                         console.error('Failed to fetch author details:', error);
                     }
+                    authorLines.push(slug ? `${name} (${slug}, ID: ${a.id})` : `${name} (ID: ${a.id})`);
                 }
                 // Format the response for MCP
                 let content = `# ${post.title}\n\n`;
                 content += `**Slug:** ${post.slug}\n`;
                 content += `**Status:** ${post.status} | **Category:** ${post.category}\n`;
-                if (authorSlug && authorName) {
-                    content += `**Author:** ${authorName} (${authorSlug}, ID: ${post.author_id})\n`;
+                if (authorLines.length > 0) {
+                    const label = authorLines.length > 1 ? 'Authors' : 'Author';
+                    content += `**${label}:** ${authorLines.join(', ')}\n`;
                 }
                 content += `**Created:** ${new Date(post.created_at).toLocaleDateString()}\n`;
                 content += `**Updated:** ${new Date(post.updated_at).toLocaleDateString()}\n`;

package/build/shared/src/tools/get-newsletter-posts.js

@@ -75,17 +75,25 @@ Use cases:
                 for (const [index, post] of response.posts.entries()) {
                     content += `${index + 1}. **${post.title}** (${post.slug})\n`;
                     content += `   Status: ${post.status} | Category: ${post.category}\n`;
-                    // Fetch author details if we have an author_id
-                    if (post.author_id) {
-                        try {
-                            const author = await client.getAuthorById(post.author_id);
-                            if (author) {
-                                content += `   Author: ${author.name} (${author.slug}, ID: ${author.id})\n`;
+                    // The list endpoint returns ordered author ids (no names); resolve each
+                    // to a name, preserving order so the primary author renders first.
+                    if (post.author_ids && post.author_ids.length > 0) {
+                        const authorInfo = [];
+                        for (const authorId of post.author_ids) {
+                            try {
+                                const author = await client.getAuthorById(authorId);
+                                if (author) {
+                                    authorInfo.push(`${author.name} (${author.slug}, ID: ${author.id})`);
+                                }
+                            }
+                            catch (error) {
+                                // Skip showing this author if we can't fetch it
+                                console.error(`Failed to fetch author ${authorId}:`, error);
                             }
                         }
-                        catch (error) {
-                            // Skip showing author if we can't fetch it
-                            console.error(`Failed to fetch author ${post.author_id}:`, error);
+                        if (authorInfo.length > 0) {
+                            const label = authorInfo.length > 1 ? 'Authors' : 'Author';
+                            content += `   ${label}: ${authorInfo.join(', ')}\n`;
                         }
                     }
                     content += `   Created: ${new Date(post.created_at).toLocaleDateString()}\n`;

package/build/shared/src/tools/update-newsletter-post.js

@@ -187,8 +187,11 @@ Use cases:
                 content += `**Slug:** ${post.slug}\n`;
                 content += `**Status:** ${post.status}\n`;
                 content += `**Category:** ${post.category}\n`;
-                if (post.author) {
-                    content += `**Author:** ${post.author.name}\n`;
+                // The ordered `authors` array is the source of truth for authorship.
+                const responseAuthors = post.authors ?? [];
+                if (responseAuthors.length > 0) {
+                    const label = responseAuthors.length > 1 ? 'Authors' : 'Author';
+                    content += `**${label}:** ${responseAuthors.map((a) => a.name).join(', ')}\n`;
                 }
                 content += `**Updated:** ${new Date(post.updated_at).toLocaleDateString()}\n\n`;
                 // Show what was updated

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "pulsemcp-cms-admin-mcp-server",
-  "version": "0.9.27",
+  "version": "0.10.0",
   "description": "Local implementation of PulseMCP CMS Admin MCP server",
-  "mcpName": "com.pulsemcp.servers/pulsemcp-cms-admin",
+  "mcpName": "com.pulsemcp/pulsemcp-cms-admin",
   "main": "build/index.js",
   "type": "module",
   "bin": {

package/shared/pulsemcp-admin-client/lib/create-post.js

@@ -7,7 +7,11 @@ export async function createPost(apiKey, baseUrl, params) {
     formData.append('post[title]', params.title);
     formData.append('post[body]', params.body);
     formData.append('post[slug]', params.slug);
-    formData.append('post[author_id]', params.author_id.toString());
+    // Rails permits only post[author_ids][] — send one entry per author id, in
+    // order (index 0 is the primary author).
+    params.author_ids.forEach((id) => {
+        formData.append('post[author_ids][]', id.toString());
+    });
     // Optional fields
     if (params.status)
         formData.append('post[status]', params.status);

package/shared/pulsemcp-admin-client/lib/get-posts.js

@@ -43,7 +43,7 @@ export async function getPosts(apiKey, baseUrl, params) {
                 short_description: post.short_description,
                 category: post.category,
                 status: post.status,
-                author_id: post.author_id,
+                author_ids: post.author_ids,
                 created_at: post.created_at,
                 updated_at: post.updated_at,
                 last_updated: post.last_updated,

package/shared/pulsemcp-admin-client/lib/update-post.js

@@ -10,8 +10,13 @@ export async function updatePost(apiKey, baseUrl, slug, params) {
         formData.append('post[body]', params.body);
     if (params.slug !== undefined)
         formData.append('post[slug]', params.slug);
-    if (params.author_id !== undefined)
-        formData.append('post[author_id]', params.author_id.toString());
+    // Rails permits only post[author_ids][] — send one entry per author id, in
+    // order (index 0 is the primary author).
+    if (params.author_ids !== undefined) {
+        params.author_ids.forEach((id) => {
+            formData.append('post[author_ids][]', id.toString());
+        });
+    }
     if (params.status !== undefined)
         formData.append('post[status]', params.status);
     if (params.category !== undefined)

package/shared/pulsemcp-admin-client/pulsemcp-admin-client.integration-mock.js

@@ -4,15 +4,18 @@ export function createMockPulseMCPAdminClient(mockData) {
         title: 'Test Post',
         body: '<p>Test content</p>',
         slug: 'test-post',
-        author_id: 1,
         status: 'draft',
         category: 'newsletter',
         created_at: '2024-01-01T00:00:00Z',
         updated_at: '2024-01-01T00:00:00Z',
-        author: {
-            id: 1,
-            name: 'Test Author',
-        },
+        // Ordered author ids from the list endpoint (no names).
+        author_ids: [1, 2],
+        // Ordered authors array (id + name) from the show endpoint; source of truth
+        // for reads.
+        authors: [
+            { id: 1, name: 'Test Author' },
+            { id: 2, name: 'Second Author' },
+        ],
     };
     return {
         async getPosts(params) {

package/shared/tools/draft-newsletter-post.js

@@ -166,10 +166,11 @@ Use cases:
                 const { author_slug, featured_mcp_server_slugs, featured_mcp_client_slugs, ...otherParams } = validatedArgs;
                 // Look up author by slug
                 const author = await client.getAuthorBySlug(author_slug);
-                // Always create as draft
+                // Always create as draft. author_ids is an ordered array; this tool sets
+                // a single primary author (length 1).
                 const createParams = {
                     ...otherParams,
-                    author_id: author.id,
+                    author_ids: [author.id],
                     status: 'draft',
                 };
                 // Convert slugs to IDs if provided
@@ -192,8 +193,11 @@ Use cases:
                 content += `**Slug:** ${post.slug}\n`;
                 content += `**Status:** ${post.status}\n`;
                 content += `**Category:** ${post.category}\n`;
-                if (post.author) {
-                    content += `**Author:** ${post.author.name}\n`;
+                // The ordered `authors` array is the source of truth for authorship.
+                const responseAuthors = post.authors ?? [];
+                if (responseAuthors.length > 0) {
+                    const label = responseAuthors.length > 1 ? 'Authors' : 'Author';
+                    content += `**${label}:** ${responseAuthors.map((a) => a.name).join(', ')}\n`;
                 }
                 content += `**Created:** ${new Date(post.created_at).toLocaleDateString()}\n\n`;
                 if (post.short_description) {

package/shared/tools/get-newsletter-post.js

@@ -12,7 +12,7 @@ export function getNewsletterPost(_server, clientFactory) {
         description: `Retrieve complete details for a specific newsletter post by its unique slug identifier. Returns formatted markdown with all post metadata and content.
 
 The response is formatted as markdown with sections for:
-- Post title and basic metadata (slug, status, category, author, dates)
+- Post title and basic metadata (slug, status, category, author(s), dates)
 - Summary/short description
 - Full HTML content (body field) as raw HTML
 - Complete metadata including all URLs, SEO tags, and featured items
@@ -20,7 +20,7 @@ The response is formatted as markdown with sections for:
 
 All available fields from the post are included:
 - title, slug, status, category
-- author (id and name)
+- authors (ordered list; the primary author is listed first)
 - created_at, updated_at, last_updated
 - short_title, short_description
 - body (raw HTML content)
@@ -55,28 +55,36 @@ Use cases:
             const client = clientFactory();
             try {
                 const post = await client.getPost(validatedArgs.slug);
-                // Fetch author details if we have an author_id
-                let authorSlug;
-                let authorName;
-                if (post.author_id) {
+                // The supervisor show endpoint returns the ordered `authors` array (id +
+                // name), which is the source of truth for authorship.
+                const baseAuthors = post.authors ?? [];
+                // Enrich each author with its slug (the authors array only carries id +
+                // name). Preserve position order so the primary author renders first.
+                const authorLines = [];
+                for (const a of baseAuthors) {
+                    let slug;
+                    let name = a.name;
                     try {
-                        const author = await client.getAuthorById(post.author_id);
-                        if (author) {
-                            authorSlug = author.slug;
-                            authorName = author.name;
+                        const fullAuthor = await client.getAuthorById(a.id);
+                        if (fullAuthor) {
+                            slug = fullAuthor.slug;
+                            if (!name)
+                                name = fullAuthor.name;
                         }
                     }
                     catch (error) {
-                        // If we can't fetch author, we'll just skip showing author info
+                        // If we can't fetch the author, fall back to whatever name we have.
                         console.error('Failed to fetch author details:', error);
                     }
+                    authorLines.push(slug ? `${name} (${slug}, ID: ${a.id})` : `${name} (ID: ${a.id})`);
                 }
                 // Format the response for MCP
                 let content = `# ${post.title}\n\n`;
                 content += `**Slug:** ${post.slug}\n`;
                 content += `**Status:** ${post.status} | **Category:** ${post.category}\n`;
-                if (authorSlug && authorName) {
-                    content += `**Author:** ${authorName} (${authorSlug}, ID: ${post.author_id})\n`;
+                if (authorLines.length > 0) {
+                    const label = authorLines.length > 1 ? 'Authors' : 'Author';
+                    content += `**${label}:** ${authorLines.join(', ')}\n`;
                 }
                 content += `**Created:** ${new Date(post.created_at).toLocaleDateString()}\n`;
                 content += `**Updated:** ${new Date(post.updated_at).toLocaleDateString()}\n`;

package/shared/tools/get-newsletter-posts.js

@@ -75,17 +75,25 @@ Use cases:
                 for (const [index, post] of response.posts.entries()) {
                     content += `${index + 1}. **${post.title}** (${post.slug})\n`;
                     content += `   Status: ${post.status} | Category: ${post.category}\n`;
-                    // Fetch author details if we have an author_id
-                    if (post.author_id) {
-                        try {
-                            const author = await client.getAuthorById(post.author_id);
-                            if (author) {
-                                content += `   Author: ${author.name} (${author.slug}, ID: ${author.id})\n`;
+                    // The list endpoint returns ordered author ids (no names); resolve each
+                    // to a name, preserving order so the primary author renders first.
+                    if (post.author_ids && post.author_ids.length > 0) {
+                        const authorInfo = [];
+                        for (const authorId of post.author_ids) {
+                            try {
+                                const author = await client.getAuthorById(authorId);
+                                if (author) {
+                                    authorInfo.push(`${author.name} (${author.slug}, ID: ${author.id})`);
+                                }
+                            }
+                            catch (error) {
+                                // Skip showing this author if we can't fetch it
+                                console.error(`Failed to fetch author ${authorId}:`, error);
                             }
                         }
-                        catch (error) {
-                            // Skip showing author if we can't fetch it
-                            console.error(`Failed to fetch author ${post.author_id}:`, error);
+                        if (authorInfo.length > 0) {
+                            const label = authorInfo.length > 1 ? 'Authors' : 'Author';
+                            content += `   ${label}: ${authorInfo.join(', ')}\n`;
                         }
                     }
                     content += `   Created: ${new Date(post.created_at).toLocaleDateString()}\n`;

package/shared/tools/update-newsletter-post.js

@@ -187,8 +187,11 @@ Use cases:
                 content += `**Slug:** ${post.slug}\n`;
                 content += `**Status:** ${post.status}\n`;
                 content += `**Category:** ${post.category}\n`;
-                if (post.author) {
-                    content += `**Author:** ${post.author.name}\n`;
+                // The ordered `authors` array is the source of truth for authorship.
+                const responseAuthors = post.authors ?? [];
+                if (responseAuthors.length > 0) {
+                    const label = responseAuthors.length > 1 ? 'Authors' : 'Author';
+                    content += `**${label}:** ${responseAuthors.map((a) => a.name).join(', ')}\n`;
                 }
                 content += `**Updated:** ${new Date(post.updated_at).toLocaleDateString()}\n\n`;
                 // Show what was updated

package/shared/types.d.ts

@@ -3,7 +3,7 @@ export interface Post {
     title: string;
     body?: string;
     slug: string;
-    author_id: number;
+    author_ids?: number[];
     status: 'draft' | 'live' | string;
     category: 'newsletter' | 'other' | string;
     image_url?: string;
@@ -19,10 +19,10 @@ export interface Post {
     featured_mcp_client_ids?: number[];
     created_at: string;
     updated_at: string;
-    author?: {
+    authors?: Array<{
         id: number;
         name: string;
-    };
+    }>;
 }
 export interface PostsResponse {
     posts: Post[];
@@ -36,7 +36,7 @@ export interface CreatePostParams {
     title: string;
     body: string;
     slug: string;
-    author_id: number;
+    author_ids: number[];
     status?: 'draft' | 'live';
     category?: 'newsletter' | 'other';
     image_url?: string;