[Tools](https://oods-foundry.com/tools) / schema_read

# `schema_read`

Read saved composition schemas.

Generated from @oods/foundry 0.11.0

One of the 26 tools your assistant sees by default.

Use it when listing saved work or loading a named schema; use schema_store to save or delete one. Returns metadata or the schema with a new process-local schemaRef, valid for 30 minutes. Tool input schemas are separate MCP resources. Full schema: oods\://schemas/schema_read.input.json.

## Inputs

| Name | Type | Required | Description |
| - | - | - | - |
| `action` | `"list" \| "load"` | yes | Choose list, load. |
| `name` | `string` | no | Saved schema name in slug format. Actions: load (required). |
| `object` | `string` | no | Object filter. Actions: list. |
| `context` | `string` | no | Rendering-context filter. Actions: list. |
| `tags` | `string[]` | no | Actions: list. |

## Outputs

The package ships no output schema for this tool.

## A real call

Recorded by this site's `tools` run, step `schema-load`, with the published OODS Foundry 0.11.0.

Its input:

```
{
  "action": "load",
  "name": "user-detail"
}
```

Its result:

```
{
  "schemaRef": "compose-b5a992cb",
  "name": "user-detail",
  "version": 1,
  "createdAt": "2026-10-09T05:48:46.637Z",
  "updatedAt": "2026-10-09T05:48:46.637Z",
  "tags": [],
  "object": "User"
}
```

[The whole call, 1 KB of JSON](https://oods-foundry.com/tools/schema-read/call.json)