Update the default proxy mode for stdio servers (#279)

Signed-off-by: Dan Barr <[email protected]>
Co-authored-by: Dan Barr <[email protected]>
Co-authored-by: Copilot <[email protected]>

Author: danbarr

docs/toolhive/guides-cli/client-configuration.mdx

@@ -115,13 +115,13 @@ thv list
 Example output (some fields omitted for brevity):
 
 ```text
-NAME     PACKAGE                                      STATUS    URL                                 PORT
-github   ghcr.io/github/github-mcp-server:latest      running   http://127.0.0.1:55264/sse#github   55264
-osv      ghcr.io/stackloklabs/osv-mcp/server:latest   running   http://127.0.0.1:22089/mcp          22089
+NAME     PACKAGE                                         STATUS    URL                                 PORT
+github   ghcr.io/github/github-mcp-server:latest         running   http://127.0.0.1:55264/mcp          55264
+sqlite   ghcr.io/stackloklabs/sqlite-mcp/server:latest   running   http://127.0.0.1:22089/sse#sqlite   22089
 ```
 
-In this example, the `github` server uses the SSE transport (URL ends in
-`/sse`), and the `osv` server uses Streamable HTTP (URL ends in `/mcp`).
+In this example, the `github` server uses the Streamable HTTP transport (URL
+ends in `/mcp`), and the `sqlite` server uses SSE (URL ends in `/sse`).
 
 You can also get the list in JSON format, which works with many clients that use
 the standard configuration format:
@@ -136,10 +136,10 @@ Example output:
 {
   "mcpServers": {
     "github": {
-      "url": "http://127.0.0.1:55264/sse#github"
+      "url": "http://127.0.0.1:55264/mcp"
     },
-    "osv": {
-      "url": "http://127.0.0.1:22089/mcp"
+    "sqlite": {
+      "url": "http://127.0.0.1:22089/sse#sqlite"
     }
   }
 }

docs/toolhive/guides-cli/run-mcp-servers.mdx

@@ -365,15 +365,12 @@ ToolHive supports the following transport methods:
 
 :::info
 
-We are actively monitoring the adoption of the Streamable HTTP protocol across
-the client ecosystem. Once we confirm that ToolHive's supported clients support
-Streamable HTTP, we will make it the default proxy transport method for stdio
-servers.
-
-Currently, you can add the `--proxy-mode streamable-http` flag to the
-[`thv run`](../reference/cli/thv_run.md) command to use Streamable HTTP for
-stdio servers. This will ensure that the server is compatible with the latest
-MCP specification and can be used with clients that support Streamable HTTP.
+As of ToolHive CLI version 0.6.0, the default proxy mode for `stdio` MCP servers
+is `streamable-http`.
+
+For backward compatibility with the deprecated SSE transport, you can explicitly
+set the transport to `sse` using the `--proxy-mode sse` flag when running the
+server.
 
 :::
 

docs/toolhive/reference/client-compatibility.mdx

@@ -105,9 +105,9 @@ Example configuration:
 ```json
 {
   "servers": {
-    "github": { "url": "http://localhost:19046/sse#github", "type": "sse" },
+    "github": { "url": "http://localhost:19046/mcp", "type": "http" },
     "fetch": { "url": "http://localhost:43832/mcp", "type": "http" },
-    "osv": { "url": "http://localhost:51712/mcp", "type": "http" }
+    "sqlite": { "url": "http://localhost:51712/sse#sqlite", "type": "sse" }
   }
 }
 ```
@@ -129,9 +129,9 @@ Example configuration:
 ```json
 {
   "mcpServers": {
-    "github": { "url": "http://localhost:19046/sse#github" },
+    "github": { "url": "http://localhost:19046/mcp" },
     "fetch": { "url": "http://localhost:43832/mcp" },
-    "osv": { "url": "http://localhost:51712/mcp" }
+    "sqlite": { "url": "http://localhost:51712/sse#sqlite" }
   }
 }
 ```
@@ -157,9 +157,9 @@ Example configuration:
   // Other Claude Code settings...
 
   "mcpServers": {
-    "github": { "url": "http://localhost:19046/sse#github", "type": "sse" },
+    "github": { "url": "http://localhost:19046/mcp", "type": "http" },
     "fetch": { "url": "http://localhost:43832/mcp", "type": "http" },
-    "osv": { "url": "http://localhost:51712/mcp", "type": "http" }
+    "sqlite": { "url": "http://localhost:51712/sse#sqlite", "type": "sse" }
   }
 }
 ```
@@ -199,9 +199,12 @@ Example configuration:
 ```json
 {
   "mcpServers": {
-    "github": { "url": "http://localhost:19046/sse#github", "type": "sse" },
+    "github": {
+      "url": "http://localhost:19046/mcp",
+      "type": "streamable-http"
+    },
     "fetch": { "url": "http://localhost:43832/mcp", "type": "streamable-http" },
-    "osv": { "url": "http://localhost:51712/mcp", "type": "streamable-http" }
+    "sqlite": { "url": "http://localhost:51712/sse#sqlite", "type": "sse" }
     // Note: Cline uses "streamableHttp" instead of "streamable-http"
   }
 }
@@ -226,11 +229,14 @@ Example configuration:
 ```yaml
 mcpServers:
   - name: github
-    type: sse
-    url: http://localhost:19046/sse#github
+    type: streamable-http
+    url: http://localhost:19046/mcp
   - name: fetch
     type: streamable-http
     url: http://localhost:43832/mcp
+  - name: sqlite
+    type: sse
+    url: http://localhost:51712/sse#sqlite
 ```
 
 Continue supports SSE (`type: sse`) and Streamable HTTP
@@ -254,11 +260,11 @@ For [PydanticAI](https://ai.pydantic.dev/), set the MCP server URL in your code:
 from pydantic_ai.mcp import MCPServerSSE
 from pydantic_ai.mcp import MCPServerStreamableHTTP
 
-# For Server-Sent Events (SSE)
-server = MCPServerSSE(url='http://localhost:43832/sse#github')
-
 # For Streamable HTTP
-server = MCPServerStreamableHTTP(url='http://localhost:51712/mcp')
+server = MCPServerStreamableHTTP(url='http://localhost:43832/mcp')
+
+# For Server-Sent Events (SSE)
+server = MCPServerSSE(url='http://localhost:51712/sse#sqlite')
 ```
 
 ### Example: Copilot for JetBrains IDEs
@@ -271,8 +277,8 @@ to include the MCP server URL:
 ```json
 {
   "servers": {
-    "github": { "url": "http://localhost:43832/sse#github", "type": "sse" },
-    "fetch": { "url": "http://localhost:51712/mcp", "type": "http" }
+    "github": { "url": "http://localhost:43832/mcp", "type": "http" },
+    "sqlite": { "url": "http://localhost:51712/sse#sqlite", "type": "sse" }
   }
 }
 ```

docs/toolhive/tutorials/quickstart-cli.mdx

@@ -229,11 +229,11 @@ thv list
 You should see output similar to this:
 
 ```text
-NAME    PACKAGE                                      STATUS    URL                                PORT    TOOL TYPE   CREATED AT
-fetch   ghcr.io/stackloklabs/gofetch/server:latest   running   http://127.0.0.1:15266/sse#fetch   15266   mcp         2025-07-10 08:41:56 -0400 EDT
+NAME    PACKAGE                                      STATUS    URL                          PORT    TOOL TYPE   CREATED AT
+fetch   ghcr.io/stackloklabs/gofetch/server:latest   running   http://127.0.0.1:15266/mcp   15266   mcp         2025-07-10 08:41:56 -0400 EDT
 ```
 
-This confirms that the fetch server is running and available on port 49226.
+This confirms that the fetch server is running and available on port 15266.
 
 :::info[What's happening?]