Payload Content Planner Plugin

A Payload CMS plugin that adds content planning collections and integrates with your MCP system.

What It Does

Adds three collections to your Payload CMS:

• Content Tasks - Work items for agents to execute
• Keywords - SEO keyword database
• Instructions - Writing guidelines and rules

Exports MCP tools so agents can query and manage these collections via your MCP interface.

Install

npm install @dudefactory/payload-plugin-content-planner

Setup

In your Payload config:

import { buildConfig } from 'payload/config';
import {
  contentPlannerPlugin,
  createContentTasksCollection,
  createInstructionsCollection,
  contentPlannerTools,
  contentPlannerPrompts,
} from '@dudefactory/payload-plugin-content-planner';

// Define which MCP tools are available in your system
const availableMcpTools = [
  'createPosts',
  'createPublicEvents',
  'createFactories',
];

export default buildConfig({
  plugins: [
    contentPlannerPlugin({
      enabled: true,
      // Pass collection factory functions with your available tools
      collections: {
        contentTasks: createContentTasksCollection(['posts', 'public-events']),
        instructions: createInstructionsCollection(availableMcpTools),
      },
    }),

    // Add tools/prompts to your MCP plugin
    mcpPlugin({
      tools: [...existingTools, ...contentPlannerTools],
      prompts: [...existingPrompts, ...contentPlannerPrompts],
    }),
  ],
});

Collections

Content Tasks

• title - Task name
• instructions - What to do
• status - todo | in-progress | done | blocked
• priority - low | normal | high
• deadline - Due date
• tags - Categories
• notes - Notes/results

Keywords

• keyword - The keyword phrase
• category - Content category
• searchVolume - Monthly searches
• difficulty - SEO difficulty
• intent - Search intent type
• relatedKeywords - Related phrases

Instructions

• title - Guideline name
• type - Tone, Style, Terminology, Format, MCP Prompt, etc.
• category - Optional grouping (e.g., "SEO", "Tone")
• toolScope - Optional. Scope to a specific MCP tool (e.g., "createPosts"). Leave blank to apply to all tools.
• content - The actual guideline text
• examples - Optional examples for complex guidelines
• active - Whether agents use this instruction

MCP Tools

Available via your /api/mcp endpoint:

• contentplanner/get-oldest-task - Get next todo task
• contentplanner/fetch-keywords - Fetch keywords by category
• contentplanner/fetch-instructions - Fetch guidelines
• contentplanner/update-task - Update task status/notes

Docs

• Agent Instructions - How agents use the plugin

License

MIT