# Account, access, and updates

## Check your balance and spend

| What you need | MCP | REST with an API key | CLI |
| --- | --- | --- | --- |
| Available USD, outstanding reservations, and funding types | `get_account` | `GET /api/v1/account` | `balance --json` |
| Settled usage, usage refunds, and daily net spend | `get_usage` | `GET /api/v1/account/usage?range=30d` | `usage --range 30d --json` |

MCP and REST use the authenticated account, including its usage across Studio, REST, and MCP. `get_account` also returns `scopes`. The usage range defaults to `30d`. Other choices are `today`, `yesterday`, `7d`, and `90d`. Windows use UTC booking dates and an exclusive end. The 7-, 30-, and 90-day ranges include the current partial day. Money uses eight-decimal USD strings.

`net` is `charged - refunded + historicalNet`. `historicalNet` includes verified historical usage. A refund can be booked in a different window from its charge, so a window may have negative net usage. Unsettled reservations belong to the wallet. `daily` contains the dates with booked activity.

Use the [developer console](/settings/developer) for owned tasks, ledger, receipts, assets, callback records, and encrypted asynchronous exports. Signed-in export downloads expire after five minutes and each export is limited to 10,000 records. Use narrower filters for larger exports. Payment records are account receipts.

## Check permissions and disconnect

`mcp:read` covers catalog, quotes, account, and task queries. `mcp:write` also allows uploads and generation. The OAuth client must request write access and the user must grant it. Check `get_account.scopes` before the first generation. If a client cannot request the scope, use an [API key setup](/docs/mcp/api-key) where supported or [local stdio](/docs/mcp/local-stdio).

To end OAuth access, use [Connections](/settings/connections), select the client, and revoke it. The affected access and refresh credentials stop working. Remove or disable the entry in the client as needed. Manage API keys separately in [API key settings](/me?section=api-keys). Tasks already accepted continue independently. Check their history before submitting again.

## Troubleshoot

| Signal | What to check |
| --- | --- |
| HTTP `401` | Confirm the endpoint, then reconnect OAuth or check that the API key is active. |
| HTTP `403` with an API key | Check the IP allowlist against the client's actual source IP. |
| `insufficient_scope` when uploading or generating | Reauthorize with write access and check `get_account.scopes`. See [Codex](/docs/mcp/codex-cli) and [Claude Code](/docs/mcp/claude-code) for explicit scope settings. |
| HTTP `429` | Follow `Retry-After` when present. For an uncertain submission, use the original idempotency key. |
| No `get_usage` or other newer tool | Refresh the remote tool list or reconnect. For local stdio, run `doctor` and restart after updating. |

## Check versions and install updates

```bash
node i2v-cli.mjs doctor --json
```

`doctor` reads the public release manifest and compares the CLI and its adjacent installed Skill. When `I2V_API_KEY` is configured, it checks the remote server and tool list, including missing workflow tools. Local stdio also checks versions during initialization and can report an available update to the host. Hosted MCP changes are deployed on i2v.ai. Refresh the tool list if your client caches older tools.

For a GitHub-based Skill install, run `npx skills update i2v-models`. For the website package, reinstall with `npx skills add https://i2v.ai --skill i2v-models` in the original install scope. For a standalone CLI, [download the script](/cli/i2v-cli.mjs) again and replace your copy when you choose. Restart local stdio after replacement.

## Handle credentials and files

Use client secret storage or process environment variables for keys. OAuth access is bound to the i2v.ai MCP resource, and tokens and authorization codes are stored as hashes by i2v.ai. The connection can read only the authenticated account's private data. For media storage and deletion details, see [Data retention](/media-retention).