docs: quote the tools/list schemas exactly as the SDK sends them

Three JSON blocks introduced as the schema the SDK sends (two in
tools.md, one in context.md) omitted the root "title" key the SDK
emits, and one also dropped "type": "object". They now match the
output byte for byte, the tutorial002 schema is pinned by a full
snapshot like its siblings, and a survey of every schema block in the
book found no other trimmed quote.

Author: maxisbey

docs/tutorial/context.md

@@ -32,7 +32,8 @@ This is the part to internalise. Here is the input schema `tools/list` reports f
   "properties": {
     "query": {"title": "Query", "type": "string"}
   },
-  "required": ["query"]
+  "required": ["query"],
+  "title": "search_booksArguments"
 }
 ```
 

docs/tutorial/tools.md

@@ -27,11 +27,12 @@ From those type hints the SDK generates a JSON Schema and sends it to the client
     "query": {"title": "Query", "type": "string"},
     "limit": {"title": "Limit", "type": "integer"}
   },
-  "required": ["query", "limit"]
+  "required": ["query", "limit"],
+  "title": "search_booksArguments"
 }
 ```
 
-Both arguments are in `required` because neither has a default. You'll fix that in a moment.
+Both arguments are in `required` because neither has a default. You'll fix that in a moment. (The `title` keys are Pydantic artifacts; the properties, their types, and `required` are the contract.)
 
 !!! tip
     Type hints aren't documentation here. They are **the contract**. If a client sends `"limit": "ten"`,
@@ -74,11 +75,13 @@ The schema follows:
 
 ```json
 {
+  "type": "object",
   "properties": {
     "query": {"title": "Query", "type": "string"},
     "limit": {"default": 10, "title": "Limit", "type": "integer"}
   },
-  "required": ["query"]
+  "required": ["query"],
+  "title": "search_booksArguments"
 }
 ```
 

tests/docs_src/test_tools.py

@@ -40,11 +40,23 @@ async def test_call_returns_text_and_structured_content() -> None:
 
 
 async def test_default_value_makes_the_argument_optional() -> None:
-    """tutorial002: a plain Python default drops the argument from `required` and lands in the schema."""
+    """tutorial002: a plain Python default drops the argument from `required` and lands in the schema.
+
+    The whole schema is pinned because the page quotes it verbatim.
+    """
     async with Client(tutorial002.mcp) as client:
         (tool,) = (await client.list_tools()).tools
-        assert tool.input_schema["required"] == ["query"]
-        assert tool.input_schema["properties"]["limit"] == {"default": 10, "title": "Limit", "type": "integer"}
+        assert tool.input_schema == snapshot(
+            {
+                "type": "object",
+                "properties": {
+                    "query": {"title": "Query", "type": "string"},
+                    "limit": {"default": 10, "title": "Limit", "type": "integer"},
+                },
+                "required": ["query"],
+                "title": "search_booksArguments",
+            }
+        )
         result = await client.call_tool("search_books", {"query": "dune"})
         assert result.structured_content == {"result": "Found 3 books matching 'dune' (showing up to 10)."}