Repository navigation
Releases
salt-mcp 0.3.0
Two new local modes. salt-mcp --channel brings Salt messages into a Claude Code session: allow-listed members only, a reply tool, and approval cards you answer on your phone. salt-mcp --as-me reads your own end-to-end encrypted chats on your machine; it stores nothing, and its send step asks you first. New tools: react_to_message, salt_reply_to_post / salt_post_replies, ask_for_help / close_help_request (34 local tools). The hosted server answers GET / with a connect guide. Built on salt-agent-sdk 0.29.0 from npm.
npm: npx salt-mcp (0.3.0). Claude Desktop: salt.mcpb below. Docker: ghcr.io/0000f8/salt-mcp:v0.3.0. Hosted: https://mcp.saltapp.ai/mcp (OAuth).
salt-mcp 0.2.7
Every tool that declares an output schema now returns structured content, so the official MCP SDK client's callTool works on the local open_chat, ask_human and get_ask_result (it threw -32600). Local salt_read_room decrypts the agent's own messages too. The README has a tool reference listing every required parameter, checked against the code.
Claude Desktop: salt.mcpb below. Docker: ghcr.io/0000f8/salt-mcp:v0.2.7. Hosted: https://mcp.saltapp.ai/mcp (OAuth).
salt-mcp 0.2.6
Local mode reaches humans.
- Local (Docker,
.mcpb, stdio) gainsopen_chat,ask_humanandget_ask_result: open a 1:1 by handle, ask with buttons, get the tap back from the card itself.post_cardtakes an explicitchat_id. salt_read_roomdecrypts what the agent can read with the key it holds locally. The hosted server never decrypts.- Startup checks the api key once: a rejected key is a clear error and a non-zero exit, not "ready".
PGP_PASSPHRASEis optional (keys made in Salt's web have none).- Credential docs match the product: self-register (
registerAgent/POST /auth) or set an agent up by hand on the web, whose "is live" screen now shows the agent id. - Registry entry gains icons and a description that names the job.
Claude Desktop: download salt.mcpb below. Docker: ghcr.io/0000f8/salt-mcp:v0.2.6. Hosted, nothing to install: https://mcp.saltapp.ai/mcp (OAuth).
salt-mcp 0.2.5
What a stranger connecting an MCP client to Salt hit, fixed.
list_chatsreturns each chat's id and members (it read the wrong shape).open_chatfinds a person by handle, including the human who connected the app.ask_humanmarks its card "Answered: …" once the human taps, and says wherechat_idcomes from.- Over OAuth,
tools/listfollows the grant: 13 tools withchat, 18 withchat+money. Local mode exposes 26. - README: an "Any MCP SDK client" section (public client, loopback redirect, PKCE, dynamic registration).
- Bundles salt-agent-sdk 0.15.0.
Server-side fixes these depend on shipped in Salt 0.117.0–0.119.2 (OAuth bearer chat reads, non-browser websocket handshakes, contact search q).
Claude Desktop: download salt.mcpb below and open it. Docker: ghcr.io/0000f8/salt-mcp:v0.2.5. Hosted: https://mcp.saltapp.ai/mcp (OAuth, nothing to install).
salt-mcp 0.2.4
Same server as 0.2.3. The Docker image now carries the MCP Registry ownership label (io.modelcontextprotocol.server.name), so the registry entry can list ghcr.io/0000f8/salt-mcp as an installable package. Claude Desktop bundle attached.
salt-mcp 0.2.3
Same server as 0.2.2 (add Salt to every client, Docker image); the multi-arch image build now runs its compile and install stages natively. Claude Desktop bundle attached; ghcr.io/0000f8/salt-mcp:latest is built from this release.
salt-mcp 0.2.2
Add Salt to every client, and a Docker image.
- docs/CLIENTS.md: how to connect ~28 MCP clients to https://mcp.saltapp.ai/mcp (OAuth 2.1), each verified against the client's current docs; one-click badges for Cursor and VS Code.
- Docker: ghcr.io/0000f8/salt-mcp — a multi-arch image of the local stdio server, built from this release.
- Claude Desktop: salt.mcpb attached below.
- MCP Registry entry ai.saltapp/salt 0.2.2 (remotes-only until the npm package exists).
salt-mcp 0.2.1
Salt for MCP clients, 0.2.1.
- Hosted: https://mcp.saltapp.ai/mcp — OAuth 2.1 (sign in with your Salt account; the client discovers the flow from the 401). MCP Registry entry ai.saltapp/salt 0.2.1.
- Claude Desktop: download salt.mcpb below and double-click it (a local, key-holding agent; its private key never leaves your machine).
- Claude Code: /plugin marketplace add 0000F8/salt-mcp
- Cursor: the one-click link in the README.
ask_human / get_ask_result wait on the card they posted, never on the agent's delivery outbox, so any number of asks can run at once. GET and DELETE on /mcp answer 401 with the OAuth resource metadata instead of a bare 404.