Home page and analytics

.env.example

@@ -38,6 +38,13 @@ COUNTLY_SERVER_URL=https://api.count.ly
 # Default: 30000 (30 seconds)
 COUNTLY_TIMEOUT=30000
 
+# Analytics Tracking (optional)
+# Enable anonymous usage analytics to help improve the MCP server
+# All data is aggregated under device ID "mcp" - completely anonymous
+# NO authentication tokens, server URLs, or personal data is collected
+# Default: false (disabled)
+# ENABLE_ANALYTICS=true
+
 
 # ==============================================================================
 # AUTHENTICATION PRIORITY

README.md

@@ -139,11 +139,44 @@ The server supports multiple authentication methods (in priority order):
 | `COUNTLY_AUTH_TOKEN` | No* | - | Authentication token (direct) |
 | `COUNTLY_AUTH_TOKEN_FILE` | No* | - | Path to file containing auth token |
 | `COUNTLY_TIMEOUT` | No | `30000` | Request timeout in milliseconds |
+| `ENABLE_ANALYTICS` | No | `false` | Enable anonymous usage analytics |
 | `COUNTLY_TOOLS_{CATEGORY}` | No | `ALL` | Control available tools per category (see below) |
 | `COUNTLY_TOOLS_ALL` | No | `ALL` | Default permission for all categories |
 
 *At least one authentication method must be configured
 
+### Analytics Tracking (Optional)
+
+The MCP server includes optional anonymous usage analytics to help improve the product. Analytics are **disabled by default** and can be enabled via the `ENABLE_ANALYTICS=true` environment variable.
+
+**What is tracked:**
+- Transport type used (stdio vs HTTP)
+- Tool execution metrics (success/failure, duration, tool names)
+- Authentication methods used (headers, env, file, args)
+- HTTP endpoint access patterns
+- Error occurrences (type and message, NO sensitive data)
+- Server start/stop events
+
+**What is NOT tracked:**
+- Authentication tokens or credentials
+- Server URLs or domains
+- User data or analytics content
+- Personal information
+- IP addresses or client identifiers
+
+**Privacy & Device ID:**
+All analytics are aggregated under a single device ID "mcp" to ensure complete anonymity. No server-specific or user-specific information is collected.
+
+**To enable:**
+```bash
+export ENABLE_ANALYTICS=true
+```
+
+Or in your `.env` file:
+```
+ENABLE_ANALYTICS=true
+```
+
 ### Tools Configuration
 
 The server supports fine-grained control over which MCP tools are available and which CRUD operations they can perform. This is useful for security, governance, or creating read-only deployments.

package.json

@@ -28,6 +28,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.21.0",
     "axios": "^1.13.2",
+    "countly-sdk-nodejs": "^24.10.3",
     "dotenv": "^17.2.3"
   },
   "devDependencies": {