Skip to content

Commit 13d3cec

Browse files
Update ToolHive reference docs for v0.3.8 (#237)
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
1 parent cd6abdf commit 13d3cec

File tree

2 files changed

+97
-81
lines changed

2 files changed

+97
-81
lines changed

docs/toolhive/reference/cli/thv_proxy.md

Lines changed: 30 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -97,28 +97,36 @@ thv proxy [flags] SERVER_NAME
9797
### Options
9898

9999
```
100-
-h, --help help for proxy
101-
--host string Host for the HTTP proxy to listen on (IP or hostname) (default "127.0.0.1")
102-
--oidc-audience string Expected audience for the token
103-
--oidc-client-id string OIDC client ID
104-
--oidc-client-secret string OIDC client secret (optional, for introspection)
105-
--oidc-introspection-url string URL for token introspection endpoint
106-
--oidc-issuer string OIDC issuer URL (e.g., https://accounts.google.com)
107-
--oidc-jwks-url string URL to fetch the JWKS from
108-
--port int Port for the HTTP proxy to listen on (host port)
109-
--remote-auth Enable OAuth/OIDC authentication to remote MCP server
110-
--remote-auth-authorize-url string OAuth authorization endpoint URL (alternative to --remote-auth-issuer for non-OIDC OAuth)
111-
--remote-auth-callback-port int Port for OAuth callback server during remote authentication (default 8666)
112-
--remote-auth-client-id string OAuth client ID for remote server authentication
113-
--remote-auth-client-secret string OAuth client secret for remote server authentication (optional for PKCE)
114-
--remote-auth-client-secret-file string Path to file containing OAuth client secret (alternative to --remote-auth-client-secret)
115-
--remote-auth-issuer string OAuth/OIDC issuer URL for remote server authentication (e.g., https://accounts.google.com)
116-
--remote-auth-scopes strings OAuth scopes to request for remote server authentication (defaults: OIDC uses 'openid,profile,email')
117-
--remote-auth-skip-browser Skip opening browser for remote server OAuth flow
118-
--remote-auth-timeout duration Timeout for OAuth authentication flow (e.g., 30s, 1m, 2m30s) (default 30s)
119-
--remote-auth-token-url string OAuth token endpoint URL (alternative to --remote-auth-issuer for non-OIDC OAuth)
120-
--resource-url string Explicit resource URL for OAuth discovery endpoint (RFC 9728)
121-
--target-uri string URI for the target MCP server (e.g., http://localhost:8080) (required)
100+
-h, --help help for proxy
101+
--host string Host for the HTTP proxy to listen on (IP or hostname) (default "127.0.0.1")
102+
--oidc-audience string Expected audience for the token
103+
--oidc-client-id string OIDC client ID
104+
--oidc-client-secret string OIDC client secret (optional, for introspection)
105+
--oidc-introspection-url string URL for token introspection endpoint
106+
--oidc-issuer string OIDC issuer URL (e.g., https://accounts.google.com)
107+
--oidc-jwks-url string URL to fetch the JWKS from
108+
--port int Port for the HTTP proxy to listen on (host port)
109+
--remote-auth Enable OAuth/OIDC authentication to remote MCP server
110+
--remote-auth-authorize-url string OAuth authorization endpoint URL (alternative to --remote-auth-issuer for non-OIDC OAuth)
111+
--remote-auth-callback-port int Port for OAuth callback server during remote authentication (default 8666)
112+
--remote-auth-client-id string OAuth client ID for remote server authentication
113+
--remote-auth-client-secret string OAuth client secret for remote server authentication (optional for PKCE)
114+
--remote-auth-client-secret-file string Path to file containing OAuth client secret (alternative to --remote-auth-client-secret)
115+
--remote-auth-issuer string OAuth/OIDC issuer URL for remote server authentication (e.g., https://accounts.google.com)
116+
--remote-auth-scopes strings OAuth scopes to request for remote server authentication (defaults: OIDC uses 'openid,profile,email')
117+
--remote-auth-skip-browser Skip opening browser for remote server OAuth flow
118+
--remote-auth-timeout duration Timeout for OAuth authentication flow (e.g., 30s, 1m, 2m30s) (default 30s)
119+
--remote-auth-token-url string OAuth token endpoint URL (alternative to --remote-auth-issuer for non-OIDC OAuth)
120+
--resource-url string Explicit resource URL for OAuth discovery endpoint (RFC 9728)
121+
--target-uri string URI for the target MCP server (e.g., http://localhost:8080) (required)
122+
--token-exchange-audience string Target audience for exchanged tokens
123+
--token-exchange-client-id string OAuth client ID for token exchange operations
124+
--token-exchange-client-secret string OAuth client secret for token exchange operations
125+
--token-exchange-client-secret-file string Path to file containing OAuth client secret for token exchange (alternative to --token-exchange-client-secret)
126+
--token-exchange-header-name string Custom header name for injecting exchanged token (default: replaces Authorization header)
127+
--token-exchange-scopes strings Scopes to request for exchanged tokens
128+
--token-exchange-subject-token-type string Type of subject token to exchange. Accepts: access_token (default), id_token (required for Google STS)
129+
--token-exchange-url string OAuth 2.0 token exchange endpoint URL (enables token exchange when provided)
122130
```
123131

124132
### Options inherited from parent commands

0 commit comments

Comments
 (0)