Skip to main content
canonic mcp starts, stops, and reports on the local MCP daemon that exposes canonic’s capabilities to agent clients. See Connecting your agent for the client-side setup.

​
mcp start

Start the local MCP daemon. 
canonic mcp start
canonic mcp start --http --port 7474
FlagDescription
--project, -pPath to the canonic project root (overrides the cwd walk).
--httpStart as a background HTTP daemon instead of the default stdio transport.
--portPort for the HTTP daemon (default 7474).
--hostHost for the HTTP daemon (default 127.0.0.1).
--suggestionsEnable follow-up suggestions in query responses.
Without --http, the daemon runs in the foreground over stdio; the MCP client manages its process lifetime. With --http, it forks a background uvicorn daemon bound to the given host/port. On first start in a project with no active metric contracts, canonic auto-generates inferred metric contracts from the loaded semantic sources before serving.

​
mcp stop

Stop the background MCP daemon. 
canonic mcp stop

​
mcp status

Report whether the MCP daemon is running. 
canonic mcp status
Shows the PID, transport, address (for HTTP), version, and start time. Warns if the running daemon’s version differs from the current CLI version; in which case, restart it with canonic mcp stop && canonic mcp start.