Where to find Routines
Click Automations in the sidebar. On Overview and Runs, use the Workflows / Routines switch to open Routines. The Routine library is at/routines. It has three views:
- Mine — Routines you created.
- Shared with me — Routines someone shared with you.
- Archived — Routines that can no longer start new runs.
Create a Routine
1
Start from Chat or the library
In Chat, ask in plain language: Create a Routine that…. On the library, click New Routine. Both open an authoring chat with that draft already started.
2
Describe the work
Tell Metal when it should run and what it should do. Chat saves the Routine and its instructions as you go.
3
Review Settings
Open the Routine and check When it runs, the instructions, and What it can use. Turn it On when you are ready for it to start accepting runs.
When it runs
When it runs lists how this Routine starts:- Chat — you (or someone with access) ask in Chat, including from the slash menu’s Routines group. The chip reads When you ask in Chat. A Routine that only supports this shows Starts only when you explicitly request a run in Chat.
- Email — send a message to the address on the Routine. Only people who can see the Routine can start it by email. The run executes as the sender.
- Schedule — the summary shows the cadence, timezone, and next run.
- Webhook — send a JSON POST to the URL on the Routine. Matching requests run with the owner’s access. See Start from a webhook.
- Event — supported events appear as chips. Chat requests and scheduled runs skip the matching step described next.
What it does
These sections on Settings are the definition Metal follows on each run:- What it does — the instructions.
- What a finished run should include — expectations the Routine checks before it finishes. These checks are self-reported, not independently verified.
- What it can use — the skills, connections, and tool permission mode for the run (Ask, Auto, Allow all, or your user default). Allow all runs tool calls without asking, the same as chat permission modes.
Share a Routine
Click Share. Add people or teams and set each grant to Viewer or Editor. Anyone who can view the Routine can view, respond to, approve actions in, and stop all past and future runs. Editors can also edit the Routine and manage sharing. Access is live: if you remove someone, they lose that access on the next request.Archive a Routine
From the Routine’s … menu, choose Archive. Only the Routine owner or Metal staff can archive. Archiving permanently prevents new runs and moves the Routine to Archived. You cannot turn it back on. Existing runs continue.Start from a webhook
If the Routine has a webhook, When it runs shows the URL and how to authenticate. Send a JSON POST to that URL. Authenticate the request the way When it runs instructs. A Routine webhook uses one of two schemes: send the shared secret verbatim in the named header, or, when the Routine uses HMAC-SHA256, sign the raw body with the secret and sendsha256=<hex> in the named header. Matching requests run with the owner’s access.
Only the Routine owner (or Metal staff) can reveal, copy, or rotate the secret. Rotating stops the current secret immediately, so update the sender with the new one. An archived Routine’s webhook is unavailable.
Don’t put credentials in the URL. Query-string authentication isn’t supported.
Run a Routine from MCP
If your admin has enabled the Metal MCP server, an MCP-compatible assistant can list Routines you can access, start a run on a Routine that accepts Chat requests, inspect status, read output, and answer a pending question or one-time permission. Routine run-lifecycle routes exist on the/v1 gateway, but they aren’t in the API reference. Use the Metal app or MCP to work with Routines. Event-only Routines cannot be started by hand from MCP; start those from their trigger instead.
MCP starts runs as the signed-in Metal user, and those runs are labeled Started via MCP in the app. See Run a Routine and the Routines tools.

