Marketing Brain

Self-Learning Marketing Intelligence System for Claude Code

Marketing Brain is an MCP server that gives Claude Code a persistent marketing memory. It tracks every post you publish, learns what works across 6 platforms, and builds a Hebbian synapse network connecting posts, campaigns, strategies, templates, and insights. Over time, it learns your best-performing patterns, generates content drafts, schedules posts, analyzes competitors, and runs 9 autonomous research engines to discover engagement patterns.

Quick Start

npm install -g @timmeck/marketing-brain
marketing setup

Features

Content Intelligence

• Post Tracking — Store posts with platform, format, hashtags, URL, and full engagement history
• Campaign Management — Group posts into campaigns, track aggregate performance
• Draft Checking — Check posts against learned rules before publishing
• Template Library — High-performing post structures become reusable templates
• Timing Patterns — Discovers best/worst posting hours from engagement data
• Gap Analysis — "You never post on LinkedIn — potential?"
• Full-Text Search — FTS5 indexes on posts, strategies, and templates

Content Generation Pipeline

• Draft from Patterns — Generate drafts based on learned rules, patterns, and templates
• Hashtag Suggestions — Data-driven hashtag recommendations
• Competitor Analysis — Track and benchmark competitor engagement
• A/B Testing — Statistical significance tracking for content variants

Scheduling & Cross-Platform

• Scheduling Engine — Post queue with optimal auto-timing based on learned patterns
• Due Check + Webhooks — Automated publish triggers
• 6 Platforms — X, LinkedIn, Reddit, Bluesky, Mastodon, Threads
• Thread Splitting — Long content auto-split for thread-based platforms
• Format Adaptation — Optimize content for each platform's format

Autonomous Research (9 Engines)

Same engine architecture as Brain, fed with post/engagement history via DataMiner:

• SelfObserver, AnomalyDetective, CrossDomain, AdaptiveStrategy, ExperimentEngine, KnowledgeDistiller, ResearchAgenda, CounterfactualEngine, Journal
• Feedback loops running every 5 minutes
• DataMiner bootstraps all historical posts and engagement data at startup

Dream Mode & Consciousness

• Dream Engine — Offline consolidation: memory replay, synapse pruning, compression, importance decay
• Consciousness Dashboard — Live neural graph at http://localhost:7786 with thought stream and engine status
• Prediction Engine — Holt-Winters forecasting for engagement rates and post performance
• AutoResponder — Automatically adjusts marketing parameters when anomalies detected
• Self-Improvement Loop — Generates improvement suggestions

Memory & Sessions

• Persistent Memory — Preferences, decisions, context, facts, goals, lessons
• Session Tracking — Conversation goals, summaries, outcomes
• Synapse-Wired — Memories and sessions connect to the Hebbian network

Dashboards

| Dashboard | Port | What It Shows | |-----------|------|--------------| | Marketing Dashboard | 7783 | Interactive synapse graph, platform charts, top posts, insights | | Consciousness | 7786 | Neural graph, thought stream, engine status |

Universal Access

• MCP Server — Stdio transport for Claude Code
• MCP HTTP/SSE — For Cursor, Windsurf, Cline, Continue (port 7782)
• REST API — Full HTTP API on port 7781

MCP Tools (64 tools)

Content: marketing_post_draft, marketing_post_report, marketing_post_engagement, marketing_post_similar, marketing_extract_patterns, marketing_content_calendar

Campaigns: marketing_campaign_create, marketing_campaign_stats

Strategies & Templates: marketing_strategy_report, marketing_strategy_suggest, marketing_template_find, marketing_rule_check

Competitor: marketing_competitor_track, marketing_competitor_analyze, marketing_competitor_compare

Scheduling: marketing_schedule_post, marketing_schedule_list, marketing_schedule_check

Cross-Platform: marketing_optimize_cross_platform, marketing_adapt_format, marketing_split_thread

A/B Testing: marketing_track_ab_test, marketing_ab_test_result

Analytics: marketing_analytics_summary, marketing_analytics_best, marketing_insight_list

Research Engines (5 tools each): self_observer, anomaly_detective, cross_domain, adaptive_strategy, experiment, knowledge_distiller, research_agenda, counterfactual, journal

Dream: marketing_dream_status, marketing_dream_consolidate, marketing_dream_history

Consciousness: marketing_consciousness_status, marketing_consciousness_thoughts

Prediction: marketing_predict, marketing_prediction_accuracy, marketing_predictions_list

AutoResponder: marketing_responder_status, marketing_responder_history, marketing_responder_rules

Memory: marketing_remember, marketing_recall, marketing_session_start, marketing_session_end, marketing_session_history

Ecosystem: marketing_status, marketing_ecosystem_status, marketing_query_peer, marketing_cross_promote, marketing_trading_performance

CLI Commands

marketing setup                  One-command setup: MCP + daemon
marketing start / stop           Daemon management
marketing status                 Stats: posts, campaigns, synapses, insights
marketing doctor                 Health check
marketing post <platform> [url]  Report a published post
marketing campaign create <name> Create a campaign
marketing campaign list          List campaigns
marketing campaign stats <id>    Campaign performance
marketing insights               Research insights
marketing rules                  Learned marketing rules
marketing suggest <topic>        Content suggestions
marketing learn                  Trigger learning cycle
marketing query <search>         Search everything
marketing dashboard              Interactive HTML dashboard
marketing network                Synapse network
marketing export                 Export all data
marketing import <file>          Bulk import posts
marketing peers                  Peer brain status
marketing config                 Configuration management

Configuration

| Env Variable | Default | Description | |---|---|---| | MARKETING_BRAIN_DATA_DIR | ~/.marketing-brain | Data directory | | MARKETING_BRAIN_LOG_LEVEL | info | Log level | | MARKETING_BRAIN_API_PORT | 7781 | REST API port | | MARKETING_BRAIN_API_KEY | — | API authentication key | | MARKETING_BRAIN_MCP_HTTP_PORT | 7782 | MCP HTTP/SSE port |

How It Learns

1. Post Reported — You publish a post and report it via CLI or MCP tool
2. Engagement Tracked — Likes, shares, impressions updated over time
3. Synapses Form — Post ↔ Campaign, Post ↔ Post (similar), Strategy ↔ Post connections
4. Patterns Extracted — Timing, format, platform patterns discovered by learning engine
5. Rules Generated — High-confidence patterns become rules with Wilson Score confidence
6. Competitors Benchmarked — Competitor data feeds into research engines
7. Research Runs — Trends, gaps, synergies surfaced as actionable insights
8. Content Scheduled — Optimal posting times learned from engagement data
9. Predictions Form — Holt-Winters forecasts engagement rates
10. Auto-Response — Anomalies trigger parameter adjustments

Brain Ecosystem

| Brain | Version | Purpose | Ports | |-------|---------|---------|-------| | Brain | v3.19.0 | Error memory, code intelligence, autonomous research & code generation | 7777 / 7778 / 7784 / 7787 | | Trading Brain | v2.13.0 | Adaptive trading intelligence with signal learning & backtesting | 7779 / 7780 / 7785 | | Marketing Brain | v1.14.0 | Content strategy, engagement & cross-platform optimization | 7781 / 7782 / 7783 / 7786 | | Brain Core | v2.18.0 | Shared infrastructure | — |

Support

License

MIT