# get_credits

> Get credits with Wavegrain's MCP server: the get_credits tool needs the read permission. Inputs, outputs and an example call.

> Index of these docs: https://wavegrain.com/developers/llms.txt

**Get credits.** Permission: `read`. Read-only: changes nothing.

The plan, credit balance, this month's slideshow count, and this key's daily cap with what it used in the last 24 hours.

## Inputs

No inputs.

The fields inside an object or a list are in the JSON Schema at [/developers/mcp-tools.json](/developers/mcp-tools.json).

## Returns

| Field | Type | Notes |
| --- | --- | --- |
| `plan` | string | The user's plan key; free when there is no paid plan. |
| `credits` | number | Credits left now. |
| `creditsMax` | number | Credits the plan gives each month. |
| `carouselsThisMonth` | number | Slideshows made this calendar month. |
| `carouselsMax` | number | Slideshows the plan allows each month; -1 means no limit. |
| `trial` | object | The user's trial, if any. |
| `token` | object | The spend limit of the key or connection that called. |

## Example call

Send it to `POST https://wavegrain.com/api/mcp` with an access key that has the `read` permission; [Authentication](/developers/authentication) shows how to make one.

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

## Related tools

- [`list_calendar`](/developers/mcp-tools/list_calendar): List the calendar
- [`list_collections`](/developers/mcp-tools/list_collections): List image collections
- [`list_collection_images`](/developers/mcp-tools/list_collection_images): List a collection's images
- [`list_creators`](/developers/mcp-tools/list_creators): List AI creators
- [`list_styles`](/developers/mcp-tools/list_styles): List tailored styles
- [`get_style`](/developers/mcp-tools/get_style): Get a style
- [All 79 tools](/developers/mcp-tools)
