Update ToolHive reference docs for v0.1.2 (#36)

github-actions[bot] · web-flow · commit 2d5cea5b547d · 2025-07-02T10:36:06.000-04:00
Co-authored-by: github-actions[bot] &lt;41898282+github-actions[bot]@users.noreply.github.com&gt;
diff --git a/docs/toolhive/reference/cli/thv.md b/docs/toolhive/reference/cli/thv.md
@@ -29,6 +29,7 @@ thv [flags]
 * [thv inspector](thv_inspector.md)	 - Launches the MCP Inspector UI and connects it to the specified MCP server
 * [thv list](thv_list.md)	 - List running MCP servers
 * [thv logs](thv_logs.md)	 - Output the logs of an MCP server or manage log files
+* [thv mcp](thv_mcp.md)	 - Interact with MCP servers for debugging
 * [thv proxy](thv_proxy.md)	 - Create a transparent proxy for an MCP server with authentication support
 * [thv registry](thv_registry.md)	 - Manage MCP server registry
 * [thv restart](thv_restart.md)	 - Restart a tooling server
diff --git a/docs/toolhive/reference/cli/thv_config.md b/docs/toolhive/reference/cli/thv_config.md
@@ -24,6 +24,7 @@ The config command provides subcommands to manage application configuration sett
 * [thv config get-ca-cert](thv_config_get-ca-cert.md)	 - Get the currently configured CA certificate path
 * [thv config get-registry-url](thv_config_get-registry-url.md)	 - Get the currently configured registry URL
 * [thv config list-registered-clients](thv_config_list-registered-clients.md)	 - List all registered MCP clients
+* [thv config otel](thv_config_otel.md)	 - Manage OpenTelemetry configuration
 * [thv config register-client](thv_config_register-client.md)	 - Register a client for MCP server configuration
 * [thv config remove-client](thv_config_remove-client.md)	 - Remove a client from MCP server configuration
 * [thv config set-ca-cert](thv_config_set-ca-cert.md)	 - Set the default CA certificate for container builds
diff --git a/docs/toolhive/reference/cli/thv_config_otel.md b/docs/toolhive/reference/cli/thv_config_otel.md
@@ -0,0 +1,33 @@
+## thv config otel
+
+Manage OpenTelemetry configuration
+
+### Synopsis
+
+Configure OpenTelemetry settings for observability and monitoring of MCP servers.
+
+### Options
+
+```
+  -h, --help   help for otel
+```
+
+### Options inherited from parent commands
+
+```
+      --debug   Enable debug mode
+```
+
+### SEE ALSO
+
+* [thv config](thv_config.md)	 - Manage application configuration
+* [thv config otel get-endpoint](thv_config_otel_get-endpoint.md)	 - Get the currently configured OpenTelemetry endpoint
+* [thv config otel get-env-vars](thv_config_otel_get-env-vars.md)	 - Get the currently configured OpenTelemetry environment variables
+* [thv config otel get-sampling-rate](thv_config_otel_get-sampling-rate.md)	 - Get the currently configured OpenTelemetry sampling rate
+* [thv config otel set-endpoint](thv_config_otel_set-endpoint.md)	 - Set the OpenTelemetry endpoint URL
+* [thv config otel set-env-vars](thv_config_otel_set-env-vars.md)	 - Set the OpenTelemetry environment variables
+* [thv config otel set-sampling-rate](thv_config_otel_set-sampling-rate.md)	 - Set the OpenTelemetry sampling rate
+* [thv config otel unset-endpoint](thv_config_otel_unset-endpoint.md)	 - Remove the configured OpenTelemetry endpoint
+* [thv config otel unset-env-vars](thv_config_otel_unset-env-vars.md)	 - Remove the configured OpenTelemetry environment variables
+* [thv config otel unset-sampling-rate](thv_config_otel_unset-sampling-rate.md)	 - Remove the configured OpenTelemetry sampling rate
+
diff --git a/docs/toolhive/reference/cli/thv_config_otel_get-endpoint.md b/docs/toolhive/reference/cli/thv_config_otel_get-endpoint.md
@@ -0,0 +1,28 @@
+## thv config otel get-endpoint
+
+Get the currently configured OpenTelemetry endpoint
+
+### Synopsis
+
+Display the OpenTelemetry endpoint URL that is currently configured.
+
+```
+thv config otel get-endpoint [flags]
+```
+
+### Options
+
+```
+  -h, --help   help for get-endpoint
+```
+
+### Options inherited from parent commands
+
+```
+      --debug   Enable debug mode
+```
+
+### SEE ALSO
+
+* [thv config otel](thv_config_otel.md)	 - Manage OpenTelemetry configuration
+
diff --git a/docs/toolhive/reference/cli/thv_config_otel_get-env-vars.md b/docs/toolhive/reference/cli/thv_config_otel_get-env-vars.md
@@ -0,0 +1,28 @@
+## thv config otel get-env-vars
+
+Get the currently configured OpenTelemetry environment variables
+
+### Synopsis
+
+Display the OpenTelemetry environment variables that are currently configured.
+
+```
+thv config otel get-env-vars [flags]
+```
+
+### Options
+
+```
+  -h, --help   help for get-env-vars
+```
+
+### Options inherited from parent commands
+
+```
+      --debug   Enable debug mode
+```
+
+### SEE ALSO
+
+* [thv config otel](thv_config_otel.md)	 - Manage OpenTelemetry configuration
+
diff --git a/docs/toolhive/reference/cli/thv_config_otel_get-sampling-rate.md b/docs/toolhive/reference/cli/thv_config_otel_get-sampling-rate.md
@@ -0,0 +1,28 @@
+## thv config otel get-sampling-rate
+
+Get the currently configured OpenTelemetry sampling rate
+
+### Synopsis
+
+Display the OpenTelemetry sampling rate that is currently configured.
+
+```
+thv config otel get-sampling-rate [flags]
+```
+
+### Options
+
+```
+  -h, --help   help for get-sampling-rate
+```
+
+### Options inherited from parent commands
+
+```
+      --debug   Enable debug mode
+```
+
+### SEE ALSO
+
+* [thv config otel](thv_config_otel.md)	 - Manage OpenTelemetry configuration
+
diff --git a/docs/toolhive/reference/cli/thv_config_otel_set-endpoint.md b/docs/toolhive/reference/cli/thv_config_otel_set-endpoint.md
@@ -0,0 +1,32 @@
+## thv config otel set-endpoint
+
+Set the OpenTelemetry endpoint URL
+
+### Synopsis
+
+Set the OpenTelemetry OTLP endpoint URL for tracing and metrics.
+This endpoint will be used by default when running MCP servers unless overridden by the --otel-endpoint flag.
+
+Example:
+  thv config otel set-endpoint https://api.honeycomb.io
+
+```
+thv config otel set-endpoint <endpoint> [flags]
+```
+
+### Options
+
+```
+  -h, --help   help for set-endpoint
+```
+
+### Options inherited from parent commands
+
+```
+      --debug   Enable debug mode
+```
+
+### SEE ALSO
+
+* [thv config otel](thv_config_otel.md)	 - Manage OpenTelemetry configuration
+
diff --git a/docs/toolhive/reference/cli/thv_config_otel_set-env-vars.md b/docs/toolhive/reference/cli/thv_config_otel_set-env-vars.md
@@ -0,0 +1,32 @@
+## thv config otel set-env-vars
+
+Set the OpenTelemetry environment variables
+
+### Synopsis
+
+Set the list of environment variable names to include in OpenTelemetry spans.
+These environment variables will be used by default when running MCP servers unless overridden by the --otel-env-vars flag.
+
+Example:
+  thv config otel set-env-vars USER,HOME,PATH
+
+```
+thv config otel set-env-vars <var1,var2,...> [flags]
+```
+
+### Options
+
+```
+  -h, --help   help for set-env-vars
+```
+
+### Options inherited from parent commands
+
+```
+      --debug   Enable debug mode
+```
+
+### SEE ALSO
+
+* [thv config otel](thv_config_otel.md)	 - Manage OpenTelemetry configuration
+
diff --git a/docs/toolhive/reference/cli/thv_config_otel_set-sampling-rate.md b/docs/toolhive/reference/cli/thv_config_otel_set-sampling-rate.md
@@ -0,0 +1,32 @@
+## thv config otel set-sampling-rate
+
+Set the OpenTelemetry sampling rate
+
+### Synopsis
+
+Set the OpenTelemetry trace sampling rate (between 0.0 and 1.0).
+This sampling rate will be used by default when running MCP servers unless overridden by the --otel-sampling-rate flag.
+
+Example:
+  thv config otel set-sampling-rate 0.1
+
+```
+thv config otel set-sampling-rate <rate> [flags]
+```
+
+### Options
+
+```
+  -h, --help   help for set-sampling-rate
+```
+
+### Options inherited from parent commands
+
+```
+      --debug   Enable debug mode
+```
+
+### SEE ALSO
+
+* [thv config otel](thv_config_otel.md)	 - Manage OpenTelemetry configuration
+
diff --git a/docs/toolhive/reference/cli/thv_config_otel_unset-endpoint.md b/docs/toolhive/reference/cli/thv_config_otel_unset-endpoint.md
@@ -0,0 +1,28 @@
+## thv config otel unset-endpoint
+
+Remove the configured OpenTelemetry endpoint
+
+### Synopsis
+
+Remove the OpenTelemetry endpoint configuration.
+
+```
+thv config otel unset-endpoint [flags]
+```
+
+### Options
+
+```
+  -h, --help   help for unset-endpoint
+```
+
+### Options inherited from parent commands
+
+```
+      --debug   Enable debug mode
+```
+
+### SEE ALSO
+
+* [thv config otel](thv_config_otel.md)	 - Manage OpenTelemetry configuration
+
diff --git a/docs/toolhive/reference/cli/thv_config_otel_unset-env-vars.md b/docs/toolhive/reference/cli/thv_config_otel_unset-env-vars.md
@@ -0,0 +1,28 @@
+## thv config otel unset-env-vars
+
+Remove the configured OpenTelemetry environment variables
+
+### Synopsis
+
+Remove the OpenTelemetry environment variables configuration.
+
+```
+thv config otel unset-env-vars [flags]
+```
+
+### Options
+
+```
+  -h, --help   help for unset-env-vars
+```
+
+### Options inherited from parent commands
+
+```
+      --debug   Enable debug mode
+```
+
+### SEE ALSO
+
+* [thv config otel](thv_config_otel.md)	 - Manage OpenTelemetry configuration
+
diff --git a/docs/toolhive/reference/cli/thv_config_otel_unset-sampling-rate.md b/docs/toolhive/reference/cli/thv_config_otel_unset-sampling-rate.md
@@ -0,0 +1,28 @@
+## thv config otel unset-sampling-rate
+
+Remove the configured OpenTelemetry sampling rate
+
+### Synopsis
+
+Remove the OpenTelemetry sampling rate configuration.
+
+```
+thv config otel unset-sampling-rate [flags]
+```
+
+### Options
+
+```
+  -h, --help   help for unset-sampling-rate
+```
+
+### Options inherited from parent commands
+
+```
+      --debug   Enable debug mode
+```
+
+### SEE ALSO
+
+* [thv config otel](thv_config_otel.md)	 - Manage OpenTelemetry configuration
+
diff --git a/docs/toolhive/reference/cli/thv_mcp.md b/docs/toolhive/reference/cli/thv_mcp.md
@@ -0,0 +1,25 @@
+## thv mcp
+
+Interact with MCP servers for debugging
+
+### Synopsis
+
+The mcp command provides subcommands to interact with MCP (Model Context Protocol) servers for debugging purposes.
+
+### Options
+
+```
+  -h, --help   help for mcp
+```
+
+### Options inherited from parent commands
+
+```
+      --debug   Enable debug mode
+```
+
+### SEE ALSO
+
+* [thv](thv.md)	 - ToolHive (thv) is a lightweight, secure, and fast manager for MCP servers
+* [thv mcp list](thv_mcp_list.md)	 - List MCP server capabilities
+
diff --git a/docs/toolhive/reference/cli/thv_mcp_list.md b/docs/toolhive/reference/cli/thv_mcp_list.md
@@ -0,0 +1,34 @@
+## thv mcp list
+
+List MCP server capabilities
+
+### Synopsis
+
+List tools, resources, and prompts available from an MCP server. Use subcommands to list specific types.
+
+```
+thv mcp list [tools|resources|prompts] [flags]
+```
+
+### Options
+
+```
+      --format string      Output format (json or text) (default "text")
+  -h, --help               help for list
+      --server string      MCP server URL (required)
+      --timeout duration   Connection timeout (default 30s)
+```
+
+### Options inherited from parent commands
+
+```
+      --debug   Enable debug mode
+```
+
+### SEE ALSO
+
+* [thv mcp](thv_mcp.md)	 - Interact with MCP servers for debugging
+* [thv mcp list prompts](thv_mcp_list_prompts.md)	 - List available prompts from MCP server
+* [thv mcp list resources](thv_mcp_list_resources.md)	 - List available resources from MCP server
+* [thv mcp list tools](thv_mcp_list_tools.md)	 - List available tools from MCP server
+
diff --git a/docs/toolhive/reference/cli/thv_mcp_list_prompts.md b/docs/toolhive/reference/cli/thv_mcp_list_prompts.md
diff --git a/docs/toolhive/reference/cli/thv_mcp_list_resources.md b/docs/toolhive/reference/cli/thv_mcp_list_resources.md
diff --git a/docs/toolhive/reference/cli/thv_mcp_list_tools.md b/docs/toolhive/reference/cli/thv_mcp_list_tools.md
diff --git a/docs/toolhive/reference/cli/thv_run.md b/docs/toolhive/reference/cli/thv_run.md
