Manufact CLI
Deploy and manage MCP servers from the command line with @mcp-use/cli.
An MCP company, writing CLI docs
We live and breathe MCP. Still, we'll admit it: sometimes you just want a terminal. The CLI is for local development, scripted deploys, and running agents on your machine before they graduate to MCP.
@mcp-use/cli is the command-line companion to Manufact Cloud and the mcp-use framework: build and run MCP servers locally, deploy them to Manufact Cloud, and manage servers, deployments, and environment variables without leaving the terminal.
Installation
No install needed, the mcp-use package forwards to the CLI, so you can run commands directly:
npx mcp-use <command>For frequent use, install the CLI globally:
npm install -g @mcp-use/cliBoth expose the same mcp-use binary; if your project already depends on mcp-use, the command is available in your scripts as-is. Requires Node.js ^20.19.0 or >=22.12.0.
Quick tour
# Authenticate with Manufact Cloud
mcp-use login
# Run your MCP server locally with hot reload + inspector
mcp-use dev
# Deploy it to Manufact Cloud
mcp-use deploy
# Watch it run
mcp-use deployments logs <deployment-id> --followCommand reference
Each command has its own page in the sidebar, grouped by area. Start with login for cloud commands, or dev for local development.
| Area | Commands |
|---|---|
| Authentication | login, logout, whoami |
| Organization | org list, org switch, org current |
| Deploy | deploy |
| Servers | servers list, servers get, servers update, servers delete |
| Environment variables | servers env list, add, update, remove |
| Deployments | deployments list, get, restart, logs, stop, start, delete |
| Local development | dev, build, start, generate-types, skills add |
| Terminal client | client connect, list, tools, interactive, screenshot |
Configuration
The CLI stores its state under ~/.mcp-use/:
| File | Purpose |
|---|---|
~/.mcp-use/config.json | API key and active organization (written by login and org switch) |
~/.mcp-use/cli-sessions.json | Servers saved with client connect |
.mcp-use/project.json | Per-project link to its cloud server and deployment (written by deploy) |
A .env file in the current directory is loaded automatically on every command.
Environment variables
| Variable | Purpose | Default |
|---|---|---|
MCP_USE_API_KEY | API key for non-interactive login (CI) | - |
MCP_API_URL | Manufact Cloud API base | https://cloud.mcp-use.com/api/v1 |
MCP_WEB_URL | Web app used for the device login flow | https://manufact.com |
PORT | Port for mcp-use start when --port isn't passed | 3000 |