Deploying to the cloud with Arcade Deploy

This guide shows you how to deploy your Server with Arcade Deploy.

Requirements

Python 3.10 or higher
Verify your Python version by running python --version or python3 --version in your terminal.
Arcade : Sign up for an Arcade account if you haven’t already.
Arcade CLI: Install the Arcade CLI

uv

Terminal


uv pip install arcade-ai

Create your deployment config

Create a worker.toml file in your directory:

YAML


### Worker 1
[[worker]]
 
[worker.config]
id = "my-worker"
secret = <your secret> # Replace with your own secret
 
[worker.local_source]
packages = ["./<your-mcp-server-directory>"] # Replace with the path to your MCP Server directory

For more information on the worker.toml file, see the Arcade Deploy documentation.

Deploy your worker

Run the deploy command in the directory containing your worker.toml file:

Terminal


arcade deploy

You should see output like the following:

Terminal


Deploying 'my-worker...'                                                                                                                                                                                                                                                                                                                 main.py:589
⠏ Deploying 1 workers
┏━━━━━━━━━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━━━━┓
┃        Added   ┃ Removed ┃ Updated ┃ No Changes ┃
┡━━━━━━━━━━━━━━━━━╇━━━━━━━━━╇━━━━━━━━━╇━━━━━━━━━━━━┩
│  custom-tools  │        │         │           │
└─────────────────┴─────────┴─────────┴────────────┘
✅ Worker 'my-worker' deployed successfully.

List your workers

Run the following command to list your workers:

Terminal


arcade worker list

You should see output like the following:

Terminal


                                                     Workers
┏━━━━━━━━━━━┳━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┓
┃ ID        ┃ Cloud Deployed ┃ Engine Registered ┃ Enabled ┃ Host                                                ┃ Toolkits      ┃
┡━━━━━━━━━━━╇━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━┩
│ my-worker │ True           │ True              │ True    │ https://4bdfrgfdgftlu0ahyko56gdsr.server.arcade.dev │ CustomMCP Tools │
└───────────┴────────────────┴───────────────────┴─────────┴─────────────────────────────────────────────────────┴───────────────┘

Your worker and Servers are now deployed and registered with the engine and ready to use!

You can go to the dashboard to see your worker and its details.