release: 12.2.0 (#596)

* chore: upload dxt file as release asset

* fix(build): bump node version in CI build to 20 to be compatible with MCP package

* chore(internal): version bump

* chore: make some internal functions async

* feat(mcp): support filtering tool results by a jq expression

* fix(mcp): relax input type for asTextContextResult

* docs: clarify that additional audio tracks may be removed (#357)

* fix: Fix incorrect deprecated message in live streaming playback policies (#358)

* feat: clean up environment call outs

* fix(mcp): support jq filtering on cloudflare workers

* chore(mcp): rework imports in tools

* chore(mcp): formatting

* chore(api): build cloudflare worker mcp server

* release: 12.2.0

---------

Co-authored-by: Tomer Aberbach <[email protected]>
Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

Author: stainless-app[bot]

.github/workflows/publish-npm.yml

@@ -39,3 +39,11 @@ jobs:
           yarn tsn scripts/publish-packages.ts "{ \"paths_released\": \"$PATHS_RELEASED\" }"
         env:
           NPM_TOKEN: ${{ secrets.MUX_NPM_TOKEN || secrets.NPM_TOKEN }}
+
+      - name: Upload DXT file to release
+        if: github.event_name == 'release'
+        run: |
+          gh release upload ${{ github.event.release.tag_name }} \
+            packages/mcp-server/dxt/mux.dxt#mux-mcp.dxt
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "12.1.0"
+  ".": "12.2.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 106
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/mux%2Fmux-d4d7fca3b738848f0ecb2658b7a8ee82f51886dae8014266671954b980f5fdac.yml
-openapi_spec_hash: 0db43f6551ec879686631abbc738c9b4
-config_hash: 82eb9b770c0e6a5db21fab2794a26a69
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/mux%2Fmux-211713a01eb052da5f6732bba658d2436bf866412bfa310c690d8983f267cbbc.yml
+openapi_spec_hash: ad58459421d76cb976989951c6656816
+config_hash: 2093578740c6c695af8b0a84e6deebb0

CHANGELOG.md

@@ -1,5 +1,37 @@
 # Changelog
 
+## 12.2.0 (2025-07-16)
+
+Full Changelog: [v12.1.0...v12.2.0](https://github.com/muxinc/mux-node-sdk/compare/v12.1.0...v12.2.0)
+
+### Features
+
+* clean up environment call outs ([b6bd416](https://github.com/muxinc/mux-node-sdk/commit/b6bd416af78cd2010189e26c5b24ac188d6b5f51))
+* **mcp:** support filtering tool results by a jq expression ([24ee59b](https://github.com/muxinc/mux-node-sdk/commit/24ee59be71cae71c8d570df1f0c0b77d505d567d))
+
+
+### Bug Fixes
+
+* **build:** bump node version in CI build to 20 to be compatible with MCP package ([31a0909](https://github.com/muxinc/mux-node-sdk/commit/31a09098aa083c0e4dc8c320d5459331351bd5ea))
+* Fix incorrect deprecated message in live streaming playback policies ([#358](https://github.com/muxinc/mux-node-sdk/issues/358)) ([4fe35bb](https://github.com/muxinc/mux-node-sdk/commit/4fe35bb6af229f6d2a046ec2778830e0c72b618c))
+* **mcp:** relax input type for asTextContextResult ([b6e7352](https://github.com/muxinc/mux-node-sdk/commit/b6e7352dbab0f99ccf7484a7b1701aea52b7e846))
+* **mcp:** support jq filtering on cloudflare workers ([2bd8dc6](https://github.com/muxinc/mux-node-sdk/commit/2bd8dc658156a31a6082dcb82614a8b63889c1eb))
+
+
+### Chores
+
+* **api:** build cloudflare worker mcp server ([69e6f8c](https://github.com/muxinc/mux-node-sdk/commit/69e6f8c0395b58faab0bd0142764b514e3ea10bb))
+* **internal:** version bump ([e312932](https://github.com/muxinc/mux-node-sdk/commit/e312932665b6e64bddd158cb417a8ef08e66b7d8))
+* make some internal functions async ([4e78a17](https://github.com/muxinc/mux-node-sdk/commit/4e78a1788fe1da9a98ef75fa0693ae74df1ce369))
+* **mcp:** formatting ([4844bf6](https://github.com/muxinc/mux-node-sdk/commit/4844bf69e84b4c7bfc7fdbfef3ff63bd963981b1))
+* **mcp:** rework imports in tools ([4ee527f](https://github.com/muxinc/mux-node-sdk/commit/4ee527f9c107b94c0b74962a500c7f86c25aeb1f))
+* upload dxt file as release asset ([86c5ad1](https://github.com/muxinc/mux-node-sdk/commit/86c5ad16f7b749a3cd6cb9132f955241f9697f0e))
+
+
+### Documentation
+
+* clarify that additional audio tracks may be removed ([#357](https://github.com/muxinc/mux-node-sdk/issues/357)) ([8577e42](https://github.com/muxinc/mux-node-sdk/commit/8577e42a3f1b7f9d2307be6151c83d9fae57a56c))
+
 ## 12.1.0 (2025-07-03)
 
 Full Changelog: [v12.0.1...v12.1.0](https://github.com/muxinc/mux-node-sdk/compare/v12.0.1...v12.1.0)

README.md

@@ -23,7 +23,10 @@ The full API of this library can be found in [api.md](api.md).
 ```js
 import Mux from '@mux/mux-node';
 
-const client = new Mux();
+const client = new Mux({
+  tokenId: process.env['MUX_TOKEN_ID'], // This is the default and can be omitted
+  tokenSecret: process.env['MUX_TOKEN_SECRET'], // This is the default and can be omitted
+});
 
 const asset = await client.video.assets.create({
   inputs: [{ url: 'https://storage.googleapis.com/muxdemofiles/mux-video-intro.mp4' }],
@@ -41,7 +44,10 @@ This library includes TypeScript definitions for all request params and response
 ```ts
 import Mux from '@mux/mux-node';
 
-const client = new Mux();
+const client = new Mux({
+  tokenId: process.env['MUX_TOKEN_ID'], // This is the default and can be omitted
+  tokenSecret: process.env['MUX_TOKEN_SECRET'], // This is the default and can be omitted
+});
 
 const params: Mux.Video.AssetCreateParams = {
   inputs: [{ url: 'https://storage.googleapis.com/muxdemofiles/mux-video-intro.mp4' }],

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mux/mux-node",
-  "version": "12.1.0",
+  "version": "12.2.0",
   "description": "The official TypeScript library for the Mux API",
   "author": "Mux <[email protected]>",
   "types": "dist/index.d.ts",

packages/mcp-server/README.md

@@ -169,7 +169,7 @@ The following tools are available in this MCP server.
 - `create_track_video_assets` (`write`): Adds an asset track (for example, subtitles, or an alternate audio track) to an asset. Assets must be in the `ready` state before tracks can be added.
 - `delete_playback_id_video_assets` (`write`): Deletes a playback ID, rendering it nonfunctional for viewing an asset's video content. Please note that deleting the playback ID removes access to the underlying asset; a viewer who started playback before the playback ID was deleted may be able to watch the entire video for a limited duration.
 - `delete_static_rendition_video_assets` (`write`): Deletes a single static rendition for an asset
-- `delete_track_video_assets` (`write`): Removes a text track from an asset. Audio and video tracks on assets cannot be removed.
+- `delete_track_video_assets` (`write`): Removes a text or additional audio track from an asset. Neither video nor the primary audio track can be removed.
 - `generate_subtitles_video_assets` (`write`): Generates subtitles (captions) for a given audio track. This API can be used for up to 7 days after an asset is created.
 - `retrieve_input_info_video_assets` (`read`): Returns a list of the input objects that were used to create the asset along with any settings that were applied to each input.
 - `retrieve_playback_id_video_assets` (`read`): Retrieves information about the specified playback ID.

packages/mcp-server/cloudflare-worker/.gitignore

@@ -0,0 +1,178 @@
+node_modules
+
+.nx
+.idea
+.vscode
+.zed
+# Logs
+
+logs
+_.log
+npm-debug.log_
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+.pnpm-debug.log*
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+
+report.[0-9]_.[0-9]_.[0-9]_.[0-9]_.json
+
+# Runtime data
+
+pids
+_.pid
+_.seed
+\*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+
+lib-cov
+
+# Coverage directory used by tools like istanbul
+
+coverage
+\*.lcov
+
+# nyc test coverage
+
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+
+bower_components
+
+# node-waf configuration
+
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+
+build/Release
+
+# Dependency directories
+
+node_modules/
+jspm_packages/
+
+# Snowpack dependency directory (https://snowpack.dev/)
+
+web_modules/
+
+# TypeScript cache
+
+\*.tsbuildinfo
+
+# Optional npm cache directory
+
+.npm
+
+# Optional eslint cache
+
+.eslintcache
+
+# Optional stylelint cache
+
+.stylelintcache
+
+# Microbundle cache
+
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+
+.node_repl_history
+
+# Output of 'npm pack'
+
+\*.tgz
+
+# Yarn Integrity file
+
+.yarn-integrity
+
+# dotenv environment variable files
+
+.env
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
+
+# parcel-bundler cache (https://parceljs.org/)
+
+.cache
+.parcel-cache
+
+# Next.js build output
+
+.next
+out
+
+# Nuxt.js build / generate output
+
+.nuxt
+dist
+
+# Gatsby files
+
+.cache/
+
+# Comment in the public line in if your project uses Gatsby and not Next.js
+
+# https://nextjs.org/blog/next-9-1#public-directory-support
+
+# public
+
+# vuepress build output
+
+.vuepress/dist
+
+# vuepress v2.x temp and cache directory
+
+.temp
+.cache
+
+# Docusaurus cache and generated files
+
+.docusaurus
+
+# Serverless directories
+
+.serverless/
+
+# FuseBox cache
+
+.fusebox/
+
+# DynamoDB Local files
+
+.dynamodb/
+
+# TernJS port file
+
+.tern-port
+
+# Stores VSCode versions used for testing VSCode extensions
+
+.vscode-test
+
+# yarn v2
+
+.yarn/cache
+.yarn/unplugged
+.yarn/build-state.yml
+.yarn/install-state.gz
+.pnp.\*
+
+# wrangler project
+
+.dev.vars
+.wrangler/

packages/mcp-server/cloudflare-worker/README.md

@@ -0,0 +1,100 @@
+# Remote MCP Server on Cloudflare with Stainless
+
+Remote MCP servers require OAuth, so this flow implements a local version of the OAuth redirects, but instead accepts the
+API token and any other client configuration options that you'd need to instantiate your TypeScript client.
+
+## Usage
+
+The recommended way to use this project is to use the below "deploy to cloudflare" button to use this repo as a template for generating a server.
+
+[![Deploy to Cloudflare](https://deploy.workers.cloudflare.com/button)](https://deploy.workers.cloudflare.com/?url=https://github.com/muxinc/mux-node-sdk/tree/main/packages/mcp-server/cloudflare-worker)
+
+## Develop locally
+
+```bash
+# install dependencies
+npm install
+
+# run locally
+npm run dev
+```
+
+You should be able to open [`http://localhost:8787/`](http://localhost:8787/) in your browser
+
+## Connect the MCP inspector to your server
+
+To explore your new MCP api, you can use the [MCP Inspector](https://modelcontextprotocol.io/docs/tools/inspector).
+
+- Start it with `npx @modelcontextprotocol/inspector`
+- [Within the inspector](http://localhost:5173), switch the Transport Type to `SSE` and enter `http://localhost:8787/sse` as the URL of the MCP server to connect to, and click "Connect"
+- You will navigate to a (mock) user/password login screen. Input any email and pass to login.
+- You should be redirected back to the MCP Inspector and you can now list and call any defined tools!
+
+## Connect Claude Desktop to your local MCP server
+
+The MCP inspector is great, but we really want to connect this to Claude! Follow [Anthropic's Quickstart](https://modelcontextprotocol.io/quickstart/user) and within Claude Desktop go to Settings > Developer > Edit Config to find your configuration file.
+
+Open the file in your text editor and replace it with this configuration:
+
+```json
+{
+  "mcpServers": {
+    "mux_mux_node_api": {
+      "command": "npx",
+      "args": ["mcp-remote", "http://localhost:8787/sse"]
+    }
+  }
+}
+```
+
+This will run a local proxy and let Claude talk to your MCP server over HTTP
+
+When you open Claude a browser window should open and allow you to login. You should see the tools available in the bottom right. Given the right prompt Claude should ask to call the tool.
+
+## Deploy to Cloudflare
+
+If you want to manually deploy this server (e.g. without the "deploy to cloudflare" button)
+
+1. `npx wrangler@latest kv namespace create remote-mcp-server-oauth-kv`
+2. Follow the guidance to add the kv namespace ID to `wrangler.jsonc`
+3. `npm run deploy`
+
+## Call your newly deployed remote MCP server from a remote MCP client
+
+Just like you did above in "Develop locally", run the MCP inspector:
+
+`npx @modelcontextprotocol/inspector@latest`
+
+Then enter the `workers.dev` URL (ex: `worker-name.account-name.workers.dev/sse`) of your Worker in the inspector as the URL of the MCP server to connect to, and click "Connect".
+
+You've now connected to your MCP server from a remote MCP client.
+
+## Connect Claude Desktop to your remote MCP server
+
+Update the Claude configuration file to point to your `workers.dev` URL (ex: `worker-name.account-name.workers.dev/sse`) and restart Claude
+
+```json
+{
+  "mcpServers": {
+    "mux_mux_node_api": {
+      "command": "npx",
+      "args": ["mcp-remote", "https://worker-name.account-name.workers.dev/sse"]
+    }
+  }
+}
+```
+
+## Debugging
+
+Should anything go wrong it can be helpful to restart Claude, or to try connecting directly to your
+MCP server on the command line with the following command.
+
+```bash
+npx mcp-remote http://localhost:8787/sse
+```
+
+In some rare cases it may help to clear the files added to `~/.mcp-auth`
+
+```bash
+rm -rf ~/.mcp-auth
+```