> ## Documentation Index
> Fetch the complete documentation index at: https://docs.leanmcp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Deployment

> Deploy MCP servers to LeanMCP cloud

# Deployment

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

## Basic Usage

```bash theme={null}
leanmcp deploy [folder]
```

Deploy the current directory:

```bash theme={null}
leanmcp deploy .
```

Deploy a specific folder:

```bash theme={null}
leanmcp deploy ./my-mcp-server
```

## Command Options

| Flag          | Short | Description               |
| ------------- | ----- | ------------------------- |
| `--subdomain` | `-s`  | Subdomain for deployment  |
| `--yes`       | `-y`  | Skip confirmation prompts |

## Example Output

```bash theme={null}
$ 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://leanmcp.com/projects/30a4c8bf-be7f-4a7a-bca7-c2e63e03844a
    Build:      https://leanmcp.com/builds/6f0640ac-d26c-4f66-b2a3-042d6770f916
    Deployment: https://leanmcp.com/deployments/99604138-ef7d-49b5-ab42-71b43eb98844

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

***

## Troubleshooting

### Not Authenticated

```bash theme={null}
Error: Not authenticated

Run: leanmcp login
```

### Build Failures

If the build fails, check the build logs in your dashboard:

```bash theme={null}
✔ Project created: abc123...
✔ Project uploaded
✖ Build failed

Build ID: 6f0640ac-d26c-4f66-b2a3-042d6770f916
View logs: https://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

```bash theme={null}
✖ 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:

```bash theme={null}
leanmcp deploy . --subdomain my-unique-subdomain
```