Remove structuredContent references from tool descriptions

Co-authored-by: Kent C. Dodds <me+github@kentcdodds.com>

Author: cursoragent

docs/mcp-server-patterns.md

@@ -68,7 +68,7 @@ Include:
 1. **What the tool does** (1-2 sentences)
 2. **Behavior & gotchas** - semantics that aren't obvious from types alone
    (cross-field rules, default meaning, side effects)
-3. **Outputs & return semantics** - what `structuredContent` means and how to
+3. **Outputs & return semantics** - what the structured result means and how to
    use it (the _shape_ lives in `outputSchema`)
 4. **Errors & recovery** - common failure modes and what to do next
 5. **Examples** - concrete, copy/pasteable payloads

mcp/server-metadata.ts

@@ -8,10 +8,10 @@ export const serverMetadata = {
 	instructions: `
 Quick start
 - Use 'do_math' to compute a single arithmetic operation on two numbers.
-- Tools return both human-readable markdown in 'content' and machine-friendly data in 'structuredContent'.
+- Tools return both a human-readable message and a machine-readable result.
 
 Default behavior
-- 'do_math.precision' controls ONLY the human-readable formatting. 'structuredContent.result' is not rounded.
+- 'do_math.precision' controls ONLY display formatting; it does not change the computed value.
 - Division by zero is rejected with an actionable error message.
 
 How to chain tools safely
@@ -38,16 +38,12 @@ export const toolsMetadata = {
 Compute a single arithmetic operation over two numbers.
 
 Behavior:
-- Division by zero is rejected and includes a stable error code in 'structuredContent.error'.
-- 'precision' affects ONLY the markdown output in 'content'; 'structuredContent.result' is not rounded.
+- Division by zero is rejected.
+- 'precision' affects ONLY display formatting; it does not change the computed numeric result.
 
 Examples:
 - "Add 8 and 4" → { left: 8, operator: "+", right: 4 }
 - "Divide 1 by 3 with 3 decimals" → { left: 1, operator: "/", right: 3, precision: 3 }
-
-Next:
-- Use 'structuredContent.result' if you need a machine-friendly number.
-- If you need to present the result to a user, use the markdown text in 'content'.
 		`.trim(),
 		annotations: readOnlyToolAnnotations,
 	},

mcp/tools.ts

@@ -46,7 +46,7 @@ export async function registerTools(agent: MCP) {
 					.optional()
 					.default(6)
 					.describe(
-						'Decimal places used ONLY for the markdown output (0-15, default: 6). Does not round structuredContent.result.',
+						'Decimal places used ONLY for the markdown output (0-15, default: 6). Does not change the computed numeric result.',
 					),
 			},
 			outputSchema: {