diff --git a/docs/toolhive/faq.mdx b/docs/toolhive/faq.mdx index 5145fc6..3f9badd 100644 --- a/docs/toolhive/faq.mdx +++ b/docs/toolhive/faq.mdx @@ -78,6 +78,45 @@ 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 +``` + +Once you opt out, ToolHive stops collecting and sending usage metrics. You need +to restart any running servers for the change to take effect. + ## Security and permissions ### Is it safe to run MCP servers? diff --git a/docs/toolhive/guides-cli/install.mdx b/docs/toolhive/guides-cli/install.mdx index 868dff0..f6833a3 100644 --- a/docs/toolhive/guides-cli/install.mdx +++ b/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