Nodaro DocsGallery 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.
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 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 explains them.
Permission: assets:read. Credits: free.
| Parameter | Type | Notes |
|---|---|---|
job_id | string | Required. The job id of the result. |
Returns: 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 and 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
Related
Jobs
Uploads
Apps and components
Assets and media
Last updated on
Uploads
Upload your own images, audio and video to Nodaro from any MCP client with an in-chat picker, a browser upload link, or a presigned URL from a shell.
Models, credits and presets
List Nodaro models with their capabilities and credit prices, read your credit balance and purchases, and find and apply node presets from an AI assistant.