Tool descriptions schema alignment

[kentcdodds]

Update MCP best practices documentation and do_math tool description to remove redundant parameter information already present in the tool's input schema.

---

 

---

Note

Low Risk
Mostly documentation/metadata changes plus a new outputSchema declaration; minimal behavioral impact but could surface schema-validation mismatches if outputs don’t conform.

Overview
Updates MCP guidance to emphasize patterns over “best practices”, and clarifies that tool descriptions should focus on non-obvious behavior/examples while inputSchema/outputSchema document parameter and structured output shapes.

Aligns the do_math tool with this guidance by trimming redundant parameter listings in its metadata description and adding an explicit outputSchema for validated structuredContent results.

^{Written by Cursor Bugbot for commit 389f273. This will update automatically on new commits. Configure here.}

[cursor]

Cursor Agent can help with this pull request. Just @cursor in comments and I'll start working on changes in this branch.
_{Learn more about Cursor Agents}

[github-actions]

🔎 Preview deployed: https://epicflare-pr-33.kentcdodds.workers.dev

Worker: epicflare-pr-33
D1: epicflare-pr-33-db
KV: epicflare-pr-33-oauth-kv

Mocks:

• resend: https://epicflare-pr-33-mock-resend.kentcdodds.workers.dev/__mocks (epicflare-pr-33-mock-resend)