docs(orchestrator): add 'Extending Handlers' pointers and sample recipe mixing mcp.call with traditional step

Author: jeremi

orchestrator/README.md

@@ -105,7 +105,7 @@ Recipe Format
 
 - Validated by `schemas/recipe.v1.json`.
 - Step keys supported:
-  - `uses`: `odoo | agent | git | github | tm`
+  - `uses`: `odoo | agent | git | github | tm | mcp`
   - Odoo: `tool`, `args`, `timeout_seconds`, `retries`, `on_error`, `stream_logs`
   - Agent: `goal`, `mode`, `context`
   - Git: `branch`, `commit`
@@ -160,3 +160,19 @@ Testing
 See Also
 
 - Configuration cookbook with copy‑paste snippets: `orchestrator/COOKBOOK.md`
+- Handlers design & usage: `orchestrator/docs/HANDLERS.md`
+
+Sample: mixing a traditional step with a generic MCP call
+
+```
+steps:
+  - id: tests
+    uses: odoo
+    tool: test_addons
+    args: { modules: ["my_module"], dbname: "devel" }
+  - id: note
+    uses: mcp
+    server: tm
+    tool: add_evidence
+    arguments: { id: T1, type: note, ref: "tests:ok" }
+```