@modelcontextprotocol/server-customer-segmentation

Initializes a Model Context Protocol server that exposes customer segmentation operations through the MCP transport layer, binding to a customer data source (JSON, CSV, or database) and registering tools for LLM clients to invoke. Uses MCP's resource and tool registration patterns to advertise segmentation capabilities to connected Claude instances or other MCP-compatible clients.

Executes segmentation logic by applying user-defined or pre-built rules (e.g., RFM scoring, demographic filters, behavioral thresholds) to customer records, returning filtered cohorts. Rules are evaluated using a predicate-matching engine that supports AND/OR logic, numeric comparisons, string matching, and date ranges, enabling LLM clients to dynamically construct segmentation queries without code changes.

Allows creation, storage, and retrieval of named customer segments with rule definitions, enabling LLM clients to save segmentation logic for reuse across multiple requests. Segments are persisted in a local JSON file or optional external store, with metadata tracking creation date, rule version, and segment size. Supports CRUD operations (create, read, update, delete) on segment definitions via MCP tools.

Enables combining multiple saved segments using boolean operators (union, intersection, difference) to create composite audiences. Implements set-based operations on segment membership, allowing LLM clients to express complex audience logic (e.g., 'high-value AND recent AND not-churned') by composing pre-defined segments. Operations are evaluated lazily to minimize redundant filtering.

Computes aggregate statistics and metrics for a segment or set of segments, including count, average/median/percentile values, distribution histograms, and trend analysis. Metrics are calculated in-memory using streaming aggregation to minimize memory overhead, and results are returned as structured JSON suitable for visualization or reporting. Supports grouping by attributes (e.g., metrics by region or cohort).

Exports segment membership (customer lists) in multiple formats (JSON, CSV, Parquet, or custom delimited formats) suitable for downstream systems like email platforms, data warehouses, or analytics tools. Supports field selection, sorting, and pagination to handle large segments without memory exhaustion. Exports can be streamed to files or returned as base64-encoded data for embedding in MCP responses.

Validates segment definitions for correctness and quality, checking for issues like empty segments, invalid rule syntax, circular dependencies, or data quality problems (missing values, outliers). Runs automated checks and returns a quality report with warnings and recommendations. Supports custom validation rules defined by the user.