@agendapanda/mcp

MCP (Model Context Protocol) server for Agenda Panda -- expose social media scheduling as tools for AI agents.

This server lets Claude, Cursor, Windsurf, and other MCP-compatible AI tools create posts, manage content calendars, and interact with your social media accounts through Agenda Panda.

Available Tools (10)

| Tool | Description | |------|-------------| | post_create | Create and publish a social media post (content, connection, optional schedule, optional media) | | post_list | List posts with optional status filter (scheduled, published, failed, all) and limit | | post_get | Get details of a specific post by ID | | post_update | Update a scheduled post's content, schedule time, or media | | post_delete | Delete a scheduled post (cannot delete published posts) | | post_retry | Retry publishing a failed post | | connections_list | List connected social media accounts (needed to get connection IDs for posting) | | projects_list | List projects/workspaces | | calendar_import | Import multiple posts from a structured calendar array (supports dry_run validation) | | context_get | Get brand context (voice, tone, connections, platform rules with media support info) |

Prerequisites

1. An Agenda Panda account at agendapanda.com
2. An API key from Settings > Security > API Keys
3. At least one connected social account
4. Node.js 20+

Setup

Install

npm install -g @agendapanda/mcp

Or run directly with npx:

npx @agendapanda/mcp

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | AP_API_KEY | Yes | Your Agenda Panda API key (starts with ap_) | | AP_PROJECT | No | Default project/workspace ID (auto-detected if you have only one) | | AP_API_URL | No | API base URL (default: https://agendapanda.com) |

Claude Code

Add to your Claude Code MCP configuration (~/.claude/claude_desktop_config.json or project-level .mcp.json):

{
  "mcpServers": {
    "agendapanda": {
      "command": "npx",
      "args": ["@agendapanda/mcp"],
      "env": {
        "AP_API_KEY": "ap_your_key_here"
      }
    }
  }
}

Or if installed globally:

{
  "mcpServers": {
    "agendapanda": {
      "command": "agendapanda-mcp",
      "env": {
        "AP_API_KEY": "ap_your_key_here"
      }
    }
  }
}

Claude Desktop

Add to your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "agendapanda": {
      "command": "npx",
      "args": ["@agendapanda/mcp"],
      "env": {
        "AP_API_KEY": "ap_your_key_here"
      }
    }
  }
}

Cursor

Add to your Cursor MCP settings (.cursor/mcp.json in your project or global settings):

{
  "mcpServers": {
    "agendapanda": {
      "command": "npx",
      "args": ["@agendapanda/mcp"],
      "env": {
        "AP_API_KEY": "ap_your_key_here"
      }
    }
  }
}

Windsurf

Add to your Windsurf MCP configuration (~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "agendapanda": {
      "command": "npx",
      "args": ["@agendapanda/mcp"],
      "env": {
        "AP_API_KEY": "ap_your_key_here"
      }
    }
  }
}

Usage Examples

Once configured, you can ask your AI assistant things like:

• "Post 'Hello world' to Twitter"
• "Schedule a LinkedIn post for next Tuesday at 9am UTC"
• "Show me all my scheduled posts"
• "Show me my failed posts"
• "Update that post to say 'Updated content' instead"
• "Delete my scheduled Instagram post"
• "Retry the failed Bluesky post"
• "What social accounts do I have connected?"
• "Get my brand context and write 5 posts for this week"
• "Import this content calendar: [...]"
• "Dry-run import this calendar to check for errors before creating posts"

The AI will use the appropriate MCP tools to interact with Agenda Panda on your behalf.

Workflow: Generate and Schedule Content

1. Get context: The AI calls context_get to understand your brand voice, connected accounts, and platform rules
2. List connections: The AI calls connections_list to know which accounts are available
3. Generate content: Using your brand context, the AI creates tailored posts
4. Schedule posts: The AI calls post_create or calendar_import to schedule them

Development

git clone https://github.com/sushaantu/cloudflare-social-scheduler
cd cloudflare-social-scheduler/mcp
npm install
npm run build

Test locally:

AP_API_KEY=ap_your_key_here node dist/index.js

License

MIT