Skip to main content

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 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://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

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://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