---
title: "DF0048: Unknown Shared-State Key"
description: "Unknown shared-state key \"{key}\"."
canonical_url: "https://devfra.me/errors/df0048"
---
# DF0048: Unknown Shared-State Key

> Unknown shared-state key "\{key}".

## Message

> Unknown shared-state key "`{key}`".

## Cause

The built-in `devframe_state_read` MCP tool was called with a `key` the host doesn't publish (or that the `exposeSharedState` filter excludes).

## Example

```ts
// The host publishes only `my-plugin:counter`; an agent calls:
// devframe_state_read({ key: 'my-plugin:cuonter' }) → DF0048
```

## Fix

Call the `devframe_state_read` tool without arguments to list the available keys, then retry with one of them.

## Source

- [`packages/devframe/src/adapters/mcp/build-server.ts`](https://github.com/devframes/devframe/blob/main/packages/devframe/src/adapters/mcp/build-server.ts): `readStateResult()` throws this when the requested key is absent from the filtered key list.


## Sitemap

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