# X_MCP_SCOPE_UNKNOWN

## Means

defineAppMcp scopes a tool this server does not project

## Typical cause

a `scopes` entry in `defineAppMcp` names a tool by a name absent from the projected catalog — a typo, or the primitive was renamed, or dropped from `actions:`/`queries:`/`tools:`

## Fix

spell it as one of the projected tool names `cause` lists, or drop it from that `scopes` entry

[MCP and AI](/error-codes#mcp-and-ai)