Address feedback: remove stateless_http, keep json_response

Remove stateless_http=True from examples to avoid going "all-in" on
stateless before it's properly documented in the MCP spec. Keep
json_response=True for client compatibility.

Changes:
- Remove stateless_http from quickstart and other examples
- Keep json_response=True as recommended option
- Update note to focus on JSON compatibility vs scalability
- Reorder streamable_config.py to show recommended option first

Author: domdomegg

README.md

@@ -139,7 +139,7 @@ Run from the repository root:
 from mcp.server.fastmcp import FastMCP
 
 # Create an MCP server
-mcp = FastMCP("Demo", stateless_http=True, json_response=True)
+mcp = FastMCP("Demo", json_response=True)
 
 
 # Add an addition tool
@@ -901,7 +901,6 @@ class SimpleTokenVerifier(TokenVerifier):
 # Create FastMCP instance as a Resource Server
 mcp = FastMCP(
     "Weather Service",
-    stateless_http=True,
     json_response=True,
     # Token verifier for authentication
     token_verifier=SimpleTokenVerifier(),
@@ -1118,7 +1117,7 @@ Note that `uv run mcp run` or `uv run mcp dev` only supports server using FastMC
 
 ### Streamable HTTP Transport
 
-> **Note**: Streamable HTTP transport is the recommended transport for production deployments. Use `stateless_http=True` and `json_response=True` for optimal scalability.
+> **Note**: Streamable HTTP transport is the recommended transport for production deployments. Consider using `json_response=True` for compatibility with clients that prefer JSON over SSE.
 
 <!-- snippet-source examples/snippets/servers/streamable_config.py -->
 ```python
@@ -1129,11 +1128,11 @@ Run from the repository root:
 
 from mcp.server.fastmcp import FastMCP
 
-# Stateless server with JSON responses (recommended)
-mcp = FastMCP("StatelessServer", stateless_http=True, json_response=True)
+# With JSON responses instead of SSE (recommended for compatibility)
+mcp = FastMCP("Server", json_response=True)
 
 # Other configuration options:
-# Stateless server with SSE streaming responses
+# Stateless server (no session persistence)
 # mcp = FastMCP("StatelessServer", stateless_http=True)
 
 # Stateful server with session persistence
@@ -1283,7 +1282,7 @@ from starlette.routing import Mount
 from mcp.server.fastmcp import FastMCP
 
 # Create MCP server
-mcp = FastMCP("My App", stateless_http=True, json_response=True)
+mcp = FastMCP("My App", json_response=True)
 
 
 @mcp.tool()
@@ -1320,7 +1319,7 @@ from starlette.routing import Host
 from mcp.server.fastmcp import FastMCP
 
 # Create MCP server
-mcp = FastMCP("MCP Host App", stateless_http=True, json_response=True)
+mcp = FastMCP("MCP Host App", json_response=True)
 
 
 @mcp.tool()
@@ -1357,8 +1356,8 @@ from starlette.routing import Mount
 from mcp.server.fastmcp import FastMCP
 
 # Create multiple MCP servers
-api_mcp = FastMCP("API Server", stateless_http=True, json_response=True)
-chat_mcp = FastMCP("Chat Server", stateless_http=True, json_response=True)
+api_mcp = FastMCP("API Server", json_response=True)
+chat_mcp = FastMCP("Chat Server", json_response=True)
 
 
 @api_mcp.tool()
@@ -1410,7 +1409,6 @@ from mcp.server.fastmcp import FastMCP
 # This server will mount at the root of wherever it's mounted
 mcp_at_root = FastMCP(
     "My Server",
-    stateless_http=True,
     json_response=True,
     streamable_http_path="/",
 )

docs/index.md

@@ -17,7 +17,7 @@ Here's a simple MCP server that exposes a tool, resource, and prompt:
 ```python title="server.py"
 from mcp.server.fastmcp import FastMCP
 
-mcp = FastMCP("Test Server", stateless_http=True, json_response=True)
+mcp = FastMCP("Test Server", json_response=True)
 
 
 @mcp.tool()

examples/snippets/servers/fastmcp_quickstart.py

@@ -8,7 +8,7 @@
 from mcp.server.fastmcp import FastMCP
 
 # Create an MCP server
-mcp = FastMCP("Demo", stateless_http=True, json_response=True)
+mcp = FastMCP("Demo", json_response=True)
 
 
 # Add an addition tool

examples/snippets/servers/oauth_server.py

@@ -20,7 +20,6 @@ async def verify_token(self, token: str) -> AccessToken | None:
 # Create FastMCP instance as a Resource Server
 mcp = FastMCP(
     "Weather Service",
-    stateless_http=True,
     json_response=True,
     # Token verifier for authentication
     token_verifier=SimpleTokenVerifier(),

examples/snippets/servers/streamable_config.py

@@ -5,11 +5,11 @@
 
 from mcp.server.fastmcp import FastMCP
 
-# Stateless server with JSON responses (recommended)
-mcp = FastMCP("StatelessServer", stateless_http=True, json_response=True)
+# With JSON responses instead of SSE (recommended for compatibility)
+mcp = FastMCP("Server", json_response=True)
 
 # Other configuration options:
-# Stateless server with SSE streaming responses
+# Stateless server (no session persistence)
 # mcp = FastMCP("StatelessServer", stateless_http=True)
 
 # Stateful server with session persistence

examples/snippets/servers/streamable_http_basic_mounting.py

@@ -11,7 +11,7 @@
 from mcp.server.fastmcp import FastMCP
 
 # Create MCP server
-mcp = FastMCP("My App", stateless_http=True, json_response=True)
+mcp = FastMCP("My App", json_response=True)
 
 
 @mcp.tool()

examples/snippets/servers/streamable_http_host_mounting.py

@@ -11,7 +11,7 @@
 from mcp.server.fastmcp import FastMCP
 
 # Create MCP server
-mcp = FastMCP("MCP Host App", stateless_http=True, json_response=True)
+mcp = FastMCP("MCP Host App", json_response=True)
 
 
 @mcp.tool()

examples/snippets/servers/streamable_http_multiple_servers.py

@@ -11,8 +11,8 @@
 from mcp.server.fastmcp import FastMCP
 
 # Create multiple MCP servers
-api_mcp = FastMCP("API Server", stateless_http=True, json_response=True)
-chat_mcp = FastMCP("Chat Server", stateless_http=True, json_response=True)
+api_mcp = FastMCP("API Server", json_response=True)
+chat_mcp = FastMCP("Chat Server", json_response=True)
 
 
 @api_mcp.tool()

examples/snippets/servers/streamable_http_path_config.py

@@ -14,7 +14,6 @@
 # This server will mount at the root of wherever it's mounted
 mcp_at_root = FastMCP(
     "My Server",
-    stateless_http=True,
     json_response=True,
     streamable_http_path="/",
 )