Day 24 — ML Engineering
1,000 reviews. One question: “Are our customers happy?”
An ML-powered MCP server that processes customer reviews, scores sentiment, extracts recurring themes, and surfaces what people actually care about. Not star ratings — real patterns, real trends, real action items.
Example Queries
Tools
| Tool | What It Does |
|---|---|
| review_search | Search reviews by business, source, rating, sentiment, date range, or keyword. Returns review text with sentiment scores. |
| sentiment_overview | Sentiment breakdown for a business — overall score, positive/neutral/negative split, average rating, and top themes driving sentiment. |
| theme_analysis | Analyze what customers talk about most — themes, categories, average sentiment per theme, trend direction, and sample reviews. |
| trend_tracker | Track sentiment over time — weekly scores, review volume, positive/negative split, and which themes are rising or falling. |
| competitive_sentiment | Compare sentiment across all tracked businesses — side-by-side scores, strengths, weaknesses, and rankings. |
| action_items | Prioritized action items based on negative themes, declining trends, and recurring complaints — with supporting review evidence. |
The Pipeline
Every review is processed through a multi-layer pipeline that goes beyond simple positive/negative classification:
Each review gets a sentiment score from -1.0 (strongly negative) to +1.0 (strongly positive), with labels: positive, neutral, negative.
Key themes are identified from review text — staff service, food quality, cleanliness, pricing, facilities — and mapped to categories.
Weekly snapshots track sentiment over time, showing trends, volume changes, and which themes are driving shifts.
Declining themes and recurring complaints are surfaced as prioritized action items with supporting evidence from real reviews.
Why This Build
Every hospitality and retail business is sitting on a goldmine of customer feedback. Google Reviews, Yelp, TripAdvisor, internal surveys — hundreds of unstructured text entries that nobody has time to read systematically.
Star ratings tell you the “what” but not the “why.” A 3-star review could mean “great food, terrible service” or “average everything.” The difference matters enormously for deciding what to fix first.
This pipeline extracts the themes that actually drive customer satisfaction. It shows you that “wait times” appear in 6 negative reviews and the trend is getting worse — while “food quality” is your strength with a 0.88 sentiment score. Ask one question, get a prioritized list of what to fix and what to protect. Second ML Engineering build of the challenge.
Demo Data
5
Businesses
66
Reviews
36
Themes
26
Snapshots
5
Sources
6
Weeks of Data
5 businesses across hospitality, food & beverage, restaurant, wellness, and resort industries. Reviews sourced from Google, Yelp, TripAdvisor, OpenTable, and internal surveys. Each business has distinct personality: strong service but aging facilities, great product but inconsistent quality, beloved instructors but broken booking app. Real patterns, realistic edge cases.
Setup
cd day24-sentiment-analysis
npm install && npm run seed && npm run buildThen add the config to Claude Desktop and restart.
If you're reading reviews one at a time instead of seeing the patterns, let's build something that listens at scale.