SpocketDOCS
START HERE

Quickstart

Get a bot online from your editor in about two minutes.

What you need

A folder with a bot in it, and an editor that speaks MCP — Claude Code, Claude Desktop, Cursor, Windsurf, Zed. That is the whole list. There is no CLI to install and no config file to write.

No bot yet? Ask your agent to write one. "Write me a Discord bot that responds to /ping, then deploy it to Spocket" is a complete instruction.

Connect your editor

Add Spocket as an MCP server. In most editors that means one entry in a config file:

CLAUDE DESKTOP · CLAUDE_DESKTOP_CONFIG.JSON
{
  "mcpServers": {
    "spocket": {
      "type": "http",
      "url": "https://spocket.dev/api/mcp"
    }
  }
}

Restart the editor. The first time your agent uses Spocket, a browser window opens asking you to allow the connection. Approve it once and you are done — there is no API key to copy, store, or leak.

Claude Code users can skip the file: run `claude mcp add --transport http spocket https://spocket.dev/api/mcp`.

Deploy

Tell your agent what you want. It reads your folder, bundles the files and ships them:

TEXT
Deploy this folder to Spocket as "mod-bot".

The bundle uploads, a container starts, dependencies install, and your entry point runs. A small bot is live in about twenty seconds; one with heavy dependencies takes a minute.

Add your token

Most bots need a secret before they can connect to anything:

TEXT
Set DISCORD_TOKEN on mod-bot to <your token>, then restart it.

The value is encrypted before it is stored. Neither you nor any connected tool can read it back afterwards — only replace it. That is deliberate: a token you cannot retrieve is a token that cannot be exfiltrated by anything holding your credentials.

Pasting a token into a chat puts it in that conversation’s history. For anything that matters, set it in the panel under your bot’s Environment tab instead.

Check it worked

TEXT
What's the status of mod-bot? Show me its logs.

You get the running state, memory, uptime and recent output. If it did not start, the reason is almost always in the first few lines — and your agent can read them and fix the code without you switching windows.

NEXTHow it works