Skip to content

Releases

MCPtoAI Desktop v0.2.13

Choose a tag to compare

@Abktya Abktya released this 19 Nov 07:36
v0.2.13
5f0e915

MCPtoAI Desktop v0.2.13 — macOS and Windows

MCPtoAI Desktop v0.2.13 includes Device Agent v0.2.13 for macOS Apple Silicon and Windows x64. The official signed installers were built from the clean, signed private Core tag v0.2.13 at commit 704270eae977e00dabd4451b48de191cc687aba8. Linux CLI and Docker are separately versioned at 0.3.1.

What's new

  • Images and visual context: Improved JPEG, PNG, WebP and GIF handling; browser-side HEIC/HEIF conversion where supported; and visual context budgeting based on image dimensions rather than treating base64 image contents as text tokens. Tested PNG screenshots up to 3.2 MB with supported models.
  • Documents and conversation continuity: Improved PDF/DOCX chat handling, multi-image limits and localized attachment/context messages in seven languages. Better continuity when switching models, while keeping local-file access subject to permission checks.
  • File tools and device safety: Bounded find_files searches with partial-result notices; macOS inbound file approval; preserved local device permissions.
  • Device Agent reliability: Improved agent handover and restart, including the Windows single-supervisor implementation.

Downloads

  • macOS 13+ / Apple Silicon: MCPtoAI-0.2.13-arm64.dmg — Apple Developer ID signed, notarized and stapled.
  • Windows 10+ / x64: MCPtoAI-0.2.13-x64-Setup.exe — BKTY LTD Authenticode signed and timestamped.
  • Integrity manifest: SHA256SUMS — SHA-256 checksums of both attached installers.
File SHA-256
MCPtoAI-0.2.13-arm64.dmg b0fc5d3ce686b46a21b76fe7d94701730e6f6f011b5eb852f0eb74db1867f7e9
MCPtoAI-0.2.13-x64-Setup.exe 34d31b2a478879b348c9da4e9e4785d7d648dd75750aff3f2cce1c36300f9048

Upgrade path

v0.2.10 was the preceding publicly available Desktop release. v0.2.11 and v0.2.12 were tagged for testing, but were not publicly released. Install or update directly from v0.2.10 to v0.2.13; no intermediate release is needed.

Validation and known limitations

  • Real macOS and Windows v0.2.10 → v0.2.13 OTA updates completed successfully on test devices; the installed Desktop and Agent both report v0.2.13 and clean Core commit 704270eae977e00dabd4451b48de191cc687aba8. Post-update device acceptance passed 15/15 on each platform.
  • During an earlier macOS OTA attempt, a legacy launchd KeepAlive agent restarted while Desktop was trying to stop it, causing Agent still running; update installation cancelled. A subsequent user-run OTA succeeded without issues. Legacy macOS Agent configurations may still require manually installing the signed DMG; a successful retest does not prove all older configurations are unaffected.
  • Windows native device-side inbound file transfer still requires a separate trusted approval/IPC implementation. Browser-side HEIC/HEIF chat conversion does not imply that original HEIC/HEIF inbound device-file transfer is supported.
  • Search time bounds are best-effort and visual-token budgets depend on the selected provider/model.

See MCPtoAI Downloads for installation guidance and Security Policy for security reporting.

MCPtoAI Linux v0.3.1

Choose a tag to compare

@Abktya Abktya released this 14 Nov 13:00
linux-v0.3.1
a6a94de

MCPtoAI Linux v0.3.1

Linux CLI and Docker release, versioned independently from MCPtoAI Desktop. Desktop v0.2.10 remains Latest.

Install (Python 3.11+)

python3 -m pip install 'mcptoai==0.3.1'
mcptoai --version
mcptoai doctor

Docker — persistent workspace is required for file tools

mkdir -p "$HOME/mcptoai-workspace"
docker volume create mcptoai-data
docker pull ghcr.io/mcptoai/mcptoai:0.3.1
docker run -it --rm -v mcptoai-data:/data -v "$HOME/mcptoai-workspace:/workspace" ghcr.io/mcptoai/mcptoai:0.3.1 login
docker run --rm -v mcptoai-data:/data -v "$HOME/mcptoai-workspace:/workspace" ghcr.io/mcptoai/mcptoai:0.3.1 doctor
docker run -d --name mcptoai --restart unless-stopped -v mcptoai-data:/data -v "$HOME/mcptoai-workspace:/workspace" ghcr.io/mcptoai/mcptoai:0.3.1

Without /workspace bind mount, the default filesystem allowed roots are empty (fail-closed) and doctor warns. /data persists identity and settings; it is not the host workspace. Older container-local Desktop/Documents/Downloads folders were not persistent host folders. Mount permissions must allow container UID 1000.

Release integrity

  • Core source commit: 01efa0ac9d17da47a6a1aa833c31f002b7b3e915
  • Public export commit: a6a94de56232e5a698b853b4b5269cb4cdb038e5
  • Source trees linux-agent/ and shared-core/ verified identical
  • Signed Git tags: linux-v0.3.1 in Core and Public
  • PyPI: https://pypi.org/project/mcptoai/0.3.1/
  • GHCR: ghcr.io/mcptoai/mcptoai:0.3.1 (amd64 and arm64)
  • Immutable image digest: sha256:1b89b30ff8c6030a0fffb37e41f11a6871e3101a9856023248ade80d18adf004
  • Cosign identity: https://github.com/mcptoai/MCPtoAI_Core/.github/workflows/publish-linux-artifacts.yml@refs/tags/linux-v0.3.1; OIDC issuer: https://token.actions.githubusercontent.com

See linux-agent/docs/release-notes-0.3.1.md for fixes and compatibility details.

MCPtoAI Linux v0.3.0

Choose a tag to compare

@Abktya Abktya released this 14 Nov 07:39
55311a3

MCPtoAI Linux v0.3.0

Linux CLI and Docker release, versioned independently from MCPtoAI Desktop. No Desktop installer is included.

Install the Linux CLI (Python 3.11+)

python3 -m pip install 'mcptoai==0.3.0'
mcptoai --version
mcptoai login

For an isolated installation, use pipx install 'mcptoai==0.3.0' instead.

Install with Docker

docker pull ghcr.io/mcptoai/mcptoai:0.3.0
docker run -it --rm -v mcptoai-data:/data ghcr.io/mcptoai/mcptoai:0.3.0 login
docker run -d --name mcptoai --restart unless-stopped -v mcptoai-data:/data ghcr.io/mcptoai/mcptoai:0.3.0

The container runs as UID 1000. /data is the persistent configuration and identity location. Docker does not update itself through mcptoai update: pull a newer versioned image and recreate the container with the same /data volume.

Upgrade from Docker 0.2.x: important /data migration

Previously, persistent configuration was mounted at /home/mcptoai/.config. Starting with 0.3.0, mount a new empty volume at /data. First stop the old container and back up its original volume. Assuming the old named volume is mcptoai:

docker stop mcptoai
docker rm mcptoai
# Back up the old named volume using your normal Docker volume backup procedure.
docker volume create mcptoai-data
docker run --rm \
  -v mcptoai:/home/mcptoai/.config \
  -v mcptoai-data:/data \
  ghcr.io/mcptoai/mcptoai:0.3.0 --help
# Check the migrated configuration before running the service.
docker run -d --name mcptoai --restart unless-stopped \
  -v mcptoai-data:/data ghcr.io/mcptoai/mcptoai:0.3.0

Replace mcptoai with the actual legacy volume name; inspect docker inspect <old-container-name> before removing the old container if unsure. The old volume is retained for rollback. The migration creates a .legacy-volume-copied marker; reruns do not copy again. A nonempty target without a migration marker fails closed rather than overwriting existing data. Keep the original volume backup until the new agent is confirmed paired and working. For a bind-mounted legacy directory, adapt the source mount accordingly.

Release integrity

  • Release source commit: d06023d2c6bd9e91b722a13980857dad234aaea7
  • Signed Linux Git tag: linux-v0.3.0
  • PyPI: https://pypi.org/project/mcptoai/0.3.0/
  • GHCR: ghcr.io/mcptoai/mcptoai:0.3.0
  • Immutable multi-platform image digest: sha256:f6ee7d63558e882ab19fca2d6c3d2e1e425ebf05a700eba75eb0a845e94e460f
  • Image signature verified with Cosign using the exact GitHub Actions release workflow certificate identity. BuildKit SBOM and provenance are available within the signed OCI index; provenance source revision matches the release commit. Separately Cosign-signed SBOM/SLSA attestations are not claimed for this release.
  • latest was not updated by this release. Recorded post-release latest baseline: sha256:acaa4f7516ab1eca6373aee62d4495b53f4527b722b4182c921f585142cc5d06.

Public source: Linux 0.3.0 linux-agent/ and shared-core/ were exported from the verified release source commit d06023d2c6bd9e91b722a13980857dad234aaea7 and merged to public main in PR #19 (8a5b7b498a0f50fb9693d009b997f20cce362c18). Note that the original linux-v0.3.0 public tag predates this export, so GitHub's auto-generated archives at that tag remain historical snapshots; use the public merged source tree or the published PyPI/GHCR artifacts for Linux 0.3.0.

Linux versioning is independent of Desktop v0.2.x. Docker 0.3.0 supports linux/amd64 and linux/arm64.

MCPtoAI Desktop v0.2.10

Choose a tag to compare

@github-actions github-actions released this 12 Nov 17:22
v0.2.10
f609460

MCPtoAI Desktop v0.2.10

MCPtoAI v0.2.10 introduces a clearer record of AI actions and reliable controls to stop running requests, alongside desktop and agent reliability improvements.

New — Activity

See the history of AI tool operations performed on your device: tool, target, model, duration, and permission decision. Activity is available in both MCPtoAI Desktop and the web app. From Desktop, you can disable Activity recording or clear your history. Only sanitized metadata is recorded — no file contents, command output, or passwords. Activity history stays on your device and is not stored on MCPtoAI servers.

New — Stop

Stop a running request from the web app. Cancellation remains available even if the page is refreshed or the browser is closed. Actions that already completed are not undone.

Improved — Reliability and security

  • Windows background agent: Console-free automatic startup and recovery after crashes through the supervisor.
  • macOS update handover: More reliable transition to the bundled Device Agent after Desktop updates.
  • Version consistency: Desktop, bundled Agent and release metadata report matching versions; packaged Agent versions are checked during release builds.
  • Security: Stronger release integrity checks and signed distribution artifacts. macOS builds are Developer ID signed, notarized and stapled. Windows installer, Desktop executable and both Agent executables are digitally signed.

Upgrading

v0.2.9 was briefly published and withdrawn; existing users upgrade directly from v0.2.8 to v0.2.10.

Downloads and SHA-256

Linux CLI and Docker images use independent versioning and are not part of this Desktop release.

MCPtoAI v0.2.8

Choose a tag to compare

@github-actions github-actions released this 11 Nov 10:13
206ec16

MCPtoAI v0.2.8

This update improves reliability, account sign-in options, and security across MCPtoAI Desktop and Web.

What's new

  • ChatGPT sign-in preview: Optional ChatGPT sign-in in Desktop and Web. This is a Preview feature, disabled by default; existing sign-in flows remain available.
  • Electron 44: Desktop runtime updated to Electron 44.
  • Windows agent recovery: A supervisor can restart the Device Agent after unexpected crashes, helping restore connectivity without manual intervention.
  • Safer agent handover: Improved agent version transitions and process lifecycle handling to reduce duplicate or orphaned agent processes.
  • Clearer AI provider errors: More useful provider error messages and improved provider removal flows.
  • Security and dependency fixes: Hardened package dependencies, locked build environment, and additional packaged-resource security checks.

Downloads

  • macOS Apple Silicon (arm64): Signed and Apple-notarized DMG and ZIP.
  • Windows x64: Azure-signed Setup.exe.
  • macOS Intel: No installer in this release.
  • Linux: No new Linux desktop package in this release. Use the existing Linux installation options (PyPI/Docker) linked from the project documentation or downloads page; check their published versions separately.

These are the same signed v0.2.8 files already distributed through the stable OTA channel. No packages were rebuilt for this GitHub Release.

Integrity

Verify downloads against the attached SHA256SUMS.txt. The listed checksums are computed from the existing stable OTA release artifacts.

Notes

ChatGPT sign-in remains an opt-in preview and is not enabled automatically. This GitHub Release does not deploy a new OTA or change production services.

MCPtoAI v0.2.7

Choose a tag to compare

@github-actions github-actions released this 01 Nov 23:28
v0.2.7
104feb8

MCPtoAI Desktop 0.2.7 (macOS, Windows) · Linux CLI 0.2.6

Version 0.2.7 only changes how the Desktop app updates its local agent; the Linux CLI is unchanged and stays at 0.2.6.

Release notes — Desktop 0.2.7

  • Safer updates: when the app updates, any agent left running from the previous version is now stopped, so only one agent stays connected.
  • The app no longer restarts the background agent each time you open it.
  • Server-side: if two agents from the same device connect, requests are delivered to only one of them.

Downloads

See Downloads for SHA-256 checksums and installation instructions.

MCPtoAI v0.2.6

Choose a tag to compare

@github-actions github-actions released this 31 Oct 23:45
d2c8733

MCPtoAI Desktop 0.2.6 — macOS and Windows.

Downloads

See Downloads for current installation instructions.

MCPtoAI v0.2.5

Choose a tag to compare

@Abktya Abktya released this 24 Oct 13:12
bbc99c3

MCPtoAI 0.2.5 security and desktop release.

PyPI package integrity (SHA-256 / SHA-512)

mcptoai-0.2.5-py3-none-any.whl
  SHA-256 ac99fe945c79bec9eba5a39bb23ef7dcb788ae793fed506969108e7d4c552147
  SHA-512 fde2e75723b239426bb85a20690ef29b1a71b674c9dd45aa794f39a847036e41061aeae600e1ac46cdad9ddcb1490f5a58e5c09fb85730c025badc4a69bf368d
mcptoai-0.2.5.tar.gz
  SHA-256 3158d77dae35d4f3b985ee641d39eb6174dc3287b20a6bbb0bb10c160d3b2880
  SHA-512 20b29785a439ac0afdcac1c0432bbae55794e03aa7229152466dfc31dddb7041846371b8d880a726fa44b6e1a59e94c6a475c552a16020ec3d4b54069ff2b3c1

MCPtoAI v0.2.4

Choose a tag to compare

@github-actions github-actions released this 23 Oct 20:43
9a2da47

MCPtoAI 0.2.4 — macOS, Windows, Linux CLI and Docker.

Downloads

python3 -m pip install mcptoai==0.2.4

docker pull ghcr.io/mcptoai/mcptoai:0.2.4

See Downloads for current installation instructions.

MCPtoAI v0.2.3

Choose a tag to compare

@github-actions github-actions released this 22 Oct 16:13
c29ee87

MCPtoAI 0.2.3 — Release notes

MCPtoAI 0.2.3 improves how your paired computer handles local tools, sensitive files, and approved file transfers. Features vary by operating system.

What's new

  • Skills on macOS and Windows: manage agent skills with preflight checks, access restrictions for skill files and data, and device-side policy enforcement. Managed Skills are not yet available on Linux.
  • Universal File Artifacts: send supported documents, images, audio, and video from a paired device to chat after explicit approval. Transfers use authenticated downloads, file-size and workspace checks, expiration limits, and cleanup. Chat can play supported MP4 videos. Returning a file path alone does not upload that file.
  • Protected locations: built-in file tools check sensitive directories and filenames, including application credentials, browser profiles, SSH keys, shell histories, and Windows AppData. Symlinks and Windows path aliases are resolved before file access.
  • Checks before approval: file paths, file type, extension, size, and permitted workspace are checked before a confirmation prompt appears. Approval cards identify file types and sizes and distinguish creating a file from overwriting one.
  • Clearer tool results: actions distinguish completed, failed, blocked, and denied. Statuses are communicated with text and icons, not color alone.
  • Safer approval details: the agent, not model-supplied tool arguments, determines file metadata shown in approval prompts for supported file operations.
  • Video controls: in-chat playback includes native controls and accessible seek buttons, using five-second steps for short clips and ten-second steps for longer clips.
  • Cleaner API keys: when you paste an API key into the Linux CLI or Device Agent CLI, control characters are removed. Keys previously saved with these characters are automatically repaired.
  • More reliable Linux AI connections: TLS fallback handling helps Linux connect to AI providers when the usual certificate verification path is unavailable.

Security and known limitations

  • Terminal commands are not sandboxed. If terminal access is enabled and a command is approved or otherwise permitted, it can access resources available to your operating-system account. The protected-file policy for built-in file tools does not sandbox run_command, run_in_project, background jobs, or external MCP tools. Review commands before approving them.
  • Keynote .key files are blocked. The .key extension is also used for private keys, so this version does not provide a Keynote-specific exception.
  • Linux wheel packages are not cryptographically signed. When installing a downloaded wheel, verify its published SHA-256 and SHA-512 checksums against a trusted release source. A checksum verifies the downloaded bytes against the reference; it is not a substitute for a trusted signature.
  • Managed Skills currently support macOS and Windows, not Linux. File transfer availability and supported file types may vary by platform.
  • Local permissions reduce unintended access, but they are not a substitute for operating-system account security and careful review of powerful tools.

Upgrading

  • macOS and Windows: when version 0.2.3 is offered in MCPtoAI Desktop, use Check for Updates, download the update, and choose Restart & Install. Reopen Desktop and confirm both the Desktop and Device Agent versions. Keep the device paired and review permissions after updating.
  • Linux CLI: python3 -m pip install --upgrade mcptoai. After upgrading, check the installed version with mcptoai --version.
  • Docker: docker pull ghcr.io/mcptoai/mcptoai:0.2.3. Keep your persistent configuration volume when replacing a container; verify the image digest from the trusted release information.

See SECURITY.md for reporting security issues and the Linux guide for platform-specific setup.

Integrity and verification

macOS (Developer ID signed and notarized)

  • MCPtoAI-0.2.3-arm64.dmg (162,729,553 bytes)
    SHA-256 5b160a60cef9b1065b3dfa5d7cf962eaed8583b6ba905e9b17d3bb3a1f880278
    SHA-512 2cecb5ee3af60e6f853dfebde260ef7175eed37f1747fd03ce545ccf316666602cde43c1a35bfdb537a7a2593decd9b691ba9374bc8260223eca9b6c1587c236
  • MCPtoAI-0.2.3-arm64.zip (162,296,503 bytes)
    SHA-256 d3eb5bd0270b1d5145bd4a0f9f6cc1eda5445462fe80d48e195245892ed85d5b
    SHA-512 b654cedaa8da41769ee6721b230721c7cef696cd9a849137fa414a529ea0e58028a56b09d89f1d6d37bc6531df66bb5ace4ff3779f7c9baf574e6f8a6f2f7876

Windows (Authenticode signed, publisher BKTY LTD)

  • MCPtoAI-0.2.3-x64-Setup.exe (138,744,264 bytes)
    SHA-256 0a5324ce8c960547938494b5d09fa9916511f4cce16f4d4dabf7c318904cd1b9
    SHA-512 3520fd6c11a7ae64134f2a2b8b713d8a979dc420c400c843fb50b0280d32deb5663d9709828386c84c49d0896bc7b81310b5eabea82d55c731a192f99ed716f5

Linux CLI (unsigned; verify checksums; PyPI shows the same SHA-256)

  • mcptoai-0.2.3-py3-none-any.whl
    SHA-256 1650cd43d73f495145b8e9d96ff9fca7a4d13793c85aefb76295e0ea5104e2e0
    SHA-512 f140fc5c1d68032dc980f65a6e8a853bf38262807c96872cb5da4e9d4ca86a9e6e3d223a58b4afb45abc7a99f90ab95c28743efed328532f0ccd06367621f02b
  • mcptoai-0.2.3.tar.gz
    SHA-256 07decd4763cdacc6a6b10dd3cf28ac5d3ec62a2841a980c1e599a810810c2cd5
    SHA-512 b8716c45de939f63a0210420218f73bb5007a99a08a9d70abfc4983c11cd207738ec6ecd37f47149ac9d8b5409450a87d4454775448236384abdcd16ae967c84

Docker (signed with Sigstore)
ghcr.io/mcptoai/mcptoai:0.2.3 digest sha256:481aaf9f931aa0dab3a119812dda43875f9747c36d96949ecb213b7a365118cd

cosign verify \
  --certificate-identity "https://github.com/mcptoai/MCPtoAI_Core/.github/workflows/publish-linux-docker.yml@refs/tags/docker-v0.2.3-r2" \
  --certificate-oidc-issuer "https://token.actions.githubusercontent.com" \
  ghcr.io/mcptoai/mcptoai@sha256:481aaf9f931aa0dab3a119812dda43875f9747c36d96949ecb213b7a365118cd