DF0079: MCP Enabled Without @devframes/agentic

The mcp option is enabled, but the optional peer "@devframes/agentic" could not be loaded: {reason}

Message

The mcp option is enabled, but the optional peer "@devframes/agentic" could not be loaded: {reason}

Cause

An explicit mcp setting (true, a route options object, the --mcp flag, or the mcp CLI subcommand) asked for an MCP surface, but the implementation could not be loaded from the optional @devframes/agentic peer, typically because it is not installed. Unlike the omitted 'auto' default (which degrades to a one-time DF0078 warning), an explicit opt-in fails fast rather than silently running without MCP.

Fix

Install the peer next to devframe:

npm install @devframes/agentic

Or remove the explicit mcp setting (or pass mcp: false) if the endpoint isn't wanted. The underlying import error is attached as cause.

Source