mcp-ga4 2.0.6 → 2.0.8

package/README.md

@@ -92,6 +92,8 @@ Multi-client mode:
 }
 ```
 
+**Claude Desktop:** Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows).
+
 ## Common Query Patterns
 
 **Top pages:**

package/dist/build-info.json

@@ -1 +1 @@
-{"sha":"9f7d432","builtAt":"2026-04-09T21:37:39.488Z"}
+{"sha":"c294c67","builtAt":"2026-04-09T21:59:03.043Z"}

package/dist/errors.d.ts

@@ -10,4 +10,8 @@ export declare class Ga4ServiceError extends Error {
     readonly cause?: unknown | undefined;
     constructor(message: string, cause?: unknown | undefined);
 }
+export declare function validateCredentials(): {
+    valid: boolean;
+    missing: string[];
+};
 export declare function classifyError(error: any): Error;

package/dist/errors.js

@@ -9,7 +9,7 @@ export class Ga4AuthError extends Error {
 export class Ga4RateLimitError extends Error {
     retryAfterMs;
     constructor(retryAfterMs, cause) {
-        super(`Rate limited, retry after ${retryAfterMs}ms`);
+        super(`GA4 rate limited, retry after ${retryAfterMs}ms`);
         this.retryAfterMs = retryAfterMs;
         this.name = "Ga4RateLimitError";
         this.cause = cause;
@@ -23,13 +23,21 @@ export class Ga4ServiceError extends Error {
         this.name = "Ga4ServiceError";
     }
 }
+export function validateCredentials() {
+    const missing = [];
+    if (!process.env.GA4_PROPERTY_ID?.trim())
+        missing.push("GA4_PROPERTY_ID");
+    if (!process.env.GOOGLE_APPLICATION_CREDENTIALS?.trim())
+        missing.push("GOOGLE_APPLICATION_CREDENTIALS");
+    return { valid: missing.length === 0, missing };
+}
 export function classifyError(error) {
     const message = error?.message || String(error);
     const code = error?.code || error?.status;
     if (code === 401 || code === 403 || code === 7 || code === 16 ||
         message.includes("PERMISSION_DENIED") || message.includes("UNAUTHENTICATED") ||
         message.includes("invalid_grant")) {
-        return new Ga4AuthError(`Auth failed: ${message}. Check credentials.`, error);
+        return new Ga4AuthError(`GA4 auth failed: ${message}. Check credentials.`, error);
     }
     if (code === 429 || code === 8 || message.includes("RESOURCE_EXHAUSTED") || message.includes("rateLimitExceeded")) {
         return new Ga4RateLimitError(60_000, error);

package/dist/index.js

@@ -411,6 +411,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             error: true,
             error_type: error.name,
             message: error.message,
+            server: __cliPkg.name,
         };
         if (error instanceof Ga4AuthError) {
             response.action_required = "Check service account or OAuth credentials and GA4 property access.";
@@ -426,8 +427,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             response.details = rawError.stack;
         }
         return {
-            content: [{ type: "text", text: JSON.stringify(response, null, 2) }],
             isError: true,
+            content: [{ type: "text", text: JSON.stringify(response, null, 2) }],
         };
     }
 });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mcp-ga4",
   "mcpName": "io.github.mharnett/ga4",
-  "version": "2.0.6",
+  "version": "2.0.8",
   "description": "MCP server for Google Analytics 4 - query GA4 data with natural language via Claude.",
   "main": "dist/index.js",
   "bin": {