Compute
Provision persistent sandbox environments, run ephemeral code, deploy web apps to live preview URLs, and run serverless jobs — with tier-based per-second pricing and no infrastructure setup.
Call it from an agent step
Section titled “Call it from an agent step”Sandboxes are on the typed ctx.sapiom.* client, so sapiom_dev_agents_check validates the call at author time:
const sandbox = await ctx.sapiom.sandboxes.create({ name: "build-env", tier: "s", // xs | s | m | l | xl ttl: "1h",});create / get / list / attach manage sandboxes; attach returns a live handle for process, filesystem, and network operations. Autocomplete surfaces the full input and response types. See Using Capabilities.
Call it directly (no agent)
Section titled “Call it directly (no agent)”From any MCP client, reach compute — sandboxes, one-shot code runs, and serverless jobs — through the remote MCP as sapiom_* tools. Run tool_discover with your goal to get the exact tool and a call example. To deploy and preview a web app while authoring, use the sapiom-dev sandbox tools — see Build an Agent.
From your own code
Section titled “From your own code”Outside an agent, call the same capability through the typed client — see SDK & API:
const sandboxes = await sapiom.sandboxes.list();