Marketing Automation MCP Server

Automates marketing operations with AI-powered optimization, real-time analytics, and multi-platform integration.

marketing-automation-mcpis a Python MCP server for deterministic campaign reporting, provider-backed budget optimization, copy generation, and demo-only audience segmentation.

This repo now favors reproducibility over ad hoc setup:

- Supported Python:3.12and3.13
- Local bootstrap:uv
- Primary MCP transport:stdio
- Local Python3.14.xis treated as compatibility work, not the supported baseline

The public MCP contract in this repo is intentionally narrow:

- generate_campaign_report
- optimize_campaign_budget
- create_campaign_copy
- analyze_audience_segments

Only these four tools are part of the supported server surface today. Other modules undersrc/tools/exist as internal or aspirational code paths and should not be treated as production MCP features.

- DEMO_MODE=trueReturns deterministic sample data for demos and contract testing.
- DEMO_MODE=falseUses real platform credentials and the selected AI provider. Missing live dependencies return structuredblockedresponses instead of fabricated output.

uv sync --python 3.13 --extra dev cp .env.example .env uv run python -m compileall src tests dashboard uv run pytest

python3.13 -m venv .venv source .venv/bin/activate python -m pip install --upgrade pip python -m pip install -e ".[dev]"

Start the MCP server in its supported transport mode:

The server currently documents and supportsstdiotransport only.

{ "mcpServers": { "marketing-automation": { "command": "uv", "args": ["run", "python", "-m", "src.server"], "cwd": "/absolute/path/to/Marketing-Automation-MCP-Server" } } }

- DEMO_MODE=false
- one or more platform credential sets

- DEMO_MODE=false
- AI_PROVIDER=openai
- OPENAI_API_KEY=...
- AI_OPENAI_MODEL=gpt-5.4

- ANTHROPIC_API_KEY,ANTHROPIC_MODEL
- GEMINI_API_KEY,GEMINI_MODEL

IfENCRYPTION_KEYis missing, API-key encryption is disabled for that process and the server logs a warning.

Every tool response includes these top-level fields:

{ "status": "ok | blocked", "mode": "demo | live", "blocked_reason": "optional string", "warnings": [] }

See the full contract indocs/api/README.md.

uv run python -m compileall src tests dashboard uv run pytest uv run python -c "import src.server, src.cli, src.ai_engine, src.performance; print('imports ok')" docker build -t marketing-automation-mcp:latest .

- Quick start
- API reference
- Example workflows
- Demo guide
- Operator runbook
- System audit review docs

Interact with capabilities of the CRIC Wuye AI platform, an intelligent assistant specifically for the property management industry.