Metadata-Version: 2.4
Name: bluealpha-mmm-builder-mcp
Version: 0.1.0
Summary: MCP server that guides users through building a Marketing Mix Model with Google Meridian
Author: BlueAlpha
License: MIT
Requires-Python: >=3.11
Requires-Dist: fastmcp>=2.9.0
Requires-Dist: numpy>=1.24
Requires-Dist: pandas>=2.0
Requires-Dist: xarray>=2023.0
Provides-Extra: meridian
Requires-Dist: google-meridian>=1.4.0; extra == 'meridian'
Description-Content-Type: text/markdown

# MMM Builder MCP Server

A Model Context Protocol (MCP) server that guides users through building a Marketing Mix Model with Google Meridian.

## Installation

```bash
uvx bluealpha-mmm-builder-mcp
```

## Claude Desktop

```json
{
  "mcpServers": {
    "mmm-builder": {
      "command": "uvx",
      "args": ["bluealpha-mmm-builder-mcp"]
    }
  }
}
```

## Tools (19)

### Phase 1: Readiness Assessment (3)
- `assess_mmm_readiness` — Score your data readiness (0-100)
- `explain_mmm_requirements` — Learn what you need for MMM
- `estimate_model_complexity` — Check if your model can run locally

### Phase 2: Data Preparation (5)
- `validate_data_schema` — Check your CSV structure
- `diagnose_data_quality` — Find data quality issues
- `suggest_data_transformations` — Get transformation recommendations
- `preview_mmm_input_data` — Dry run before building
- `build_input_data` — Build the Meridian dataset

### Phase 3: Channel Beliefs → Priors (7)
- `set_channel_roi_belief` — "I think search returns $3 per dollar"
- `set_channel_cpa_belief` — "Search costs $25 per conversion"
- `rank_channels_by_effectiveness` — "Search > Social > Display"
- `set_adstock_belief` — "TV effects last for weeks"
- `set_saturation_belief` — "We're oversaturated on display"
- `get_prior_summary` — See all configured beliefs
- `reset_channel_priors` — Reset to defaults

### Phase 4: Model Building (4)
- `configure_model` — Set model parameters
- `fit_mmm_model` — Run the model locally
- `export_for_cloud` — Export for BlueAlpha cloud execution
- `get_model_diagnostics` — Check model convergence
