mcp: declare output schemas + annotations on all tools (0.10.1)

roomi-fields · claude · roomi-fields · commit b51ab5bda5c9 · 2026-05-14T12:58:40.000+02:00
Every MCP tool now ships an outputSchema and annotations (title +
read-only / idempotent / open-world hints), and tool results carry
structuredContent next to the text block — clients get a typed payload
instead of prose to re-parse. Protocol version advertised at initialize
bumped to 2025-06-18, the revision that introduced these fields.

The MCPB bundle manifest mirrors the same schemas so the Smithery
listing reflects the real server surface.

Co-Authored-By: Claude &lt;noreply@anthropic.com&gt;
diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "osc-bridge",
-  "version": "0.10.0",
+  "version": "0.10.1",
   "description": "Declarative OSC ↔ MIDI/SysEx bridge for 849 hardware synthesizers and music software (Ableton, Bitwig, Reaper, Sonic Pi, SuperCollider, Pure Data). A MIDI MCP and OSC MCP — discover the device catalogue, read a device's OSC surface, and send OSC to synths and DAWs from Claude.",
   "author": {
     "name": "roomi-fields",
@@ -30,7 +30,7 @@
   "mcpServers": {
     "osc-bridge": {
       "command": "npx",
-      "args": ["-y", "@roomi-fields/osc-bridge@0.10.0", "mcp"]
+      "args": ["-y", "@roomi-fields/osc-bridge@0.10.1", "mcp"]
     }
   }
 }
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -9,6 +9,23 @@ additive minor bumps every time a new device class surfaces something
 the JSON can't yet express. Backwards-compat of existing device JSONs
 is tracked explicitly under each release.
 
+## [0.10.1] — 2026-05-14
+
+A polish release for the MCP server. No device-JSON or runtime changes.
+
+### Changed — MCP server
+- All five tools now declare an `outputSchema` and `annotations` (title +
+  read-only / idempotent / open-world hints). Tool results carry
+  `structuredContent` alongside the text block, so MCP clients get a typed,
+  machine-readable payload — not just prose to re-parse.
+- Protocol version advertised at `initialize` bumped to `2025-06-18` (the
+  revision that introduced `outputSchema` / `structuredContent`).
+
+### Compatibility
+- Device JSONs: unchanged — every `0.10.0` driver loads as-is.
+- MCP clients on the older `2025-03-26` revision still work; the text block
+  in every tool result is unchanged.
+
 ## [0.10.0] — 2026-05-14
 
 osc-bridge stops being a hardware-only tool. A new **OSC transport** lets a
diff --git a/Cargo.toml b/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "osc-bridge"
-version = "0.10.0"
+version = "0.10.1"
 edition = "2021"
 description = "Declarative OSC ↔ MIDI/SysEx bridge for hardware synthesizers"
 license = "GPL-3.0-or-later"
diff --git a/mcpb/manifest.json b/mcpb/manifest.json
@@ -2,7 +2,7 @@
   "manifest_version": "0.3",
   "name": "osc-bridge",
   "display_name": "osc-bridge",
-  "version": "0.10.0",
+  "version": "0.10.1",
   "description": "OSC ↔ MIDI/SysEx bridge for 849 synths and DAWs — a MIDI MCP and OSC MCP.",
   "long_description": "osc-bridge is a declarative bridge between OSC and the music world: 849 hardware synthesizers over MIDI/SysEx, plus music software over OSC (Ableton, Bitwig, Reaper, Sonic Pi, SuperCollider, Pure Data, TouchDesigner, VCV Rack). Its MCP server exposes the whole catalogue to an LLM — list devices, read a device's named OSC surface, send OSC to synths and DAWs, and check a running bridge's status. Both a MIDI MCP (hardware over MIDI/SysEx) and an OSC MCP (DAWs and live-coding environments).",
   "author": {
@@ -60,7 +60,31 @@
     {
       "name": "list_devices",
       "description": "Enumerate every device driver — name, vendor, slug, kind (hardware/software), and source tier. Use this first to discover the catalogue.",
-      "inputSchema": { "type": "object", "properties": {} }
+      "inputSchema": { "type": "object", "properties": {} },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "count": { "type": "integer", "description": "Number of device drivers found." },
+          "devices": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "name": { "type": "string" },
+                "vendor": { "type": "string" },
+                "slug": { "type": "string", "description": "OSC prefix without the leading slash." },
+                "kind": { "type": "string", "description": "'hardware' or 'software'." },
+                "revision": { "type": "string" },
+                "source_tier": { "type": "string" },
+                "file": { "type": "string" }
+              },
+              "required": ["name", "vendor", "slug", "kind"]
+            }
+          }
+        },
+        "required": ["count", "devices"]
+      },
+      "annotations": { "title": "List devices", "readOnlyHint": true, "idempotentHint": true, "openWorldHint": false }
     },
     {
       "name": "get_device_docs",
@@ -69,7 +93,17 @@
         "type": "object",
         "properties": { "slug": { "type": "string", "description": "Device slug, e.g. 'ableton' or 'minilab3'" } },
         "required": ["slug"]
-      }
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "slug": { "type": "string" },
+          "has_docs": { "type": "boolean", "description": "False when no companion .md exists for the device." },
+          "markdown": { "type": "string", "description": "The companion documentation, or a not-found message when has_docs is false." }
+        },
+        "required": ["slug", "has_docs", "markdown"]
+      },
+      "annotations": { "title": "Get device docs", "readOnlyHint": true, "idempotentHint": true, "openWorldHint": false }
     },
     {
       "name": "list_routes",
@@ -78,7 +112,22 @@
         "type": "object",
         "properties": { "slug": { "type": "string", "description": "Device slug, e.g. 'minilab3'" } },
         "required": ["slug"]
-      }
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "device": { "type": "string" },
+          "vendor": { "type": "string" },
+          "osc_prefix": { "type": "string" },
+          "kind": { "type": "string" },
+          "commands": { "type": "array", "description": "Declarative OSC paths the device accepts, with typed args and mode.", "items": { "type": "object" } },
+          "cc_params": { "type": "array", "description": "CC / NRPN parameters, each mapped to an OSC address.", "items": { "type": "object" } },
+          "params": { "type": "array", "description": "SysEx parameters, each mapped to an OSC address.", "items": { "type": "object" } },
+          "replies": { "type": "array", "description": "Reply patterns the device emits back onto the OSC surface.", "items": { "type": "object" } }
+        },
+        "required": ["device", "osc_prefix", "commands", "cc_params", "params", "replies"]
+      },
+      "annotations": { "title": "List device routes", "readOnlyHint": true, "idempotentHint": true, "openWorldHint": false }
     },
     {
       "name": "send",
@@ -91,15 +140,43 @@
           "target": { "type": "string", "description": "Optional host:port override" }
         },
         "required": ["addr"]
-      }
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "sent": { "type": "boolean" },
+          "address": { "type": "string" },
+          "bytes": { "type": "integer", "description": "Encoded OSC packet size." },
+          "target": { "type": "string", "description": "host:port the packet was sent to." }
+        },
+        "required": ["sent", "address", "bytes", "target"]
+      },
+      "annotations": { "title": "Send OSC message", "readOnlyHint": false, "destructiveHint": false, "idempotentHint": false, "openWorldHint": true }
     },
     {
       "name": "get_status",
       "description": "Send /bridge/status to a running osc-bridge and report the replies received within 500 ms.",
       "inputSchema": {
         "type": "object",
         "properties": { "target": { "type": "string", "description": "host:port to query, defaults to the configured default target" } }
-      }
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "target": { "type": "string" },
+          "replied": { "type": "boolean", "description": "False when no reply arrived within 500 ms." },
+          "replies": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": { "addr": { "type": "string" }, "args": { "type": "array" } },
+              "required": ["addr", "args"]
+            }
+          }
+        },
+        "required": ["target", "replied", "replies"]
+      },
+      "annotations": { "title": "Get bridge status", "readOnlyHint": true, "idempotentHint": true, "openWorldHint": true }
     }
   ]
 }
diff --git a/npm/package.json b/npm/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@roomi-fields/osc-bridge",
-  "version": "0.10.0",
+  "version": "0.10.1",
   "mcpName": "io.github.roomi-fields/osc-bridge",
   "description": "Declarative OSC bridge for music hardware and software — 849 synthesizer drivers (MIDI/SysEx) plus DAW & live-coding targets (Ableton, Bitwig, Reaper, Sonic Pi, SuperCollider). Ships an MCP server: a MIDI MCP and OSC MCP for controlling synths and DAWs from Claude.",
   "keywords": [
diff --git a/server.json b/server.json
@@ -7,12 +7,12 @@
     "url": "https://github.com/roomi-fields/osc-bridge",
     "source": "github"
   },
-  "version": "0.10.0",
+  "version": "0.10.1",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@roomi-fields/osc-bridge",
-      "version": "0.10.0",
+      "version": "0.10.1",
       "transport": {
         "type": "stdio"
       },
diff --git a/src/mcp.rs b/src/mcp.rs

Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,7 @@`
`1`	`1`	`{`
`2`	`2`	`"$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",`
`3`	`3`	`"name": "osc-bridge",`
`4`		`- "version": "0.10.0",`
	`4`	`+ "version": "0.10.1",`
`5`	`5`	`"description": "Declarative OSC ↔ MIDI/SysEx bridge for 849 hardware synthesizers and music software (Ableton, Bitwig, Reaper, Sonic Pi, SuperCollider, Pure Data). A MIDI MCP and OSC MCP — discover the device catalogue, read a device's OSC surface, and send OSC to synths and DAWs from Claude.",`
`6`	`6`	`"author": {`
`7`	`7`	`"name": "roomi-fields",`
`@@ -30,7 +30,7 @@`
`30`	`30`	`"mcpServers": {`
`31`	`31`	`"osc-bridge": {`
`32`	`32`	`"command": "npx",`
`33`		`- "args": ["-y", "@roomi-fields/osc-bridge@0.10.0", "mcp"]`
	`33`	`+ "args": ["-y", "@roomi-fields/osc-bridge@0.10.1", "mcp"]`
`34`	`34`	`}`
`35`	`35`	`}`
`36`	`36`	`}`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@roomi-fields/osc-bridge",`
`3`		`- "version": "0.10.0",`
	`3`	`+ "version": "0.10.1",`
`4`	`4`	`"mcpName": "io.github.roomi-fields/osc-bridge",`
`5`	`5`	`"description": "Declarative OSC bridge for music hardware and software — 849 synthesizer drivers (MIDI/SysEx) plus DAW & live-coding targets (Ableton, Bitwig, Reaper, Sonic Pi, SuperCollider). Ships an MCP server: a MIDI MCP and OSC MCP for controlling synths and DAWs from Claude.",`
`6`	`6`	`"keywords": [`