Skip to main content

Quickstart

Prerequisites

Before you begin, make sure you have:

  • A Targetly instance URL (e.g., api.targetly.dev)
  • Docker installed locally (for building MCP servers)
  • An MCP server project ready to deploy

Installation

macOS/Linux (Homebrew)

brew tap Targetly-Labs/tap
brew install targetly

Linux/macOS (Script)

curl -fsSL https://targetly.dev/install.sh | sh

Go Install

go install github.com/Targetly-Labs/Targetly/cli@latest

Verify the installation:

tly --version

Login to Targetly

Authenticate with your Targetly instance:

tly login

You'll be prompted to enter:

  1. API URL - Your Targetly instance endpoint
  2. Credentials - Your authentication token
info

Your auth token is stored securely in ~/.targetly/config.json

Deploy Your First MCP Server

Navigate to your MCP server directory and deploy:

cd my-mcp-tool
tly deploy

The CLI will:

  1. Bundle your project files
  2. Upload to Targetly
  3. Build Docker image
  4. Start container
  5. Return your deployment URL

Example output:

Bundling project... Created bundle (2.4 MB)

Deploying to Targetly... Upload complete

Building Docker image... Build successful

Deployment complete!

Deployment ID: abc123 URL: https://my-tool.prod.targetly.io Status: Running

Access Your Deployment

Check Status

tly list

View Logs

tly logs abc123

Stop Deployment

tly stop abc123

Wake Sleeping Deployment

tly start abc123

Next Steps