# Gallery and assets

> Browse your Nodaro gallery and uploads, show a result in the chat, read a job's details, follow an app run and mark favorites from an AI assistant.

Source: https://nodaro.ai/docs/mcp/tools/gallery-and-assets

The **gallery and asset tools** let an assistant find, show and reuse what you already made in Nodaro. `browse_gallery` and `browse_uploads` show your results and your uploads as a grid, `get_asset` and `display_asset` fetch or show one result, `get_app_run` follows a workflow or app run, and `list_favorites` and `favorite_asset` manage your favorites. None of them costs credits.

## `browse_gallery`

Shows your gallery as an interactive grid of thumbnails. You can click a tile to view it, copy it, or use it in the next edit. Use it when the user wants to see their work; use [`list_jobs`](https://nodaro.ai/docs/mcp/tools/jobs#list_jobs) when the assistant only needs data.

**Permission:** `assets:read`. **Credits:** free.

| Parameter | Type | Notes |
| --- | --- | --- |
| `scope` | string | `mine` (default) for your own library, or `public` for recent public results of other users. |
| `kinds` | array | Media kinds to include: any of `image`, `video`, `audio`. Default `["image", "video"]`. |
| `kind` | string | One media kind: `image`, `video` or `audio`. |
| `query` | string | A word to search for in the prompts, up to 200 characters, for example `rabbit`. |
| `limit` | integer | From 1 to 200. Default `50`. |
| `cursor` | string | The `next_cursor` of the previous page. |

**Returns:** the grid in clients that display MCP Apps, and the items with a `next_cursor` as data.

## `browse_uploads`

Shows the files you uploaded, as opposed to the results Nodaro generated. Use it to pick an earlier upload as the input of a new generation. The grid's **Use** button hands the file's id back to the chat.

**Permission:** `assets:read`. **Credits:** free.

| Parameter | Type | Notes |
| --- | --- | --- |
| `kind` | string | `image`, `video` or `audio`. Omit it for every upload. |
| `search` | string | Part of a file name, up to 200 characters. |
| `limit` | integer | From 1 to 100. Default `40`. |
| `cursor` | string | The `nextCursor` of the previous page. |

**Returns:** the uploads with their URLs and ids, and a `nextCursor`.

## `get_asset`

Returns the details of one result: its output URL, prompt and model. It returns your own jobs in any status, and the public, completed jobs of other users. For a failed job, it adds `retryable`, `guidance` and, when available, `suggestedProvider`; [When a job fails](https://nodaro.ai/docs/mcp/tools/jobs#when-a-job-fails) explains them.

**Permission:** `assets:read`. **Credits:** free.

| Parameter | Type | Notes |
| --- | --- | --- |
| `job_id` | string | **Required.** The job id of the result. |

**Returns:** the [job envelope](https://nodaro.ai/docs/mcp/tools/jobs#the-job-envelope), without `input`.

## `display_asset`

Shows one result in the chat: the user sees the image, video or audio instead of data. Images also get **Animate**, **Edit** and **Recreate** buttons and a full-screen view. Use `get_asset` when the assistant only needs the details.

**Permission:** `assets:read`. **Credits:** free.

| Parameter | Type | Notes |
| --- | --- | --- |
| `job_id` | string | **Required.** Your own job in any status, or another user's public, completed job. |

**Returns:** the media card, with the result's details as data.

## `get_app_run`

Returns the progress of a workflow run or a published app run: its status, the state of each node, and every output URL produced so far, with its prompt, model and job id. Use it after [`run_workflow`](https://nodaro.ai/docs/mcp/tools/projects-and-workflows#run_workflow) and [`run_app`](https://nodaro.ai/docs/mcp/tools/apps-and-components#run_app), which return a run id instead of a job id.

**Permission:** `assets:read`. **Credits:** free.

| Parameter | Type | Notes |
| --- | --- | --- |
| `execution_id` | string | **Required.** The run id. |

**Returns:** the run's status, the node states and the outputs so far.

## `list_favorites`

Lists the job ids of your favorite results, newest first.

**Permission:** `assets:read`. **Credits:** free.

| Parameter | Type | Notes |
| --- | --- | --- |
| `limit` | integer | From 1 to 100. |
| `cursor` | string | The cursor of the previous page. |

**Returns:** the job ids of your favorites.

## `favorite_asset`

Adds a result to your favorites or removes it.

**Permission:** `assets:write`. **Credits:** free.

| Parameter | Type | Notes |
| --- | --- | --- |
| `job_id` | string | **Required.** The result to mark. |
| `favorited` | boolean | **Required.** `true` adds the favorite, `false` removes it. |

**Returns:** a confirmation.

## Frequently asked questions

### How do I see my Nodaro gallery in Claude?

Ask to see your gallery. browse_gallery shows your recent images and videos as a grid you can click, and it can also search your prompts, for example for every image with a rabbit.

### What is the difference between browse_gallery and browse_uploads?

browse_gallery shows the results Nodaro generated for you. browse_uploads shows the files you uploaded yourself, so you can pick one as the input of a new generation.

### Can the assistant use a result from the public gallery?

Yes. get_asset and display_asset return your own jobs and any other user's public, completed jobs, so the assistant can pass a public result's URL to another tool.

### How do I follow a workflow run that an assistant started?

Call get_app_run with the run id that run_workflow or run_app returned. It shows the run's status, the state of each node and every output produced so far.