mcpengine/servers/product-analytics/.scaffold-summary.md
Jake Shore ced6b4933b pipedrive: Add 20 React MCP Apps
- deal-dashboard: Overview stats, won/lost ratio, revenue forecast
- deal-detail: Full deal with products, activities, participants, timeline
- deal-grid: Sortable deal list with filters
- pipeline-kanban: Drag-drop pipeline board
- pipeline-analytics: Conversion rates, velocity, bottleneck analysis
- pipeline-funnel: Visual funnel with stage metrics
- person-detail: Contact card with deals, activities, files
- person-grid: Contact directory with search
- org-detail: Organization with people, deals, activities
- org-grid: Organization directory
- activity-dashboard: Activity calendar/list with completion tracking
- activity-calendar: Monthly calendar view
- lead-inbox: Lead list with labels and quick actions
- product-catalog: Product list with pricing
- goal-tracker: Goals with progress bars
- revenue-dashboard: Revenue analytics, forecasting
- email-inbox: Mail threads with preview
- deals-timeline: Timeline of deal progression
- search-results: Universal search
- won-deals: Closed-won deals celebration view

All apps use React with dark theme. Self-contained with inline shared components.
Each app has App.tsx, index.html, and vite.config.ts.
Ports 3000-3019 for dev servers.
2026-02-12 17:09:57 -05:00

2.7 KiB

Product Analytics MCP Server - Scaffold Complete

Files Created

product-analytics/
├── package.json          ✓ (name: mcp-server-product-analytics)
├── tsconfig.json         ✓ (strict TypeScript, matches brevo)
├── src/
│   └── index.ts          ✓ (25KB, 3 API clients, 19 tools)
└── README.md             ✓ (13KB, comprehensive docs)

📊 Tool Summary

Total: 19 tools (target was 18-22 ✓)

Mixpanel - 7 tools

  1. query_mixpanel_segmentation
  2. query_mixpanel_funnels
  3. query_mixpanel_retention
  4. get_mixpanel_user_profile
  5. query_mixpanel_jql
  6. export_mixpanel_events
  7. list_mixpanel_events

Amplitude - 6 tools

  1. query_amplitude_segmentation
  2. get_amplitude_user_activity
  3. list_amplitude_cohorts
  4. get_amplitude_cohort
  5. query_amplitude_charts
  6. get_amplitude_taxonomy

PostHog - 6 tools

  1. query_posthog_events
  2. get_posthog_person
  3. list_posthog_feature_flags
  4. query_posthog_insights
  5. query_posthog_hogql
  6. list_posthog_annotations

🔧 API Client Implementation

MixpanelClient

  • Base URLs: Query (https://mixpanel.com/api/2.0) + Ingestion (https://api.mixpanel.com)
  • Auth: Basic auth (project_id:secret)
  • Env vars: MIXPANEL_PROJECT_ID, MIXPANEL_SERVICE_ACCOUNT_SECRET
  • Endpoints: segmentation, funnels, retention, engage, jql, export, events/names

AmplitudeClient

  • Base URL: https://amplitude.com/api/2
  • Auth: Basic auth (api_key:secret_key)
  • Env vars: AMPLITUDE_API_KEY, AMPLITUDE_SECRET_KEY
  • Endpoints: events/segmentation, useractivity, cohorts, chart, taxonomy/event

PostHogClient

  • Base URL: https://app.posthog.com/api (cloud)
  • Auth: Bearer token (Personal API Key)
  • Env vars: POSTHOG_API_KEY, POSTHOG_PROJECT_ID
  • Endpoints: events, persons, feature_flags, insights, query (HogQL), annotations

Key Features

  1. Multi-platform support - All 3 platforms in one MCP
  2. Smart platform detection - Auto-enables tools based on configured env vars
  3. Unified tool interface - Consistent pattern across all platforms
  4. Error handling - Proper error messages for each API
  5. TypeScript strict mode - Compiles with zero errors
  6. Follows brevo pattern - Server/StdioServerTransport, same structure

🧪 TypeScript Validation

npx tsc --noEmit
# ✓ Compiles successfully with strict mode enabled

📝 Next Steps (NOT done by this scaffold)

  • npm install (explicitly excluded per instructions)
  • Add .env.example file
  • Add tests
  • Add CI/CD config
  • Publish to npm
  • Deploy examples (Docker, Railway)

🎯 Ready For

The scaffold is compile-ready and follows the exact pattern from brevo. Can be committed to mcpengine-repo immediately.