---
title: "DF0078: Agent Surface Without @devframes/agentic"
description: "This devframe exposes agent tools, but the MCP endpoint stays off: the optional peer \"@devframes/agentic\" is not installed."
canonical_url: "https://devfra.me/errors/df0078"
---
# DF0078: Agent Surface Without @devframes/agentic

> This devframe exposes agent tools, but the MCP endpoint stays off: the optional peer "@devframes/agentic" is not installed.

## Message

> This devframe exposes agent tools, but the MCP endpoint stays off: the optional peer "@devframes/agentic" is not installed.

## Cause

The devframe (or hub) left a non-empty agent surface (RPC functions with an `agent` field, registered agent tools, resources, or providers) and the `mcp` setting is the omitted `'auto'` default, which would mount the MCP route. But `@devframes/agentic`, the optional peer carrying the MCP adapter and the MCP SDK, is not installed, so no route can be served.

The warning is reported once per process; the instance keeps running without an MCP endpoint.

## Fix

Install the peer so the agent surface is served over MCP:

```sh
npm install @devframes/agentic
```

Or, if the tools should deliberately stay unexposed, set `mcp: false` to opt out silently.

## Source

- [`packages/devframe/src/adapters/_shared.ts`](https://github.com/devframes/devframe/blob/main/packages/devframe/src/adapters/_shared.ts): `loadAutoMcpAdapter()` reports this (once) when the agent surface is non-empty but the peer probe fails.


## Sitemap

See the full [sitemap](https://devfra.me/sitemap.md) for all pages.