@wwhat/mcp-stdio-client 1.0.0 → 1.0.3

package/dist/index.js

@@ -38,6 +38,7 @@ async function mcpRequest(method, params) {
         method: 'POST',
         headers: {
             'Content-Type': 'application/json',
+            'Accept': 'application/json, text/event-stream',
             'X-API-Key': API_KEY,
         },
         body: JSON.stringify({
@@ -64,15 +65,77 @@ async function main() {
         name: 'wwhat-analytics',
         version: '1.0.0',
     });
-    // Tool 1: get_weekly_insights
-    server.tool('get_weekly_insights', 'Get weekly analytics insights including traffic changes, landing page drops, and actionable recommendations for a specific week.', {
-        source_id: z.string().describe('The analytics source/property ID'),
-        week_start_date: z.string().describe('Start date of the week (ISO format, e.g., 2025-01-13)'),
-        include_lp_explainers: z.boolean().default(true).describe('Include landing page drop explainers'),
+    // ============================================================================
+    // Tool 1: list_sources
+    // ============================================================================
+    server.tool('list_sources', `List all analytics sources (GA4 properties) connected to your account.
+
+PURPOSE:
+Returns the source_id values needed for all other analytics tools. Call this first to discover available data sources.
+
+OUTPUT INCLUDES:
+- source_id: Unique identifier to use with other tools
+- name: Human-readable property name
+- property_id: GA4 property ID
+- status: Connection status (active, pending, error)
+- last_processed: When data was last synced (if include_details=true)
+- data_range: Available date range (if include_details=true)
+
+TYPICAL WORKFLOW:
+1. Call list_sources to get available source_ids
+2. Use a source_id with get_weekly_insights or query_analytics_data`, {
+        include_details: z
+            .boolean()
+            .default(false)
+            .describe('Include last_processed date, data_range, and sync status for each source'),
+    }, async (params) => {
+        const result = await mcpRequest('tools/call', {
+            name: 'list_sources',
+            arguments: params,
+        });
+        return {
+            content: result.content.map((c) => ({ type: 'text', text: c.text })),
+        };
+    });
+    // ============================================================================
+    // Tool 2: get_weekly_insights
+    // ============================================================================
+    server.tool('get_weekly_insights', `Get AI-generated weekly analytics insights for a specific week.
+
+PURPOSE:
+Returns pre-analyzed insight cards highlighting the most important traffic changes, anomalies, and opportunities for a given week. This is higher-level than raw data queries.
+
+WHAT YOU GET:
+- Insight cards with titles, descriptions, and severity ratings
+- Traffic change summaries (site-wide and per-segment)
+- Landing page drop explainers (root cause analysis)
+- Actionable recommendations
+
+INSIGHT TYPES:
+- traffic_drop: Significant decrease in sessions/users
+- traffic_spike: Unusual increase in traffic
+- conversion_change: Conversion rate shifts
+- channel_shift: Traffic source changes
+- device_shift: Mobile/desktop mix changes
+- geo_shift: Geographic traffic changes
+
+SEVERITY LEVELS:
+- critical: >30% change, requires immediate attention
+- significant: 20-30% change, should investigate
+- moderate: 10-20% change, worth noting
+- minor: <10% change, informational
+
+TYPICAL WORKFLOW:
+1. Call get_weekly_insights for overview
+2. Use query_analytics_data to drill into specific insights
+3. Use analyze_url for page-specific deep dives`, {
+        source_id: z.string().describe('The analytics source/property ID (get from list_sources)'),
+        week_start_date: z.string().describe('Monday of the week to analyze (ISO format: YYYY-MM-DD, e.g., "2025-01-13")'),
+        include_lp_explainers: z.boolean().default(true).describe('Include AI-generated root cause analysis for landing page drops'),
         significance_filter: z
             .enum(['all', 'critical', 'significant', 'moderate', 'minor'])
             .default('all')
-            .describe('Filter insights by significance level'),
+            .describe('Filter to only show insights at or above this severity level'),
     }, async (params) => {
         const result = await mcpRequest('tools/call', {
             name: 'get_weekly_insights',
@@ -82,66 +145,287 @@ async function main() {
             content: result.content.map((c) => ({ type: 'text', text: c.text })),
         };
     });
-    // Tool 2: query_analytics_metrics
-    server.tool('query_analytics_metrics', 'Query processed analytics metrics with trend comparisons (W1, L4WAVG, LY4WAVG). Supports filtering, sorting, and aggregation.', {
-        source_id: z.string().describe('The analytics source/property ID'),
-        period_start: z.string().describe('Period start date (ISO format)'),
-        period_end: z.string().optional().describe('Period end date (defaults to 7 days after start)'),
-        metric: z
-            .enum(['sessions', 'totalUsers', 'newUsers', 'bounceRate', 'conversions', 'revenue'])
-            .default('sessions')
-            .describe('Primary metric to analyze'),
-        comparison_type: z
-            .enum(['W1', 'L4WAVG', 'LY4WAVG', 'all'])
-            .default('all')
-            .describe('Type of comparison to include'),
-        filter: z
-            .object({
-            dimension_values: z.record(z.string()).optional().describe('Filter by dimension values'),
-            min_value: z.number().optional().describe('Minimum metric value to include'),
-            min_change_percent: z.number().optional().describe('Minimum absolute change percentage'),
-            only_drops: z.boolean().optional().describe('Only include negative changes'),
-            only_gains: z.boolean().optional().describe('Only include positive changes'),
-        })
-            .optional()
-            .describe('Filtering options'),
-        sort_by: z
-            .enum(['value', 'change_w1', 'change_l4wavg', 'change_ly4wavg', 'z_score'])
-            .default('value')
-            .describe('Sort results by this field'),
-        sort_order: z.enum(['asc', 'desc']).default('desc'),
-        limit: z.number().min(1).max(100).default(20).describe('Maximum number of results'),
+    // ============================================================================
+    // Tool 3: query_analytics_data (Universal Query Interface)
+    // ============================================================================
+    server.tool('query_analytics_data', `Universal query interface for analytics data. Query any combination of dimensions and metrics with flexible filtering, sorting, and comparisons.
+
+AVAILABLE DIMENSIONS (use in filters, group_by, breakdown_by):
+┌─────────────────────────────────┬────────────────────────────────────────────────────┐
+│ Dimension                       │ Description & Example Values                        │
+├─────────────────────────────────┼────────────────────────────────────────────────────┤
+│ landingPage                     │ URL path: "/", "/blog/guide", "/pricing"           │
+│ deviceCategory                  │ "desktop", "mobile", "tablet"                       │
+│ sessionDefaultChannelGrouping   │ "Organic Search", "Direct", "Paid Search",         │
+│                                 │ "Social", "Email", "Referral", "Display"           │
+│ country                         │ "United States", "United Kingdom", "Germany"        │
+│ region                          │ State/province: "California", "Ontario"             │
+│ city                            │ "New York", "London", "San Francisco"               │
+│ newVsReturning                  │ "new" or "returning"                                │
+│ browser                         │ "Chrome", "Safari", "Firefox", "Edge"               │
+│ sessionSource                   │ "google", "facebook", "newsletter", "(direct)"      │
+│ sessionMedium                   │ "organic", "cpc", "referral", "email", "(none)"     │
+└─────────────────────────────────┴────────────────────────────────────────────────────┘
+
+AVAILABLE METRICS (use in metric parameter):
+┌──────────────┬────────────────────────────────────────────────────────────────┐
+│ Metric       │ Description                                                    │
+├──────────────┼────────────────────────────────────────────────────────────────┤
+│ sessions     │ Number of sessions (default) - most common for traffic analysis│
+│ visitors     │ Unique visitors (totalUsers)                                   │
+│ conversions  │ Total conversions - mapped per source config                   │
+│ leads        │ Lead-type conversions (form fills, signups)                    │
+│ purchases    │ Purchase/transaction conversions                               │
+│ revenue      │ Revenue in dollars                                             │
+│ bounceRate   │ Bounce rate percentage (0-100)                                 │
+└──────────────┴────────────────────────────────────────────────────────────────┘
+
+COMPARISON TYPES (returned in each row's comparisons object):
+- W1: Week-over-week change (vs previous week) - best for recent trends
+- L4WAVG: Change vs last 4-week average - smooths out weekly variance
+- LY4WAVG: Change vs same period last year - accounts for seasonality
+
+Each comparison includes:
+- previous: Previous period value
+- current: Current period value  
+- change: Absolute change
+- changePercent: Percentage change
+
+OUTPUT STRUCTURE:
+{
+  "status": "data_found",
+  "summary": {
+    "totalRows": 25,
+    "primaryMetric": "sessions",
+    "totalValue": 15420,
+    "dropsCount": 8,      // Rows with >10% drop
+    "gainsCount": 5,      // Rows with >10% gain
+    "topByChange": [...], // Top 3 gainers
+    "bottomByChange": [...] // Top 3 losers
+  },
+  "rows": [{
+    "dimensions": { "landingPage": "/blog/guide" },
+    "metrics": { "sessions": 1250, "conversions": 45 },
+    "comparisons": {
+      "w1": { "sessions": { "previous": 1400, "changePercent": -10.7 } }
+    },
+    "shareOfTotal": 8.1
+  }],
+  "insights": [{ "type": "drop", "severity": "significant", "message": "..." }]
+}
+
+COMMON USE CASES:
+
+1. Find all traffic drops this week:
+   { only_drops: true, sort_by: "change_w1", sort_order: "asc" }
+
+2. Analyze blog performance:
+   { filters: [{ dimension: "landingPage", operator: "startsWith", value: "/blog/" }], group_by: ["landingPage"] }
+
+3. Channel performance breakdown:
+   { group_by: ["sessionDefaultChannelGrouping"], metric: "conversions" }
+
+4. Mobile vs Desktop comparison:
+   { group_by: ["deviceCategory"] }
+
+5. Top converting pages:
+   { group_by: ["landingPage"], metric: "conversions", sort_by: "value", min_value: 5 }
+
+6. Pages losing traffic from Google:
+   { filters: [{ dimension: "sessionSource", operator: "equals", value: "google" }], only_drops: true, group_by: ["landingPage"] }`, {
+        source_id: z.string().describe('The analytics source/property ID (get from list_sources)'),
+        week_start_date: z.string().describe('Monday of the week to analyze (ISO format: YYYY-MM-DD, e.g., "2025-01-13")'),
+        filters: z.array(z.object({
+            dimension: z.string().describe('Dimension name (see AVAILABLE DIMENSIONS above)'),
+            operator: z.enum(['equals', 'contains', 'startsWith', 'endsWith', 'in']).describe('equals: exact match | contains: substring | startsWith/endsWith: prefix/suffix | in: match any value in array'),
+            value: z.union([z.string(), z.array(z.string())]).describe('Value to match. For "in" operator, provide array like ["value1", "value2"]'),
+        })).optional().describe('Filter rows by dimension values. Multiple filters are AND-ed together'),
+        group_by: z.array(z.string()).optional().describe('Aggregate and group results by these dimensions. Example: ["landingPage"] returns one row per unique page with summed metrics'),
+        breakdown_by: z.array(z.string()).optional().describe('For each result row, include a nested breakdown. Example: breakdown_by=["deviceCategory"] adds desktop/mobile/tablet split to each row'),
+        metric: z.string().optional().default('sessions').describe('Primary metric for sorting/filtering: sessions, visitors, conversions, leads, purchases, revenue, bounceRate'),
+        min_value: z.number().optional().describe('Exclude rows where primary metric < this value. Example: min_value=100 for pages with 100+ sessions'),
+        min_change_percent: z.number().optional().describe('Only rows with |W/W change| >= this %. Example: 20 returns rows with ≥20% increase OR ≥20% decrease'),
+        only_drops: z.boolean().optional().describe('Only show rows with negative week-over-week change (find traffic/conversion losses)'),
+        only_gains: z.boolean().optional().describe('Only show rows with positive week-over-week change (find growth)'),
+        sort_by: z.enum(['value', 'change_w1', 'change_l4wavg', 'change_ly4wavg', 'z_score']).optional().default('value').describe('Sort by: value (metric amount), change_w1 (W/W %), change_l4wavg (vs 4-week avg %), change_ly4wavg (vs last year %)'),
+        sort_order: z.enum(['asc', 'desc']).optional().default('desc').describe('desc: highest/best first | asc: lowest/worst first'),
+        comparison_type: z.enum(['W1', 'L4WAVG', 'LY4WAVG', 'all']).optional().default('all').describe('Which comparisons to include in response: W1, L4WAVG, LY4WAVG, or all'),
+        limit: z.number().optional().default(100).describe('Maximum rows to return (default: 100, max: 500)'),
+        include_insights: z.boolean().optional().default(true).describe('Auto-detect notable changes (>15%) and include as insights array'),
+        fetch_if_missing: z.boolean().optional().default(false).describe('If no data found, return instructions for fetching from GA4 API'),
     }, async (params) => {
         const result = await mcpRequest('tools/call', {
-            name: 'query_analytics_metrics',
+            name: 'query_analytics_data',
             arguments: params,
         });
         return {
             content: result.content.map((c) => ({ type: 'text', text: c.text })),
         };
     });
-    // Tool 3: list_sources
-    server.tool('list_sources', 'List all analytics sources (GA4 properties) available to the authenticated user.', {
-        include_details: z
-            .boolean()
-            .default(false)
-            .describe('Include additional details like last processed date and data availability'),
+    // ============================================================================
+    // Tool 4: analyze_url
+    // ============================================================================
+    server.tool('analyze_url', `Deep-dive analysis for a specific URL or landing page.
+
+PURPOSE:
+Get comprehensive performance data for a single page, including traffic metrics, comparisons, and breakdowns by device/channel/country. More focused than query_analytics_data when you know the exact page.
+
+WHAT YOU GET:
+- Core metrics: sessions, visitors, bounce rate, conversions, revenue
+- Week-over-week and 4-week average comparisons
+- Share of total site traffic
+- Breakdowns by:
+  - deviceCategory (desktop/mobile/tablet split)
+  - sessionDefaultChannelGrouping (organic/direct/paid/social)
+  - country (geographic distribution)
+  - newVsReturning (new vs returning visitors)
+- Auto-detected insights (drops, growth, anomalies)
+
+URL MATCHING:
+- Partial match: "/blog" matches "/blog/post-1", "/blog/post-2"
+- Exact match: Use full path for specific page
+- Domain optional: Both "example.com/page" and "/page" work
+
+OUTPUT STRUCTURE:
+{
+  "status": "data_found",
+  "url": "/blog/guide",
+  "metrics": { "sessions": 1250, "visitors": 980, "bounceRate": 45.2, "conversions": 32 },
+  "comparisons": {
+    "w1": { "sessions": { "previous": 1400, "changePercent": -10.7 } },
+    "l4wavg": { "sessions": { "previous": 1180, "changePercent": 5.9 } }
+  },
+  "shareOfSiteTraffic": 8.1,
+  "breakdowns": [
+    { "dimension": "deviceCategory", "values": [{ "value": "mobile", "sessions": 650, "share": 52 }] }
+  ],
+  "insights": [{ "type": "drop", "message": "Mobile traffic down 18% W/W" }]
+}
+
+WHEN DATA IS MISSING:
+Returns status="needs_fetch" with instructions to fetch from GA4 API.
+
+TYPICAL WORKFLOW:
+1. Use get_weekly_insights to identify problematic pages
+2. Call analyze_url for deep dive on specific page
+3. Use query_analytics_data for cross-page comparisons`, {
+        source_id: z.string().describe('The analytics source/property ID (get from list_sources)'),
+        url: z.string().describe('URL path to analyze. Examples: "/blog/guide", "/pricing", "example.com/page". Partial paths match multiple pages.'),
+        week_start_date: z.string().describe('Monday of the week to analyze (ISO format: YYYY-MM-DD)'),
+        include_breakdowns: z.boolean().optional().default(true).describe('Include device, channel, country, and new/returning breakdowns'),
+        fetch_if_missing: z.boolean().optional().default(false).describe('If data not found, return fetch instructions instead of empty result'),
     }, async (params) => {
         const result = await mcpRequest('tools/call', {
-            name: 'list_sources',
+            name: 'analyze_url',
+            arguments: params,
+        });
+        return {
+            content: result.content.map((c) => ({ type: 'text', text: c.text })),
+        };
+    });
+    // ============================================================================
+    // Tool 5: get_source_config
+    // ============================================================================
+    server.tool('get_source_config', `Get the configuration and metric mappings for an analytics source.
+
+PURPOSE:
+Understand how GA4 events and metrics are mapped to internal metrics (conversions, leads, purchases, revenue). Essential for interpreting metric values correctly.
+
+WHAT YOU GET:
+- Metric mappings: Which GA4 events count as conversions, leads, purchases
+- Revenue configuration: Currency, event mapping
+- Funnel stage assignments: How metrics map to acquisition/engagement/conversion/monetization
+- Custom dimension mappings: Any custom dimensions configured
+
+EXAMPLE OUTPUT:
+{
+  "sourceId": "src_abc123",
+  "name": "My Website",
+  "metricMappings": {
+    "conversions": { "events": ["form_submit", "signup", "purchase"], "aggregation": "sum" },
+    "leads": { "events": ["form_submit", "signup"], "aggregation": "sum" },
+    "purchases": { "events": ["purchase"], "aggregation": "sum" },
+    "revenue": { "events": ["purchase"], "property": "value", "currency": "USD" }
+  },
+  "funnelConfig": {
+    "acquisition": ["sessions", "visitors"],
+    "engagement": ["pageviews", "time_on_site"],
+    "conversion": ["conversions", "leads"],
+    "monetization": ["purchases", "revenue"]
+  }
+}
+
+USE CASES:
+- Verify what counts as a "conversion" before analyzing conversion data
+- Understand revenue calculation methodology
+- Debug metric discrepancies between GA4 and insights`, {
+        source_id: z.string().describe('The analytics source/property ID (get from list_sources)'),
+    }, async (params) => {
+        const result = await mcpRequest('tools/call', {
+            name: 'get_source_config',
             arguments: params,
         });
         return {
             content: result.content.map((c) => ({ type: 'text', text: c.text })),
         };
     });
-    // Tool 4: trigger_analytics_workflow
-    server.tool('trigger_analytics_workflow', 'Trigger the analytics agent workflow to process a specific week. Returns immediately with a workflow ID that can be polled for status.', {
+    // ============================================================================
+    // Tool 6: get_funnel_definition
+    // ============================================================================
+    server.tool('get_funnel_definition', `Get the standard marketing funnel structure and stage definitions.
+
+PURPOSE:
+Returns the funnel framework used to categorize and analyze metrics. Helps understand how different metrics relate across the customer journey.
+
+FUNNEL STAGES:
+┌─────────────────┬────────────────────────────────────────────────────────────┐
+│ Stage           │ Metrics & Purpose                                          │
+├─────────────────┼────────────────────────────────────────────────────────────┤
+│ ACQUISITION     │ sessions, visitors, newUsers                               │
+│                 │ How people find and arrive at your site                    │
+├─────────────────┼────────────────────────────────────────────────────────────┤
+│ ENGAGEMENT      │ pageviews, avgSessionDuration, bounceRate, pagesPerSession │
+│                 │ How people interact with your content                      │
+├─────────────────┼────────────────────────────────────────────────────────────┤
+│ CONVERSION      │ conversions, leads, signups, formSubmits                   │
+│                 │ Actions that indicate interest/intent                      │
+├─────────────────┼────────────────────────────────────────────────────────────┤
+│ MONETIZATION    │ purchases, revenue, transactions, avgOrderValue            │
+│                 │ Revenue-generating actions                                 │
+└─────────────────┴────────────────────────────────────────────────────────────┘
+
+OUTPUT INCLUDES:
+- Stage definitions with associated metrics
+- Stage-to-stage conversion rate calculations
+- Benchmark ranges for each metric
+- Metric interdependencies
+
+USE CASES:
+- Understand which metrics to focus on at each funnel stage
+- Identify where in the funnel problems are occurring
+- Plan analysis strategy based on business goals`, {}, async () => {
+        const result = await mcpRequest('tools/call', {
+            name: 'get_funnel_definition',
+            arguments: {},
+        });
+        return {
+            content: result.content.map((c) => ({ type: 'text', text: c.text })),
+        };
+    });
+    // ============================================================================
+    // Tool 7: trigger_analytics_workflow (Future Implementation)
+    // ============================================================================
+    server.tool('trigger_analytics_workflow', `[COMING SOON] Trigger data processing workflow for a specific week.
+
+PURPOSE:
+Initiates the analytics processing pipeline to fetch fresh data from GA4 and generate insights. Use when data is missing or stale.
+
+NOTE: This tool is planned for a future release. Currently, data processing is handled automatically on a schedule.`, {
         source_id: z.string().describe('The analytics source/property ID'),
-        week_start_date: z.string().describe('Start date of the week to process (ISO format)'),
-        force_refresh: z.boolean().default(false).describe('Force re-processing even if data already exists'),
-        wait_for_completion: z.boolean().default(false).describe('If true, poll until workflow completes'),
-        timeout_seconds: z.number().max(600).default(300).describe('Maximum time to wait if wait_for_completion is true'),
+        week_start_date: z.string().describe('Monday of the week to process (ISO format: YYYY-MM-DD)'),
+        force_refresh: z.boolean().default(false).describe('Re-process even if data already exists'),
+        wait_for_completion: z.boolean().default(false).describe('Wait for workflow to complete before returning'),
+        timeout_seconds: z.number().max(600).default(300).describe('Max wait time if wait_for_completion=true'),
     }, async (params) => {
         const result = await mcpRequest('tools/call', {
             name: 'trigger_analytics_workflow',
@@ -151,10 +435,17 @@ async function main() {
             content: result.content.map((c) => ({ type: 'text', text: c.text })),
         };
     });
-    // Tool 5: get_workflow_status
-    server.tool('get_workflow_status', 'Check the status of a running analytics workflow triggered by trigger_analytics_workflow.', {
+    // ============================================================================
+    // Tool 8: get_workflow_status (Future Implementation)
+    // ============================================================================
+    server.tool('get_workflow_status', `[COMING SOON] Check status of a running analytics workflow.
+
+PURPOSE:
+Poll for completion status after triggering a workflow with trigger_analytics_workflow.
+
+NOTE: This tool is planned for a future release alongside trigger_analytics_workflow.`, {
         invocation_id: z.string().describe('The invocation ID returned by trigger_analytics_workflow'),
-        source_id: z.string().describe('The analytics source/property ID (for validation)'),
+        source_id: z.string().describe('The analytics source/property ID'),
     }, async (params) => {
         const result = await mcpRequest('tools/call', {
             name: 'get_workflow_status',
@@ -164,15 +455,22 @@ async function main() {
             content: result.content.map((c) => ({ type: 'text', text: c.text })),
         };
     });
-    // Tool 6: get_ga4_data
-    server.tool('get_ga4_data', 'Get Google Analytics 4 data for specific pages, segments, or dimensions. Fetches from database if available, otherwise retrieves from GA4 API.', {
+    // ============================================================================
+    // Tool 9: get_ga4_data (Future Implementation)
+    // ============================================================================
+    server.tool('get_ga4_data', `[COMING SOON] Direct GA4 API data fetch for custom queries.
+
+PURPOSE:
+Fetch raw data directly from Google Analytics 4 API for custom analysis not covered by standard tools.
+
+NOTE: This tool is planned for a future release. Currently, use query_analytics_data for pre-processed data with comparisons and insights.`, {
         source_id: z.string().describe('The analytics source/property ID'),
         date_range: z
             .object({
-            start_date: z.string().describe('Start date (ISO format)'),
-            end_date: z.string().describe('End date (ISO format)'),
+            start_date: z.string().describe('Start date (ISO format: YYYY-MM-DD)'),
+            end_date: z.string().describe('End date (ISO format: YYYY-MM-DD)'),
         })
-            .describe('Date range to fetch data for'),
+            .describe('Date range to fetch'),
         dimensions: z
             .array(z.enum([
             'landingPage',
@@ -186,8 +484,8 @@ async function main() {
             'region',
         ]))
             .optional()
-            .describe('Dimensions to break down the data by'),
-        filters: z.record(z.string()).optional().describe('Key-value pairs to filter data'),
+            .describe('Dimensions to include'),
+        filters: z.record(z.string()).optional().describe('Dimension filters as key-value pairs'),
         metrics: z
             .array(z.enum([
             'sessions',
@@ -201,8 +499,8 @@ async function main() {
             'totalRevenue',
         ]))
             .default(['sessions', 'totalUsers'])
-            .describe('Metrics to retrieve'),
-        fetch_if_missing: z.boolean().default(true).describe('If true, fetch from GA4 API when data not in database'),
+            .describe('Metrics to fetch'),
+        fetch_if_missing: z.boolean().default(true).describe('Fetch from GA4 API if not in cache'),
     }, async (params) => {
         const result = await mcpRequest('tools/call', {
             name: 'get_ga4_data',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wwhat/mcp-stdio-client",
-  "version": "1.0.0",
+  "version": "1.0.3",
   "description": "Stdio wrapper for wwhat MCP server - enables Cursor/Claude Desktop integration",
   "type": "module",
   "main": "dist/index.js",
@@ -28,7 +28,7 @@
     "ga4"
   ],
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@modelcontextprotocol/sdk": "^1.25.0",
     "zod": "^3.23.0"
   },
   "devDependencies": {