# 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.

Source: https://nodaro.ai/docs/mcp/tools/models-and-credits

The **model, credit and preset tools** help an assistant choose and pay for a generation well. `list_models` returns every model with its capabilities and prices, `check_balance` and `credit_transactions` show your credits on Nodaro Cloud, and `list_node_presets` and `get_node_preset` find the ready-made configurations you can apply to a generation.

## `list_models`

Returns the models available on this Nodaro instance, grouped by kind and maker, with a capability sheet for each model. Call it before a generation tool when the user has not chosen a model.

**Permission:** none, always visible. **Credits:** free.

| Parameter | Type | Notes |
| --- | --- | --- |
| `kind` | string | `image`, `video` or `audio`. |
| `mode` | string | One operation, such as `t2i` (text to image), `i2i`, `edit`, `upscale`, `remove-bg`, `i2v` (image to video), `t2v`, `v2v`, `extend`, `motion-transfer`, `lip-sync`, `video-upscale`, `tts`, `music`, `sfx`, `stt`, `voice-design`, `voice-changer`, `voice-changer-pro`, `isolation`, `dubbing`, `forced-alignment`, `video-analysis` or `video-audit`. |
| `family` | string | One maker, such as `Google`, `OpenAI` or `Bytedance`. |
| `featuredOnly` | boolean | Only the best model of each tier, as picked by the Nodaro team. |

**Returns:** for each model, its aspect ratios, resolutions, qualities, durations and features, and on editions with credits, the price of each variant. A `recommendations` list names the best models for common jobs, such as text in images or the cheapest realistic image. Models with model-specific prompting advice, such as Seedance 2.0, also carry `promptTips`, short rules to apply before a video generation.

Every model also has a page in the [model catalog](https://nodaro.ai/docs/models), with the same prices and more detail.

## `check_balance`

Returns your credit balance, split into subscription credits and top-up credits, with their total. It also returns your daily spending cap, your monthly allocation, your tier and the end of the billing period.

**Permission:** `credits:read`. **Credits:** free. **Nodaro Cloud only.**

This tool has no parameters.

**Returns:** the balance and plan details.

- **Which credits go first.** Subscription credits are spent first and reset every billing cycle. Top-up credits stay valid for 12 months after purchase.
- **Pay as you go.** An `effectiveTier` of `payg` means you have no subscription but bought credits. You get every model, no watermark and no daily cap.
- **Shared billing accounts.** On a deployment where one billing account pays for everyone, a connected client cannot read that account's balance. The tool answers `payer_balance_jwt_only`.

## `credit_transactions`

Lists your recent purchases: subscriptions, top-ups and refunds. Each row has `type`, `amount_usd`, `credits_granted`, `tier`, `created_at` and `receipt_url`, the link to the receipt when there is one.

**Permission:** `credits:read`. **Credits:** free. **Nodaro Cloud only.**

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

**Returns:** the purchase rows. The credits spent per generation are not in this list: each job carries its own `credits`, and the REST API lists spending with `GET /v1/credits/transactions`.

## `list_node_presets`

Lists presets for a node type: the built-in ones, such as **Character Board** or **Cinematic Portrait**, and the ones you saved. A preset is a named configuration of a node, with its model, prompt and settings.

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

| Parameter | Type | Notes |
| --- | --- | --- |
| `nodeType` | string | The node type, for example `generate-image`. Required to include the built-in presets. |
| `source` | string | `all` (default) for built-in and saved presets, `factory` for built-in only, `custom` for yours only. |

**Returns:** the name, id and description of each preset.

## `get_node_preset`

Returns the full configuration of one preset: its model, prompt, aspect ratio, resolution, quality, negative prompt, and the text it adds before and after the prompt. Use it to apply a preset exactly, either by copying the fields into a generation tool or by passing its id as `presetId`.

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

| Parameter | Type | Notes |
| --- | --- | --- |
| `nodeType` | string | **Required.** The node type, for example `generate-image`. |
| `presetId` | string | **Required.** A built-in preset id such as `generate-image/location-board`, or the id of your own preset. |

**Returns:** the preset's configuration, or an error when the id matches no preset.

## Apply a preset to a generation

`generate_image`, `generate_video`, `generate_music`, `generate_speech` and `text_to_audio` accept `presetId`. Nodaro applies the preset's configuration on the server, and every field you pass yourself overrides it. When the preset contains a prompt, you can leave `prompt` out. The preset's text before and after the prompt wraps your own prompt.

On `generate_speech`, a preset tunes the delivery, such as speed, stability and style, and `text` is still required. Read more about presets in [Presets](https://nodaro.ai/docs/concepts/presets).

## Frequently asked questions

### How does an assistant choose the right model?

It calls list_models, filtered by kind and mode, for example image and t2i. The answer lists every model's aspect ratios, resolutions, durations, features and prices, plus recommendations such as the best model for text in images.

### Can an assistant see how many credits I have?

Yes, on Nodaro Cloud, when you granted the credits permission. check_balance returns your subscription and top-up credits, your tier and your daily cap.

### Does credit_transactions show what each generation cost?

No. It lists purchases, such as subscriptions, top-ups and refunds. The credits spent per generation are on each job, and the REST API lists them.

### How do I use a node preset through MCP?

Find its id with list_node_presets, then pass presetId to generate_image, generate_video, generate_music, generate_speech or text_to_audio. Fields you pass yourself override the preset.