Releases: openclaw/mcporter
mcporter v0.10.2
Highlights
- Faster warm keep-alive calls by trimming daemon round-trips and runtime startup work.
- More robust live MCP behavior for resource errors, OAuth/list failures, and tool-name auto-correction.
- Generated CLIs now keep JSON output parseable for plain-text MCP results.
SHA256 (mcporter-macos-arm64-v0.10.2.tar.gz): 540390c49b5d04ecd9174a33a48bfabd4a3748b8616409882776954f9c17b571
SHA256 (mcporter-0.10.2.tgz): fedf0974ad84b78183c48caada7faf773dbed3100530765d7a6c503dc4f5b016
mcporter v0.10.1
Changes
CLI
- Fixed Bun-compiled standalone macOS binaries so
mcporter generate-cli --compileworks from an empty directory, even when there is no localpackage.jsonornode_modulestree. generate-cli --compilenow stages the matching publishedmcporterpackage dependencies when bundled dependencies cannot be linked or copied from the local package tree.- The Bun compile step now runs from the staging directory, so generated CLI builds resolve
mcporter,commander, and related dependencies from the same directory that contains the generated artifact. - Added a clearer failure message for standalone development binaries that cannot resolve published bundler dependencies.
Tests
- Added an opt-in standalone Bun release-binary regression smoke behind
MCPORTER_STANDALONE_BINARY_TEST=1. - The smoke builds
dist-bun/mcporter, packs the current package, runsgenerate-cli --compilefrom an empty temp directory, and verifies the compiled CLI help output.
Docs / Release Process
- Clarified that the Homebrew formula should install the npm
.tgz, not the standalone Bun macOS tarball, because generated CLI compilation needs the installed package tree. - Documented the Homebrew release verification flow: update the tap URL/SHA, use
--min-release-age=0, refresh tap README callouts, runbrew reinstall,brew test, and run an empty-directory compile smoke with/opt/homebrew/bin/mcporter. - Documented npm and npx post-release verification, plus optional repeat verification on another Mac.
Maintenance
- Started the next development cycle after
v0.10.0with a freshUnreleasedchangelog stub.
Included Commits
026eb28fix: support standalone binary CLI compilation6ed9860docs: clarify Homebrew release verification2100639chore: start next development cycle
Release Verification
- npm package surface verified.
npx mcporter@0.10.1surface verified.- Direct standalone macOS binary surface verified.
Artifacts
mcporter-macos-arm64-v0.10.1.tar.gz- SHA256:
17451e9fd0cba13c4c506d43a3574f1cf8c707d9076aa1d22381d958199e0e1f
- SHA256:
mcporter-0.10.1.tgz- SHA1:
918af2d239a8e27292c9621bae965e07578bdb1e - SHA256:
efef969838b18df0bcbc3b5fe3d4a7057a96e99c46a3f25e2deb0dfd7afee1d3
- SHA1:
- Uploaded checksum files:
mcporter-macos-arm64-v0.10.1.tar.gz.sha256mcporter-0.10.1.tgz.sha1mcporter-0.10.1.tgz.sha256
mcporter v0.10.0
Highlights
- Added
mcporter resource <server> [uri]for listing and reading MCP resources, including keep-alive daemon routing. - Improved generated keep-alive CLIs and Bun-compiled macOS daemon startup for persistent server workflows.
- Added XDG directory support and static OAuth client configuration for providers without dynamic registration.
SHA256 (mcporter-macos-arm64-v0.10.0.tar.gz): 4b23391b709ea3ba877df283cb1b66c69d361fc8cee6f87d0b5d7fd8838be0e5
SHA256 (mcporter-0.10.0.tgz): 446fdf8c6a61e5201868ba702087de003308fbb11c56f6209ef331579c1af917
mcporter v0.9.0
Changelog
CLI
- Add per-server exact-name tool filtering with
allowedToolsandblockedTools, including config serialization and runtime call/list enforcement. (Rebuild of PR #39, thanks @tonylampada) - Escalate stuck stdio child-process shutdowns after close timeouts instead of treating the timeout as a clean exit. (PR #39, thanks @tonylampada)
- Quote OAuth browser URLs when launching
cmd.exeon Windows, preserving query parameters such asredirect_uri. (PR #136, thanks @cosminilie) - Document OAuth-protected server config setup with
mcporter config add --auth oauthandmcporter auth. (PR #34, thanks @prateek) - Respect schema-declared string parameters when coercing numeric-looking
mcporter callkey=value arguments, so Slack timestamps likethread_tsstay strings. (PR #141, thanks @Hamzaa6296)
Checksums
SHA256 (mcporter-macos-arm64-v0.9.0.tar.gz): 20cae1f412c8790d1801bd557825b12bb6354e73bd277be5484e53a58cf81c0b
SHA256 (mcporter-0.9.0.tgz): 7ebe1d1050f04a9ddea0478f8314b94239b6716f87061b2daad750d281b84526
mcporter v0.8.1
[0.8.1] - 2026-03-29
CLI
- Bun-compiled/Homebrew binaries now embed the package version before boot, so
mcporter --versionreports the real release (for example0.8.1) instead of falling back to0.0.0-dev.
Tests
- Added regression coverage for the Bun compile wrapper so future release builds keep the embedded runtime version intact.
Tooling / Dependencies
- npm publishes now use an explicit package allowlist, so local release tarballs/checksum files do not get bundled into the published package.
SHA256 (mcporter-macos-arm64-v0.8.1.tar.gz): 7f726f70801bdded163699b53fade8b602c18f0dbc07851ce5ddad8e0e8bcb3b
SHA256 (mcporter-0.8.1.tgz): 07abbbc8e3ffbaf1fd2a8030a90b56a5c895f52cfa301b42ff79cbaa0644242e
mcporter v0.8.0
[0.8.0] - 2026-03-29
CLI
- Preserve OAuth flow vs post-auth transport failures so invalid OAuth/provider errors surface directly, while real legacy 404/405 transport mismatches still fall back to SSE correctly. (PR #97, thanks @mavam)
- Ignore static
Authorizationheaders once OAuth is active so imported editor configs cannot override fresh OAuth tokens. (PR #123, thanks @ahonn) - Keep
mcporter call --output jsonparseable by emitting valid JSON even when the command falls back to raw output. (PR #128, thanks @armanddp) - Render
resourcecontent blocks in call output helpers instead of dropping them, including markdown resources and JSON text payloads. (PR #124, thanks @mvanhorn) - Preserve full JSON/error payloads when
datais just one field instead of collapsing the response todataalone. (PR #106, thanks @AielloChan) - Generated CLIs now parse object-valued flags as JSON and render object placeholders/examples with JSON-shaped help text, so tools like Jira
fieldsno longer receive raw strings. (PR #114, thanks @v2nic) - Deduplicate concurrent keep-alive daemon restarts per server so repeated fatal errors only force-close the cached daemon transport once before retrying. (PR #125, thanks @zm2231)
mcporter config addnow accepts plural--argsas an alias for repeated stdio arguments, matching common CLI muscle memory. (PR #93, thanks @Jah-yee)- Preserve default imports when
mcporter config addwrites a config file, instead of forcing"imports": []. - OAuth: avoid crashing on headless Linux when
xdg-openis unavailable; clear stale dynamic-port client registrations; close callback server if stale-client persistence reads fail. (PR #72, thanks @mgonto) - Added optional
oauthScope/oauth_scopeconfig override as an escape hatch for providers that require explicit scopes. - OAuth wait/redirect now share one deferred to eliminate authorization race windows and preserve stable close-path errors, including wait-before-redirect and repeated-redirect flows. (PR #70, thanks @monotykamary)
createCallResult().json()now collects all parseable JSON entries from MCP content arrays (single item stays backward-compatible), and raw inspect depth now stays readable without unbounded traversal. (PR #91, thanks @Blankdlh)- Added
--raw-strings(numeric coercion off) and--no-coerce(all coercion off) formcporter callargument parsing so IDs/codes can stay literal strings. (PR #59, thanks @nobrainer-tech) - Added
CallResult.images()plus opt-inmcporter call --save-images <dir>so image content blocks can be persisted without changing existing stdout output contracts. (PR #61, thanks @daniella-11ways) - OAuth transport retries now classify HTTP 405 as HTTP (not auth) and OAuth promotion applies to configured HTTP servers too, so post-auth fallback flows no longer drop credentials on 405-only endpoints. (PR #48, thanks @caseyg)
- Config loading now parses project and explicit config files as JSONC, so
mcporter.json/mcporter.jsonccan include comments and trailing commas. (PR #42, thanks @aryasaatvik) - Added generated
mcporter.schema.jsonpluspnpm generate:schemafor IDE autocomplete/validation, including$schemaandoauthScope/oauth_scopecoverage. (PR #43, thanks @aryasaatvik)
Tooling / Dependencies
- Updated dependencies to latest releases (including MCP SDK, Rolldown RC, Zod, Biome, Oxlint, Vitest, Bun types).
- Synced
biome.jsonschema URL to Biome2.4.5.
SHA256 (mcporter-macos-arm64-v0.8.0.tar.gz): 81c093704e1f0f247f14f2fa7ff0e8206227f9d44d6b8ff4bbd839941d083475
SHA256 (mcporter-0.8.0.tgz): 1de6cbbaf1295ceaa66a5ff5896987681021003d00d176d021b44dc5dc7daa80
mcporter v0.7.3
Highlights
mcporter generate-clinow supports--include-tools/--exclude-toolsto generate CLIs for a subset of tools. (Thanks @zackleman, PR #24)- Generated CLIs now reliably read Commander.js option values via camelCased properties so snake_case schemas map correctly. (Thanks @rawwerks, PR #28)
- Generated CLI array arguments coerce item types based on JSON Schema (including integer arrays). (Thanks @rawwerks, PR #27)
SHA256 (mcporter-macos-arm64-v0.7.3.tar.gz): 852da8adefeb78df53705aa3af12fe725067c8014a5a57d1d6a3b273d29a7dfe
SHA256 (mcporter-0.7.3.tgz): 8192091425ff249c7afdd69b1bf0cac6f165b76eb63b56e1facaaf3304c92527
mcporter v0.7.1
Highlights
- Daemon now tracks config mtimes across every loaded layer and auto-restarts keep-alive servers when anything changes, so new MCP servers are picked up without manual restarts.
- Updated the bundled config entries for Playwright and iTerm to match current server definitions.
- Changelog and release metadata cleaned up to keep future releases consistent.
SHA256 (mcporter-macos-arm64-v0.7.1.tar.gz): 70843fd029868fe21c4c83874e77c29d0b027cb15369fd6351663e60ec69bd23
SHA256 (mcporter-0.7.1.tgz): 6702d1d774aa8c44b14abc142d2851ed4013e04949bd4a4a66fe5ec30132afbc
mcporter v0.7.0
Highlights
- Centralized OAuth credentials in
~/.mcporter/credentials.jsonwith auto-migration plus a reliablemcporter auth --resetpath for clearing corrupted caches. - StdIO servers with dedicated auth helpers (e.g., Gmail) can now declare
oauthCommand.args, lettingmcporter auth <server>run that helper and wait for browser completion without manual npx calls. - Raw output now preserves full strings (no 10k-character truncation) and new regression tests guard the behavior.
SHA256 (mcporter-macos-arm64-v0.7.0.tar.gz): aa70885d4612f9dd765c339a1f6d8485de61f7a97902da57bb8538a6f8c8afc0
SHA256 (mcporter-0.7.0.tgz): a7f8328eb9f2d918f8896b55089828e9f5a77c494bdcabac86d6b3116dbe20ea
mcporter v0.6.6
Highlights
- Prevented ENOENT crashes when mcporter runs with no config anywhere; implicit defaults now fall back cleanly across list/config/daemon flows.
- Daemon launches now only pass explicit config paths to keep-alive servers, avoiding child-process ENOENTs.
- Added regression coverage for empty-environment daemon start and clarified docs guardrails around changelog/test notes.
SHA256 (mcporter-macos-arm64-v0.6.6.tar.gz): ecafbf932d5412645afdc7371513252df0647ce97580b0a4b512eada6c56ae7a
SHA256 (mcporter-0.6.6.tgz): 28aad963c8e8df85898b607b79eaa4f923e5e10f5264cad936d740fcf0291a1e