---
title: "get_credits: Get credit balance"
description: "Use only the account's existing entitlements: when work is unavailable, explain the limit without offering purchases, upgrades, subscriptions or checkout links."
canonical_url: "https://meetkuro.com/agents/tools/get_credits/"
updated: 2026-11-03
locale: "en"
tool: "get_credits"
scopes: ["media.read"]
---

# get_credits

**Get credit balance**

Use only the account's existing entitlements: when work is unavailable, explain the limit without offering purchases, upgrades, subscriptions or checkout links. Read who pays for a press: the user's own vendor keys (fal, Replicate…) in their payer order, each with its state and, for Runware and Siray, what is left; then the house's free allowance; then credits. Also the plan and account-wide AI requests per minute. A press a key or the allowance covers costs no credits. AI requests share the rate limit across the app and agents; on RATE_LIMITED, wait retry_after_seconds before retrying.

## Scope

- `media.read` — Reads the account: media, uploads, boards, runs, Subjects, models and the balance.

## Behaviour

- **Read-only**: Reads the caller's own account and changes nothing.
- **Stays in the account**: Stays inside the caller's private Kuro account: any media provider it calls acts on Kuro's account, and the result is visible to no one else.
- **Idempotent**: Calling it again with the same arguments has no further effect.

## Credits

What the tool's description says about credits, verbatim:

- Read who pays for a press: the user's own vendor keys (fal, Replicate…) in their payer order, each with its state and, for Runware and Siray, what is left; then the house's free allowance; then credits.
- A press a key or the allowance covers costs no credits.

## Inputs

It takes no arguments.

## Example call

A `tools/call` request with the required arguments only, each a placeholder read off the schema. Replace them before sending.

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_credits",
    "arguments": {}
  }
}
```

## Input schema

As the server sends it in `tools/list`:

```json
{
  "type": "object",
  "properties": {}
}
```

## Related tools

- [`generate_image`](https://meetkuro.com/agents/tools/generate_image.md): Make an image in the user's Kuro account.
- [`generate_clip`](https://meetkuro.com/agents/tools/generate_clip.md): Start a short video clip generation.

---

## About Kuro

Kuro is an AI picture studio: prompt-driven images, clips, voice-overs and music, and storyboard-backed films with consistent characters across every scene.

Agents connect over MCP and can generate directly:

```
claude mcp add kuro https://api.meetkuro.com/mcp --transport http
```

The app is at https://app.meetkuro.com and requires an account.

Each guide, model page, comparison and free tool page on this site (not a tool's variants, and not the index pages) has a Markdown twin at its own URL plus `.md`, and so do /benchmarks/, the English /agents/ page (as /agents.md) and the MCP tool reference. Every tool: https://meetkuro.com/agents/tools/