← All help topics

The command line

Everything in the app can also be done from a terminal with the solution-mcp program. It's useful on computers without a screen, in scripts, and if you simply prefer typing.

On a Mac the program is inside the app. The About page shows where it is.

CommandWhat it does
solution-mcp install [apps…]Set up your AI apps. --dry-run shows what would change.
solution-mcp uninstall [apps…]Remove SolutionMCP from AI apps.
solution-mcp clientsList the supported AI apps and which ones are set up.
solution-mcp doctorThe same checks as the Health check page.
solution-mcp toolsList the tools your AI apps see.
solution-mcp call TOOL key=value …Run a tool yourself.
solution-mcp auditShow recent tool calls.
solution-mcp dashboardOpen the web dashboard.
solution-mcp config path, show, edit, validateFind, show, open or check the settings file.
solution-mcp packs list, export NAME, new NAMEList packs, copy a built-in pack to change it, or start a new one.
solution-mcp secret set, list, removeManage secrets. set asks for the value without showing it.
solution-mcp shareShow a pairing code, to let another computer use this one's tools. With the background service on, it asks the service.
solution-mcp service install, remove, statusThe background service: share this computer from startup.
solution-mcp pair ADDRESS CODEPair with another computer, to use its tools.
solution-mcp computers [remove NAME]List or remove the computers whose tools this one uses.
solution-mcp licenseShow the plan: Free, the trial or a license. activate KEY uses a license here; deactivate frees its place; refresh fetches renewals; app NAME chooses Free's AI app.
solution-mcp setupThe first-run setup in the terminal: how careful, which folders, which tools.
solution-mcp updateUpdate to the newest version, with a progress bar. --check only looks; --yes doesn't ask.
solution-mcp whats-newWhat changed in this version. --all shows every release.
solution-mcp serveRun the server. AI apps do this for you.
solution-mcp token, connectionsFor apps that connect by URL.

Add --profile NAME to use a profile, and -v to see more of what's happening.

Running tools yourself asks first too

solution-mcp call follows your permissions exactly like an AI app, because an AI agent can type commands as easily as you can. A tool that would ask, asks you in the SolutionMCP app or a system dialog, and says it comes from a terminal command. If you didn't just run one, say no. Calls appear on the Activity page as cli.

For a script or scheduled job, allow the tool with a rule instead. There's deliberately no flag to skip the question.

Example

solution-mcp call weather city=Denver