v1.6.0
Toolport v1.6.0
Headless gateway, MCP over the network, and a much smoother first connect for npx servers.
This release is a big step if you've been running Toolport only as a desktop app. The same
toolport-gateway binary now deploys in Docker, speaks MCP streamable-HTTP, and publishes
to GHCR — while the desktop app picks up reliability fixes that matter day to day.
Before exposing headless on a network: read the production checklist in docs/headless.md.
Headless / container gateway
Run Toolport without the UI for sandboxes, agents, and Open WebUI:
| Endpoint | Use |
|---|---|
POST /mcp |
MCP clients over streamable-HTTP (Claude Code remote, Cursor, Pi, …) |
GET /mcp |
Long-lived SSE listen stream for server→client JSON-RPC |
GET /openapi.json + POST /{tool} |
Open WebUI, n8n, LibreChat |
docker pull ghcr.io/tsouth89/toolport-gateway:latestSee docs/headless.md for compose, env-file secrets, and handshake examples.
MCP server-initiated RPC (#167)
When your MCP client declares roots, sampling, or elicitation at initialize,
downstream servers can call back through the gateway:
roots/listsampling/createMessageelicitation/create
Works over stdio and HTTP MCP (inline during SSE POST responses).
npx / uvx first connect
npx -y, uvx, pnpm dlx, and similar launchers often need 15–60 seconds to download on
a cold cache. Toolport used to show a false Error after 10 seconds, then succeed on
retry.
Now:
- 120s first-connect budget for download launchers (10s for everything else)
- "Installing…" badge while the package downloads
- Background pre-warm when you add an npx-style server
Also in this release
- AnythingLLM — connect from the Clients view
- Teams usage rollups — per-server tool-call counts on the team dashboard
- Registry safety — read failures no longer wipe your config
- Faster gateway builds — CI/docker skip Tauri/WebKit (
--no-default-features) - Headless docs — production checklist, security notes,
scripts/smoke-headless.ps1
Upgrade
Desktop: Settings → About → Check for updates (v0.3.3+), or download the installer
from Releases.
Docker: docker pull ghcr.io/tsouth89/toolport-gateway:latest and restart your
container.
From source: git pull, npm install, npm run build:gateway, npm run tauri dev.
Full changelog: CHANGELOG.md.