Skip to content

Commit a0bc973

Browse files
committed
improve instructions
1 parent 1f2a287 commit a0bc973

File tree

1 file changed

+3
-3
lines changed

1 file changed

+3
-3
lines changed

exercises/01.advanced-tools/README.mdx

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -76,7 +76,7 @@ Clients can use annotations to:
7676
invocation.
7777
</callout-success>
7878

79-
### Best Practices
79+
### Recommended Practices
8080

8181
1. **Be accurate about side effects:** Mark tools as `readOnlyHint: true` only if they never modify state.
8282
2. **Use descriptive titles:** The `title` annotation should be clear and human-friendly.
@@ -224,10 +224,10 @@ sequenceDiagram
224224
end
225225
```
226226

227-
### Best Practices
227+
### Recommended Practices
228228

229229
1. **Define clear output schemas:** Use JSON Schema to describe all possible fields and types.
230230
2. **Validate on the server:** Always validate tool output before returning to the client (the SDK does this for us).
231231
3. **Handle validation errors gracefully:** Inform users or clients when output does not match the schema (the SDK does this for us).
232232

233-
For more details, see the [official MCP documentation on structured content and output schemas](https://modelcontextprotocol.io/specification/2025-06-18/server/tools#structured-content).
233+
For more details, see the 📜 [official MCP documentation on structured content and output schemas](https://modelcontextprotocol.io/specification/2025-06-18/server/tools#structured-content).

0 commit comments

Comments
 (0)