> ## Documentation Index
> Fetch the complete documentation index at: https://stir-vid.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Tools Reference

> All MCP tools, resources, and prompts exposed by StirVid.

## Tools

### `stirvid_status`

Health check. Returns API reachability, generation-service reachability, billing reachability, and the current agent identity.

### `balance`

Reads the current generation-account credit balance.

### `balance_history`

Returns recent balance snapshots. Useful for spotting burn rate.

**Key params:** `limit` (default 20), `since` (ISO timestamp).

### `ledger_list`

Lists entries in the credits ledger: automated purchases, manual top-ups, and adjustments.

**Key params:** `limit`, `source` (`purchase` | `manual_topup` | `adjustment`).

### `ledger_record`

Records a manual funding event into the credits ledger. Used when you top up out of band.

**Key params:** `amount_usd`, `source`, `note`.

### `characters_list`

Returns the character catalog. Filters for `public`, `platform_ready`.

### `generation_create`

Creates a generation job.

**Key params:** `image_url`, `video_url`, `mode` (`std` | `pro`), `sound` (`retain` | `silent`), `character_id`.

### `generation_status`

Polls a job by `task_id`. Returns status, progress, and (on completion) the signed output URL.

### `credits_adjust`

Adjusts a user's `CREDITS` balance. Support / ops use only.

**Key params:** `user_id`, `delta`, `reason`.

## Resources

| URI                            | Purpose                                                           |
| ------------------------------ | ----------------------------------------------------------------- |
| `stirvid://balance`            | Current generation-account balance and StirVid user credits view. |
| `stirvid://ledger`             | Credits ledger, latest entries first.                             |
| `stirvid://characters`         | Character catalog.                                                |
| `stirvid://skills/stirvid-ops` | Skill pack, auto-loaded by agents on connect.                     |

## Prompts

| Name               | Purpose                                                                                      |
| ------------------ | -------------------------------------------------------------------------------------------- |
| `ops-health-check` | Runs `stirvid_status`, `balance`, checks thresholds, summarizes.                             |
| `create-video`     | Guided flow: pick character, set mode, submit `generation_create`, poll `generation_status`. |