Quickstart

The ezforge CLI is currently at v0.1.0 (pre-GA). Commands and flags may change before v1.0.0.

Prerequisites

An ezForge account (sign up free)
Docker installed (for building container images)
Node.js 20+ or Python 3.11+ (if using a template)

Step 1: Install the CLI

Homebrew (macOS / Linux)
Download binary

brew install ezforgeai/tap/ezforge

Download the latest pre-built binary for your platform from GitHub Releases. Available platforms:

macOS (Apple Silicon): ezforge_<version>_darwin_arm64.tar.gz
macOS (Intel): ezforge_<version>_darwin_amd64.tar.gz
Linux (x86_64): ezforge_<version>_linux_amd64.tar.gz
Linux (arm64): ezforge_<version>_linux_arm64.tar.gz
Windows (x86_64): ezforge_<version>_windows_amd64.zip
Windows (arm64): ezforge_<version>_windows_arm64.zip

macOS / Linux — replace <os>_<arch> with your platform (e.g. darwin_arm64 for macOS Apple Silicon, linux_amd64 for Linux x86_64), then extract and move to a directory in your $PATH:

tar xzf ezforge_<version>_<os>_<arch>.tar.gz
sudo mv ezforge /usr/local/bin/

Windows — in PowerShell: Expand-Archive ezforge_*_windows_*.zip -DestinationPath . then move ezforge.exe to a directory in your $PATH.Verify the SHA-256 of your download against checksums.txt attached to the release.

Verify the install:

ezforge --version

Step 2: Authenticate

ezforge auth login

This opens your browser to complete the OAuth flow. Your credentials are saved locally and used for all subsequent commands.

Step 3: Create a project

ezforge project create my-first-project

Projects are workspaces that group servers, API keys, and billing together.

Step 4: Clone the Node.js template

git clone https://github.com/ezforgeai/template-nodejs-mcp-server my-mcp-server
cd my-mcp-server
npm install

The template includes two sample tools out of the box:

echo — returns whatever message you send it
add — adds two numbers and returns the result

Step 5: Deploy

ezforge deploy

ezForge will:

Build your container image
Scan it for vulnerabilities with Trivy
Push it to the registry
Provision a Firecracker microVM
Run a health check at GET /healthz
Swap traffic to the new deployment

Output:

✓ Building image...
✓ Scanning image (0 critical, 0 high)
✓ Pushing to registry...
✓ Provisioning machine in ord...
✓ Health check passed
✓ Deployed!

Your server is live at: https://my-mcp-server.mcp.ezforge.ai

Step 6: Test your server

Connect to your live server from any MCP client:

https://my-mcp-server.mcp.ezforge.ai/sse

Or test the health check directly:

curl https://my-mcp-server.mcp.ezforge.ai/healthz
# {"status":"ok"}

What’s next?

Add authentication

Protect your server with OAuth 2.1

Node.js template guide

Add your own MCP tools to the template

Python template guide

Deploy a Python-based MCP server

CLI reference

Full CLI command reference

Getting Started

Concepts

Templates

Changelog

Prerequisites

Step 1: Install the CLI

Step 2: Authenticate

Step 3: Create a project

Step 4: Clone the Node.js template

Step 5: Deploy

Step 6: Test your server

What’s next?

Add authentication

Node.js template guide

Python template guide

CLI reference

​Prerequisites

​Step 1: Install the CLI

​Step 2: Authenticate

​Step 3: Create a project

​Step 4: Clone the Node.js template

​Step 5: Deploy

​Step 6: Test your server

​What’s next?

Add authentication

Node.js template guide

Python template guide

CLI reference

Prerequisites

Step 1: Install the CLI

Step 2: Authenticate

Step 3: Create a project

Step 4: Clone the Node.js template

Step 5: Deploy

Step 6: Test your server

What’s next?