Skip to main content

thv serve​

Start the ToolHive API server

Synopsis​

Starts the ToolHive API server and listen for HTTP requests.

thv serve [flags]

Options​

      --experimental-mcp                EXPERIMENTAL: Enable embedded MCP server for controlling ToolHive
      --experimental-mcp-host string    EXPERIMENTAL: Host for the embedded MCP server (default "localhost")
      --experimental-mcp-port string    EXPERIMENTAL: Port for the embedded MCP server (default "4483")
  -h, --help                            help for serve
      --host string                     Host address to bind the server to (default "127.0.0.1")
      --oidc-audience string            Expected audience for the token
      --oidc-client-id string           OIDC client ID
      --oidc-client-secret string       OIDC client secret (optional, for introspection)
      --oidc-introspection-url string   URL for token introspection endpoint
      --oidc-issuer string              OIDC issuer URL (e.g., https://accounts.google.com)
      --oidc-jwks-url string            URL to fetch the JWKS from
      --openapi                         Enable OpenAPI documentation endpoints (/api/openapi.json and /api/doc)
      --port int                        Port to bind the server to (default 8080)
      --socket string                   UNIX socket path to bind the server to (overrides host and port if provided)

Options inherited from parent commands​

      --debug   Enable debug mode

SEE ALSO​

  • thv - ToolHive (thv) is a lightweight, secure, and fast manager for MCP servers