SpocketDOCS
REFERENCE

MCP tools

Everything a connected agent can do, and the two things it cannot.

The tools

TOOLWHAT IT DOES
spocket_deployShip a folder. Same name means a new version.
spocket_listEvery app with state, memory and uptime.
spocket_statusOne app in detail, including the live container state.
spocket_logsRecent output, up to 500 lines.
spocket_search_logsFind lines matching a term, with context.
spocket_restartRestart, or start if it is already down.
spocket_stopStop without giving up the slot.
spocket_startStart a stopped app.
spocket_set_envSet or replace environment values.
spocket_rollbackReturn to an earlier version.
spocket_migrateMove an app to a different machine.
spocket_nodesWhich machines your apps are on.
spocket_accountPlan, slots used, trial status.
spocket_urlsEvery URL an app answers on: webhook and custom domains.
spocket_add_domainPoint your own domain at an app; returns the DNS to create.
spocket_verify_domainRe-check DNS for a domain you added.
spocket_deletePermanently delete an app. Asks you to confirm by name first.

Moving an app

Rarely needed — a crash restarts on its own, and a machine that fails is evacuated automatically. But if an app is on a machine that is misbehaving, it can be moved:

TEXT
Move mod-app to another machine.

The app is rebuilt from its current version somewhere with room, and the old container is removed only once the new one exists — so a failed move leaves it exactly where it was.

You cannot choose the destination. Which machine an app lands on is a balancing decision, and letting it be picked would let one account concentrate load on a machine other people are using.

What agents cannot do

  • Read an environment value back. Write-only, with no exception for automated callers.
  • Delete an app. Deletion is permanent, so it stays a human decision in the panel.
  • See anything about the machines beyond which ones your own apps are on — not how many exist, nor how full they are.
  • Choose which machine an app is deployed or moved to.

Both limits hold regardless of what the agent is asked to do.

Revoking access

Every connected tool is listed in Settings with when it last called us. Revoking one takes effect immediately — the token stops working on the next request, and reconnecting requires your approval again.

Revoke anything you no longer use. An unused connection is still a live credential.
PREVIOUSRestarts and uptimeNEXTRuntimes and limits