Add documentation for Usage Metrics

docs/toolhive/faq.mdx

@@ -78,6 +78,44 @@ Kubernetes cluster to use it with the operator.
 
 :::
 
+## Privacy and data collection
+
+### Does ToolHive collect any data?
+
+ToolHive collects anonymous usage metrics to help improve the product. These
+metrics include only tool call counts and are completely anonymous. No personal
+information, user identifiers, or sensitive data is collected.
+
+The metrics collection:
+
+- Is enabled by default
+- Only tracks the number of tool calls
+- Uses a randomly generated instance ID (not tied to your identity)
+- Is automatically disabled in CI environments
+- Can be easily disabled
+
+### How do I disable usage metrics?
+
+You can opt out of usage metrics collection in two ways:
+
+**Option 1: Persistent configuration (recommended)**
+
+Use the ToolHive CLI to disable metrics permanently:
+
+```bash
+thv config usage-metrics disable
+```
+
+**Option 2: Environment variable**
+
+Set an environment variable to disable metrics for the current session:
+
+```bash
+export TOOLHIVE_USAGE_METRICS_ENABLED=false
+```
+
+After opting out, ToolHive will not collect or send any usage metrics.
+
 ## Security and permissions
 
 ### Is it safe to run MCP servers?

docs/toolhive/guides-cli/install.mdx

@@ -155,6 +155,15 @@ Go version: go1.24.1
 Platform: darwin/arm64
 ```
 
+:::info[Privacy: Anonymous usage metrics]
+
+ToolHive collects anonymous usage metrics (tool call counts only) to help
+improve the product. No personal information or sensitive data is collected. You
+can disable this at any time using `thv config usage-metrics disable`. For more
+information, see the [FAQ](../faq.mdx#does-toolhive-collect-any-data).
+
+:::
+
 ## Upgrade ToolHive
 
 ToolHive automatically checks for updates and notifies you when a new version is

docs/toolhive/guides-ui/install.mdx

@@ -182,21 +182,46 @@ in the ToolHive UI.
 
 ## Telemetry and error reporting
 
+ToolHive collects two types of data to help improve the product:
+
+### Error reporting (Sentry)
+
 ToolHive uses [Sentry](https://sentry.io/welcome/) for error tracking and
 performance monitoring to help us identify and fix issues, improve stability,
 and enhance the user experience. This telemetry is enabled by default. You can
 disable this by turning off the **Error reporting** option in the settings
 screen (⚙️) if you prefer not to share this data.
 
-ToolHive collects the following information:
+Error reporting collects:
 
 - Error reports and crash logs
 - Performance metrics
 - Usage patterns
 
-This data is anonymized and does not include any personally identifiable
-information. It helps us understand how ToolHive is used and identify areas for
-improvement. Review the
+### Anonymous usage metrics
+
+ToolHive also collects anonymous usage metrics (tool call counts only) to
+understand how the product is used. This data is completely anonymous and
+includes no personal information or user identifiers. You can disable this using
+the CLI:
+
+```bash
+thv config usage-metrics disable
+```
+
+Alternatively, set an environment variable to disable metrics for the current
+session:
+
+```bash
+export TOOLHIVE_USAGE_METRICS_ENABLED=false
+```
+
+For more information about usage metrics, see the
+[FAQ](../faq.mdx#does-toolhive-collect-any-data).
+
+All telemetry data is anonymized and does not include any personally
+identifiable information. It helps understand how ToolHive is used and identify
+areas for improvement. Review the
 [Stacklok privacy policy](https://www.iubenda.com/privacy-policy/29074746) and
 [Terms of Service](https://stacklok.com/terms-of-service) for more details.