hoist talk to Hoista’s engine over an HTTP API: on this computer through a socket in the state folder that only your user can open, and on a remote at https://<your-remote>/api.
It’s built for those two, not as a public interface. Routes and their answers can change from one version to the next without notice, so don’t build on it.
To work with Hoista from your own tools:
From ChatGPT or another computer
For ChatGPT and other web agents, Hoista on your computer serves MCP over HTTP on127.0.0.1:8788. Point a tunnel or proxy at it; see From your computer. Only sign-in and /mcp are served there, not this API.
To reach Hoista from another computer, run it in server mode behind HTTPS, on a server or a Mac mini. In server mode every route needs a sign-in: the desktop app and hoist use a key each computer gets when you approve it with your passkey, and agents like ChatGPT use /mcp with access you approve the same way. See Self-host Hoista.
Related
CLI reference
Every hoist command.
MCP server
Connections and the tools to start with.
Webhooks
Send events to a background agent.