Repository navigation
Releases
MCPtoAI Desktop v0.2.13
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_filessearches 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
KeepAliveagent restarted while Desktop was trying to stop it, causingAgent 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
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 doctorDocker — 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.1Without /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/andshared-core/verified identical - Signed Git tags:
linux-v0.3.1in 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
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 loginFor 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.0The 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.0Replace 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.
latestwas not updated by this release. Recorded post-releaselatestbaseline: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
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
- macOS Apple Silicon DMG —
ca91897c9cd440e4901dc5c40d73c7712d6f86420308f57f0c4989b9cee3ec2f - Windows x64 installer —
05ee09c5465d8fe7c0d17ba362e685d5795e0413c743900b88eeebf392fa7d4d
Linux CLI and Docker images use independent versioning and are not part of this Desktop release.
MCPtoAI v0.2.8
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
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
- macOS Apple Silicon DMG
- Windows x64 installer
- Linux CLI:
python3 -m pip install mcptoai==0.2.6 - Docker:
docker pull ghcr.io/mcptoai/mcptoai:0.2.6
See Downloads for SHA-256 checksums and installation instructions.
MCPtoAI v0.2.6
MCPtoAI Desktop 0.2.6 — macOS and Windows.
Downloads
- macOS Apple Silicon DMG
- Windows x64 installer
- Linux CLI on PyPI (independent version)
- Official Docker images (independent version)
See Downloads for current installation instructions.
MCPtoAI v0.2.5
MCPtoAI 0.2.5 security and desktop release.
- macOS signed and Apple notarized: https://api.mcptoai.com/releases/macos/MCPtoAI-0.2.5-arm64.dmg
- Windows x64 signed installer: https://api.mcptoai.com/releases/windows/MCPtoAI-0.2.5-x64-Setup.exe
- Pillow >=13 security update and read-only PHP advisory in doctor.
- Linux CLI 0.2.5 published on PyPI: https://pypi.org/project/mcptoai/0.2.5/
- Docker 0.2.5 published for linux/amd64 and linux/arm64:
ghcr.io/mcptoai/mcptoai:0.2.5(latestalso points to 0.2.5). - Docker image digest:
sha256:a82e6657ad4a0aa88716cfb2ac947a1df846d087a03863355b70ff3d19588d80. - Docker image signed using Sigstore Cosign GitHub OIDC and independently verified; Pillow 13.0.0 on both architectures.
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
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
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, anddenied. 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
.keyfiles are blocked. The.keyextension 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 withmcptoai --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-2565b160a60cef9b1065b3dfa5d7cf962eaed8583b6ba905e9b17d3bb3a1f880278
SHA-5122cecb5ee3af60e6f853dfebde260ef7175eed37f1747fd03ce545ccf316666602cde43c1a35bfdb537a7a2593decd9b691ba9374bc8260223eca9b6c1587c236MCPtoAI-0.2.3-arm64.zip(162,296,503 bytes)
SHA-256d3eb5bd0270b1d5145bd4a0f9f6cc1eda5445462fe80d48e195245892ed85d5b
SHA-512b654cedaa8da41769ee6721b230721c7cef696cd9a849137fa414a529ea0e58028a56b09d89f1d6d37bc6531df66bb5ace4ff3779f7c9baf574e6f8a6f2f7876
Windows (Authenticode signed, publisher BKTY LTD)
MCPtoAI-0.2.3-x64-Setup.exe(138,744,264 bytes)
SHA-2560a5324ce8c960547938494b5d09fa9916511f4cce16f4d4dabf7c318904cd1b9
SHA-5123520fd6c11a7ae64134f2a2b8b713d8a979dc420c400c843fb50b0280d32deb5663d9709828386c84c49d0896bc7b81310b5eabea82d55c731a192f99ed716f5
Linux CLI (unsigned; verify checksums; PyPI shows the same SHA-256)
mcptoai-0.2.3-py3-none-any.whl
SHA-2561650cd43d73f495145b8e9d96ff9fca7a4d13793c85aefb76295e0ea5104e2e0
SHA-512f140fc5c1d68032dc980f65a6e8a853bf38262807c96872cb5da4e9d4ca86a9e6e3d223a58b4afb45abc7a99f90ab95c28743efed328532f0ccd06367621f02bmcptoai-0.2.3.tar.gz
SHA-25607decd4763cdacc6a6b10dd3cf28ac5d3ec62a2841a980c1e599a810810c2cd5
SHA-512b8716c45de939f63a0210420218f73bb5007a99a08a9d70abfc4983c11cd207738ec6ecd37f47149ac9d8b5409450a87d4454775448236384abdcd16ae967c84
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