---
title: "Keep Resource examples consistent with declarations"
description: "Resource example contents are compared with the declaration's requested URI, MIME type, and declared raw size. A mutable resource can differ between observations, so size differenc"
source: "https://mcpdesc.org/docs/rules/0.9.0-rc.3/mcpdesc/resource-example-consistency/"
---

Resource example contents are compared with the declaration’s requested URI, MIME type, and declared raw size. A mutable resource can differ between observations, so size differences are warnings. Review the example and declaration together rather than inferring live content.

## Requirement

Resource example contents agree with their declaration: the requested URI is returned, MIME types match, and raw size matches a declared size.

## Details

**Rule ID:** `mcpdesc.resource.example.consistency`  
**Owner:** mcpdesc  
**Surface:** Resource example · **Path:** `result.contents`  
**Kind:** mcpdesc-semantic  
**Requirement level:** should  
**Protocol versions:** independent of the MCP protocol version  
**Status:** internal · **Enforcement:** internal

## Required by

* **MCP Description 0.9.0, Section 10.4.4**  
  * 10\. Resources and Resource Templates: [req-resource-example-requested-uri](https://mcpdesc.org/docs/specification/0.9.0-rc.3/resources#req-resource-example-requested-uri)
  * 1. Resources and Resource Templates: [req-resource-example-mime-type](https://mcpdesc.org/docs/specification/0.9.0-rc.3/resources#req-resource-example-mime-type)
  * 1. Resources and Resource Templates: [req-resource-example-size](https://mcpdesc.org/docs/specification/0.9.0-rc.3/resources#req-resource-example-size)

## Notes

Collections and indirect reads may legitimately differ, so these are warnings.

## Examples

### Accepted with a warning

Source: [expected-warning/resource-example-consistency.json](https://github.com/mcpdesc/mcpdesc-specification/blob/v0.9.0-rc.3/spec/draft/fixtures/expected-warning/resource-example-consistency.json) · Selected: `/resources/0/examples/collection-snapshot/result`

```json
{
  "contents": [
    {
      "uri": "collection:///items/one",
      "mimeType": "application/vnd.example.item+json",
      "text": "{\"id\":1}"
    }
  ]
}
```

## Rule Source Code

[resource.yaml](https://github.com/mcpdesc/mcpdesc-specification/blob/v0.9.0-rc.3/spec/draft/validation/rules/resource.yaml) at immutable tag [v0.9.0-rc.3](https://github.com/mcpdesc/mcpdesc-specification/blob/v0.9.0-rc.3/spec/draft).