lua mcp lists the MCP servers attached to the agent and turns each one on or off. An active server’s tools are available to the model; a deactivated server’s tools are not.
Verified against lua-cli 3.33.0.
Synopsis
Description
With no action the command opens a menu covering every action. Every action runs against production.list prints active servers first, then inactive ones, each with its transport, URL, and ID. It includes the servers lua integrations connect creates for connected SaaS accounts as well as servers you define with LuaMCPServer.
activate and deactivate change whether the server’s tools are offered to the model. Both are no-ops with exit 0 when the server is already in the requested state.
delete removes the server from the agent. The non-interactive form has no confirmation prompt; only the menu asks. To get the server back, push it again.
The server name can be given as the positional argument or with --server-name; matching is case-insensitive. Every form needs a project directory and a credential.
MCP servers are not versioned and are not a lua deploy type. A server goes live when it is active: define it with LuaMCPServer, register it on the LuaAgent, and push it with lua push mcp --name <name>. That push asks whether to activate the server straight away (default No); --auto-deploy activates without asking, and --force alone skips the question and leaves the server inactive. lua push all pushes servers without activating them and ignores --auto-deploy, so follow it with lua mcp activate <name>.
Arguments
Accepted spellings:
ls, l → list; on, enable → activate; off, disable → deactivate; rm, remove, del → delete.
Options
Examples
List the servers; integration-created servers appear alongside your own.Output
Exit codes
The full table is in Errors and exit codes.
See also
LuaMCPServer— transport, URL, and headers- Use an MCP server
lua push—lua push mcpand--auto-deploylua integrations—lua integrations mcpfor integration-created serverslua logs—--type mcp