Skip to main content
Smol Machines logo
  • Category: developer tools
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 12
  • Triggers: 0
  • Slug: SMOL_MACHINES
  • Version: 20261101_00

Tools

Slug: SMOL_MACHINES_CREATE_MACHINECreate one bounded Smol Cloud machine in the stopped state with explicit resources, a finite auto-stop interval and deletion TTL, and an explicit outbound network policy. Published ports remain authenticated by default. The conservative blocked default denies egress and may prevent uncached image pulls; unrestricted networking and unauthenticated public ingress each require explicit opt-in.

Input Parameters

object
Environment variables configured inside the guest. At most 64 entries; keys and values are bounded by Composio policy. Do not include secrets unless the workload should be able to read them.
integer
Requested vCPUs, bounded to 1-8 by Composio policy; the account’s effective maximum may be lower.
string
Optional display name only; later tools still require the exact returned machine id.
array
Guest ports to publish, at most 16. Services must listen on 0.0.0.0. Published ports remain authenticated unless public is explicitly true.
object
Optional labels used by LIST_MACHINES filters. Keys must match the provider’s lowercase label syntax and values are limited to 255 characters.
boolean
Whether published ports allow unauthenticated public ingress. Defaults to false; set true only for a service that provides its own authentication.
integer
Requested disk in GiB, bounded to 1-100 by Composio policy; stored disk can continue billing while stopped.
string
Optional absolute guest working directory used by the machine.
boolean
Whether to use the provider’s ephemeral-machine behavior in addition to the finite TTL.
integer
Requested memory in MiB, bounded to 512-16384 by Composio policy; the account’s effective maximum may be lower.
string ("image" | "smolmachine")
Source kind: a container image reference or a Smol machine reference.
integer
Seconds until provider deletion, bounded to 300-86400 by Composio policy so the resource cannot live indefinitely.
string ("arm64" | "amd64")
Optional requested source architecture; omit to let the provider choose.
string ("allowCidrs" | "blocked" | "open")
Outbound network policy. The default blocked mode denies all egress and may prevent an uncached image pull; choose allowCidrs with at least one host or CIDR for restricted egress, or open explicitly for unrestricted egress.
array
IPv4 or IPv6 CIDR allowlist used only with allowCidrs. Each entry is limited to 253 characters by Composio policy; leave empty for the conservative default.
array
Host allowlist used only with allowCidrs. Each entry is limited to 253 characters by Composio policy; leave empty for the conservative default.
string
required
Provider source reference, such as a documented container image reference.
integer
Idle seconds before compute stops, bounded to 60-3600 by Composio policy. Stopping does not delete storage or end disk billing.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SMOL_MACHINES_DELETE_MACHINEPermanently delete one Smol Cloud machine by its exact machine ID. This irreversible operation removes all machine-local storage, ends its storage billing, and requires explicit confirmation. Export important data before calling this tool. Do not automatically retry after an ambiguous failure.

Input Parameters

string
required
Exact MachineInfo.id to permanently delete, typically beginning mach-. Machine names are not accepted or resolved.
boolean
Whether to request synchronously settled usage and cost in the deletion response. Set false to request the empty 204 response variant.
boolean
required
Must be true to confirm irreversible deletion of the exact machine and all of its machine-local storage. This value is validated locally and is never sent to Smol Machines.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SMOL_MACHINES_DOWNLOAD_FILEDownload and offload one file from an exact cloud machine. Downloads are limited to 10 MB by Composio policy, and the read resets the machine’s auto-stop idle timer.

Input Parameters

string
required
Guest path relative to root, with no leading slash, NUL, empty segment, ’.’ segment, or ’..’ segment; at most 1024 UTF-8 bytes.
string
required
Exact MachineInfo.id; machine names are not accepted or resolved.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SMOL_MACHINES_EXEC_COMMANDRun one bounded foreground argv command on an exact hosted Smol Cloud machine; execution can auto-start billable compute and modify or delete guest data. Text output flagged as truncated or exceeding 524,288 combined bytes is rejected, and the action does not retry automatically.

Input Parameters

string
Optional absolute guest working directory, limited to 1024 UTF-8 bytes by Composio policy.
object
Optional command environment variables. At most 32 entries are allowed; keys are limited to 128 characters, values to 2048 characters, and the combined keys and values to 16384 UTF-8 bytes by Composio policy. Do not place credentials here unless the task explicitly requires exposing them to the guest process.
array
required
Executable and arguments as an argv array, for example [“python”, “—version”]. No shell string parsing is performed. Each item is limited to 4096 characters and the array to 16384 UTF-8 bytes by Composio policy.
string
Optional image user name or numeric uid[:gid]. The provider must fail if the user is unsupported rather than silently selecting another user.
string
Optional non-interactive text sent to standard input, limited to 65536 UTF-8 bytes by Composio policy.
string
required
Exact MachineInfo.id on the hosted provider, typically beginning mach-. Machine names are not accepted or resolved, and execution never falls back to the local host.
integer
Guest command timeout in seconds, bounded to 1-300 by Composio policy. The provider request gets 30 additional seconds of bounded network headroom.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SMOL_MACHINES_GET_ACCOUNTGet the connected account’s status, plan, effective machine limits, billing-period usage, and spend in integer micros.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SMOL_MACHINES_GET_ACCOUNT_USAGEGet metered usage for the connected account’s provider-defined period, keeping the requested and consumed metric windows distinct.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SMOL_MACHINES_GET_MACHINEGet configuration, lifecycle state, and readiness for one cloud machine by its exact machine id, not by name.

Input Parameters

string
required
Exact MachineInfo.id returned by create or list, typically beginning mach-; machine names are not accepted or resolved.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SMOL_MACHINES_GET_MACHINE_USAGEGet billing-period usage and cost in integer micros for one exact machine ID. CPU and memory metering can lag by several minutes while a machine is running, so mid-life usage and cost are a lower bound until metering rolls up; stop and delete trigger a final sample. Deleted machine usage remains available for the provider-documented 30-day lookup period.

Input Parameters

string
required
Exact MachineInfo.id, including a deleted machine ID for up to the provider-documented 30-day lookup period. Machine names are not accepted or resolved.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SMOL_MACHINES_LIST_MACHINESList cloud machines owned by the connected account, optionally requiring all supplied labels to match.

Input Parameters

array
Optional label filters in key=value form; every supplied label must match.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SMOL_MACHINES_START_MACHINEStart one stopped cloud machine by exact machine ID. A detached start returns before readiness and requires polling GET_MACHINE until ready=true.

Input Parameters

boolean
Set true to return immediately after the provider accepts the start. Then poll GET_MACHINE until ready is true. False waits for the blocking start response.
string
required
Exact MachineInfo.id of the stopped machine, not a machine name.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SMOL_MACHINES_STOP_MACHINEStop compute for one cloud machine by exact ID. Normally its filesystem is preserved, stored disk can continue billing, and it continues occupying a plan slot until deletion; an ephemeral machine is deleted when it stops.

Input Parameters

string
required
Exact MachineInfo.id returned by create, list, or get, not a machine name.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SMOL_MACHINES_UPLOAD_FILEUpload a file of at most 8,000,000 bytes to a safe relative guest path on one cloud machine identified by its exact machine ID. This can replace existing guest data and resets the machine’s auto-stop idle timer.

Input Parameters

object
required
File content to write, limited to 8,000,000 bytes.
string
required
Guest path relative to root with no leading slash, empty segments, dot segments, or NUL, for example workspace/app.py.
string
required
Exact MachineInfo.id returned by create or list, not a machine name.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not