Restore original references to old example dirs (revert remainder)

Author: maxisbey

README.v2.md

@@ -1058,7 +1058,7 @@ if __name__ == "__main__":
 _Full example: [examples/snippets/servers/oauth_server.py](https://github.com/modelcontextprotocol/python-sdk/blob/main/examples/snippets/servers/oauth_server.py)_
 <!-- /snippet-source -->
 
-For a complete example with separate Authorization Server and Resource Server implementations, see [`examples/stories/oauth/`](https://github.com/modelcontextprotocol/python-sdk/tree/main/examples/stories/oauth/) (and [`examples/stories/bearer_auth/`](https://github.com/modelcontextprotocol/python-sdk/tree/main/examples/stories/bearer_auth/) for static-token auth).
+For a complete example with separate Authorization Server and Resource Server implementations, see [`examples/servers/simple-auth/`](https://github.com/modelcontextprotocol/python-sdk/tree/main/examples/servers/simple-auth/).
 
 **Architecture:**
 
@@ -1343,7 +1343,10 @@ app = Starlette(
 _Full example: [examples/snippets/servers/streamable_starlette_mount.py](https://github.com/modelcontextprotocol/python-sdk/blob/main/examples/snippets/servers/streamable_starlette_mount.py)_
 <!-- /snippet-source -->
 
-For low level server with Streamable HTTP implementations, see [`examples/stories/stateless_legacy/`](https://github.com/modelcontextprotocol/python-sdk/tree/main/examples/stories/stateless_legacy/).
+For low level server with Streamable HTTP implementations, see:
+
+- Stateful server: [`examples/servers/simple-streamablehttp/`](https://github.com/modelcontextprotocol/python-sdk/tree/main/examples/servers/simple-streamablehttp/)
+- Stateless server: [`examples/servers/simple-streamablehttp-stateless/`](https://github.com/modelcontextprotocol/python-sdk/tree/main/examples/servers/simple-streamablehttp-stateless/)
 
 The streamable HTTP transport supports:
 
@@ -2097,7 +2100,7 @@ _Full example: [examples/snippets/clients/pagination_client.py](https://github.c
 - **Backward compatible** - clients that don't support pagination will still work (they'll just get the first page)
 - **Flexible page sizes** - Each endpoint can define its own page size based on data characteristics
 
-See the [pagination example](https://github.com/modelcontextprotocol/python-sdk/tree/main/examples/stories/pagination) for a complete implementation.
+See the [simple-pagination example](https://github.com/modelcontextprotocol/python-sdk/tree/main/examples/servers/simple-pagination) for a complete implementation.
 
 ### Writing MCP Clients
 
@@ -2317,7 +2320,7 @@ The SDK includes [authorization support](https://modelcontextprotocol.io/specifi
 ```python
 """Before running, specify running MCP RS server URL.
 To spin up RS server locally, see
-    examples/stories/oauth/README.md
+    examples/servers/simple-auth/README.md
 
 cd to the `examples/snippets` directory and run:
     uv run oauth-client
@@ -2412,7 +2415,7 @@ if __name__ == "__main__":
 _Full example: [examples/snippets/clients/oauth_client.py](https://github.com/modelcontextprotocol/python-sdk/blob/main/examples/snippets/clients/oauth_client.py)_
 <!-- /snippet-source -->
 
-For a complete working example, see [`examples/stories/oauth/`](https://github.com/modelcontextprotocol/python-sdk/tree/main/examples/stories/oauth/).
+For a complete working example, see [`examples/clients/simple-auth-client/`](https://github.com/modelcontextprotocol/python-sdk/tree/main/examples/clients/simple-auth-client/).
 
 ### Parsing Tool Results
 

examples/mcpserver/complex_inputs.py

@@ -1,4 +1,3 @@
-# TODO: superseded by examples/stories/schema_validators/; remove once tests/test_examples.py is migrated.
 """MCPServer Complex inputs Example
 
 Demonstrates validation via pydantic with complex models.

examples/mcpserver/desktop.py

@@ -1,4 +1,3 @@
-# TODO: superseded by examples/stories/resources/; remove once tests/test_examples.py is migrated.
 """MCPServer Desktop Example
 
 A simple example that exposes the desktop directory as a resource.

examples/mcpserver/direct_call_tool_result_return.py

@@ -1,4 +1,3 @@
-# TODO: superseded by examples/stories/tools/; remove once tests/test_examples.py is migrated.
 """MCPServer Echo Server with direct CallToolResult return"""
 
 from typing import Annotated

examples/mcpserver/simple_echo.py

@@ -1,4 +1,3 @@
-# TODO: superseded by examples/stories/tools/; remove once tests/test_examples.py is migrated.
 """MCPServer Echo Server"""
 
 from mcp.server.mcpserver import MCPServer

examples/snippets/clients/oauth_client.py

@@ -1,6 +1,6 @@
 """Before running, specify running MCP RS server URL.
 To spin up RS server locally, see
-    examples/stories/oauth/README.md
+    examples/servers/simple-auth/README.md
 
 cd to the `examples/snippets` directory and run:
     uv run oauth-client

src/mcp/server/auth/middleware/bearer_auth.py

@@ -31,8 +31,9 @@ def authorization_context(user: AuthenticatedUser) -> AuthorizationContext:
     verifier does not supply are `None`, so the comparison degrades to the
     remaining components.
 
-    See `examples/stories/bearer_auth/server.py` for a verifier that
-    populates `subject` and `client_id`."""
+    See `examples/servers/simple-auth/mcp_simple_auth/token_verifier.py` for
+    a verifier that populates `subject` and `claims` from an introspection
+    response."""
     token = user.access_token
     issuer = (token.claims or {}).get("iss")
     return AuthorizationContext(