Skip to main content

Deployment

Deploy your MCP servers to LeanMCP cloud with a single command.

Basic Usage

leanmcp deploy [folder]
Deploy the current directory:
leanmcp deploy .
Deploy a specific folder:
leanmcp deploy ./my-mcp-server

Command Options

FlagShortDescription
--subdomain-sSubdomain for deployment
--yes-ySkip confirmation prompts

Example Output

$ leanmcp deploy .

LeanMCP Deploy

Generated project name: late-faraday-37
Path: /Users/you/my-mcp-server

 Subdomain for your deployment: late-faraday-37
 Subdomain 'late-faraday-37' is available

Deployment Details:
  Project: late-faraday-37
  Subdomain: late-faraday-37
  URL: https://late-faraday-37.leanmcp.app

 Proceed with deployment? Yes

 Project created: 30a4c8bf...
 Project uploaded
 Build complete (324s)
 Deployed
 Subdomain configured

============================================================
  DEPLOYMENT SUCCESSFUL!
============================================================

  Your MCP server is now live:

  URL:  https://late-faraday-37.leanmcp.app

  Test endpoints:
    curl https://late-faraday-37.leanmcp.app/health
    curl https://late-faraday-37.leanmcp.app/mcp

  Total time: 564s

  Dashboard links:
    Project:    https://ship.leanmcp.com/projects/30a4c8bf-be7f-4a7a-bca7-c2e63e03844a
    Build:      https://ship.leanmcp.com/builds/6f0640ac-d26c-4f66-b2a3-042d6770f916
    Deployment: https://ship.leanmcp.com/deployments/99604138-ef7d-49b5-ab42-71b43eb98844

  Need help? Join our Discord:
    https://discord.com/invite/DsRcA3GwPy

Troubleshooting

Not Authenticated

Error: Not authenticated

Run: leanmcp login

Build Failures

If the build fails, check the build logs in your dashboard:
 Project created: abc123...
 Project uploaded
 Build failed

Build ID: 6f0640ac-d26c-4f66-b2a3-042d6770f916
View logs: https://ship.leanmcp.com/builds/6f0640ac-d26c-4f66-b2a3-042d6770f916
Common build issues:
  • Missing package.json or requirements.txt
  • Invalid TypeScript syntax
  • Missing dependencies

Subdomain Already Taken

 Subdomain 'my-app' is not available

This subdomain is taken by another user. Please choose a different subdomain.
Use the --subdomain flag to specify a different subdomain:
leanmcp deploy . --subdomain my-unique-subdomain