synthetic-ci/vibe-marketing-mcp

🎯 Vibe Marketing MCP

A Model Context Protocol (MCP) server designed for AI-powered marketing and social media content creation. This Cloudflare Worker-based service provides tools, templates, and frameworks to help create engaging content across multiple social media platforms.

✨ Features

🔍 Social Media Hook Discovery

• Find hooks by network: Get platform-specific hooks for Twitter, Instagram, LinkedIn, TikTok, YouTube, and Facebook
• Category-based search: Find hooks by engagement type (educational, promotional, storytelling, etc.)
• Smart filtering: Limit results and find the most relevant hooks for your content

📝 Copywriting Frameworks

• Platform-specific frameworks: Tailored copywriting templates for each social media platform
• Multiple frameworks per platform: Choose from various proven copywriting structures
• Brand archetype integration: Align your content with specific brand personalities

🎭 Brand Archetypes

• 12+ brand archetypes: From "The Hero" to "The Sage" - find the perfect brand voice
• Detailed descriptions: Comprehensive archetype profiles with characteristics and messaging guidelines
• Content alignment: Ensure your copy matches your brand personality

🚫 Content Validation

• Problematic phrase detection: Automatically flag potentially problematic language
• Above-the-fold optimization: Validate and optimize your opening content
• Content length management: Get properly truncated text that maintains impact

📈 Trending Content Discovery

• Real-time trends: Access trending topics and content ideas
• Platform-specific trends: Get trends tailored to specific social media networks
• Content inspiration: Generate ideas based on what's currently popular

🚀 Quick Start

Prerequisites

• Node.js 18+
• pnpm package manager
• Cloudflare account (for deployment)

Installation

1. Clone the repository

   git clone https://github.com/<your-username>/vibe-marketing-mcp.git
   cd vibe-marketing-mcp
   

2. Install dependencies

   pnpm install
   

3. Development

   # Start development server
   pnpm dev
   
   # Run tests
   pnpm test
   
   # Type checking
   pnpm type-check
   

4. Deploy to Cloudflare Workers

   pnpm deploy
   

🚀 Automated Deployment

This project includes GitHub Actions for automatic deployment to Cloudflare Workers when PRs are merged to the main branch.

Setup GitHub Secrets

To enable automatic deployment, add the following secrets to your GitHub repository:

1. Go to your repository settings → Secrets and variables → Actions
2. Add the following repository secrets:

Deployment Workflow

The GitHub Action will automatically:

• ✅ Run tests
• 🔧 Install dependencies
• 🚀 Deploy to Cloudflare Workers

Manual deployment is also available via the "Actions" tab in your GitHub repository.

🛠️ Available Tools

Hook Discovery

• find-hooks - Search for social media hooks by network and category
• get-network-categories-for-hooks - Get available hook categories for specific networks

Copywriting

• list-copywriting-frameworks-for-network - List available frameworks for a platform
• get-copywriting-framework - Get detailed copywriting framework template

Brand Management

• list-archetypes - List all available brand archetypes
• get-archetype - Get detailed information about a specific archetype

Content Validation

• flag-problematic-phrases - Detect potentially problematic language in content
• validate-content-before-fold - Validate above-the-fold content effectiveness
• get-text-before-fold - Get optimally truncated content for previews

Trending Content

• get-trending-content - Access current trending topics and content ideas

📚 Resources

The MCP server provides access to curated resources:

• Social Media Hooks: Database of proven hooks categorized by platform and engagement type
• Phrases to Avoid: List of potentially problematic phrases to avoid in marketing content

🎯 Supported Platforms

• Twitter/X - Optimized for short-form, viral content
• Instagram - Visual-first content with engaging captions
• LinkedIn - Professional, business-focused content
• TikTok - Trend-driven, entertainment-focused content
• YouTube - Long-form, educational content optimization
• Facebook - Community-building and engagement-focused content

📖 Usage Examples

Finding Social Media Hooks

// Find engagement hooks for Instagram
const hooks = await mcp.callTool('find-hooks', {
  network: 'instagram',
  category: 'engagement',
  limit: 5
});

Getting Copywriting Framework

// Get a copywriting framework for LinkedIn
const framework = await mcp.callTool('get-copywriting-framework', {
  network: 'linkedin',
  framework: 'problem-agitation-solution'
});

Brand Archetype Selection

// List all available archetypes
const archetypes = await mcp.callTool('list-archetypes');

// Get specific archetype details
const heroArchetype = await mcp.callTool('get-archetype', {
  archetype: 'hero'
});

Content Validation

// Check for problematic phrases
const validation = await mcp.callTool('flag-problematic-phrases', {
  content: "Your marketing copy here..."
});

🧪 Testing

Run the comprehensive test suite:

# Run all tests
pnpm test

# Run tests with UI
pnpm test:ui

# Run tests once
pnpm test:run

🛡️ Code Quality

This project uses Biome for linting and formatting:

# Format code
pnpm format

# Lint code
pnpm lint

# Fix linting issues
pnpm lint:fix

📁 Project Structure

src/
├── content/          # Content templates and data
│   ├── copywriting/  # Platform-specific copywriting frameworks
│   ├── hooks/        # Social media hooks database
│   ├── humanizing/   # Content humanization rules
│   └── voicing/      # Brand archetype definitions
├── formatters/       # Data formatting utilities
├── prompts/          # AI prompt templates
├── resources/        # MCP resources (hooks, phrases to avoid)
├── services/         # Business logic services
├── tools/            # MCP tool implementations
└── types/            # TypeScript type definitions

🤝 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Make your changes
4. Run tests (pnpm test)
5. Commit your changes (git commit -m 'Add amazing feature')
6. Push to the branch (git push origin feature/amazing-feature)
7. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the file for details.

🔗 Related Projects

• Model Context Protocol - The protocol this server implements
• Cloudflare Workers - The serverless platform powering this service

📧 Support

If you have questions or need help:

1. Check the Issues page
2. Create a new issue if your question isn't answered
3. For urgent matters, reach out to the maintainers

Built with ❤️ for creators, by HyperFeed.ai

Contributors ✨

Thanks goes to these wonderful people (emoji key):

This project follows the all-contributors specification. Contributions of any kind welcome!