---
title: "get_usage: Get usage"
description: "Read what the account spent and made in a week or month: credits, images, seconds of video and audio, and credits per model, with the comparable period before and the last 30 days of credits per day."
canonical_url: "https://meetkuro.com/agents/tools/get_usage/"
updated: 2026-11-03
locale: "en"
tool: "get_usage"
scopes: ["media.read"]
---

# get_usage

**Get usage**

Read what the account spent and made in a week or month: credits, images, seconds of video and audio, and credits per model, with the comparable period before and the last 30 days of credits per day. previous=true reads the last closed period instead of the one in progress. Explain limits; never offer purchases.

## 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 what the account spent and made in a week or month: credits, images, seconds of video and audio, and credits per model, with the comparable period before and the last 30 days of credits per day. previous=true reads the last closed period instead of the one in progress.

## Inputs

| Name | Type | Required | Details |
| --- | --- | --- | --- |
| `period` | string | no | one of "week", "month" |
| `previous` | boolean | no | — |

## 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_usage",
    "arguments": {}
  }
}
```

## Input schema

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

```json
{
  "type": "object",
  "properties": {
    "period": {
      "type": "string",
      "enum": [
        "week",
        "month"
      ]
    },
    "previous": {
      "type": "boolean"
    }
  },
  "additionalProperties": false
}
```

## Related tools

- [`list_generations`](https://meetkuro.com/agents/tools/list_generations.md): Search and page through the user's image, clip and audio generations.
- [`get_generation`](https://meetkuro.com/agents/tools/get_generation.md): Get current status and signed media URL for one generation.
- [`list_models`](https://meetkuro.com/agents/tools/list_models.md): Read the full capability envelope for the models a room can run: aspect ratios, durations, resolutions, reference capacities, which inputs a model requires, and — for voice — its complete voice roster and the languages it speaks.
- [`get_credits`](https://meetkuro.com/agents/tools/get_credits.md): Use only the account's existing entitlements: when work is unavailable, explain the limit without offering purchases, upgrades, subscriptions or checkout links.
- [`send_feedback`](https://meetkuro.com/agents/tools/send_feedback.md): Tell Kuro's team when no tool can do what the user asked (missing_tool), a tool failed in a way its error did not explain (bug), a tool's behaviour was unclear (confusing), or a result did not match the request (wrong_result).
- [`get_account_context`](https://meetkuro.com/agents/tools/get_account_context.md): Read what Kuro knows about the user before making anything: their name and language, what they optimize for when a model is picked (image_priority and clip_priority: best, balanced or cheapest; null until asked once), goals, their own words about what they make, their material, their brand note, the subjects they keep, and the shapes and kinds they usually make.
- [`get_benchmark`](https://meetkuro.com/agents/tools/get_benchmark.md): Which model to use for a job, in three tiers (best, middle, cheapest), priced for this account: credits per reference request, who pays (`paid_by`: one of the user's own keys at no credits, the house's free allowance, or credits) and whether that payer can now (`affordable`), plus the account's two priorities (image_priority, clip_priority: best, balanced or cheapest) and, per task, the `selected…
- [`get_upload_link`](https://meetkuro.com/agents/tools/get_upload_link.md): Read a link from request_upload_link: the files the user has sent through it so far, each with the `reference` the generate tools take, and whether it still takes more.

---

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