> For the complete documentation index, see [llms.txt](https://timechain.gitbook.io/neucron-mcp/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://timechain.gitbook.io/neucron-mcp/tools/holdings.md).

# holdings

Tools for managing wallets, viewing balances and transaction history, listing assets, and checking notification logs.

These tools cover the **Holdings** section of the Neucron Console — your financial assets, wallets, and activity.

## `neucron_list_wallets`

**List all wallets for the authenticated user or selected business.**

Returns every wallet associated with your account or business, including wallet IDs, types, and metadata. Use this as a starting point before balance checks, payouts, or invoice creation.

| Parameter    | Type   | Description                                                 |
| ------------ | ------ | ----------------------------------------------------------- |
| `businessId` | string | Business ID (uses `NEUCRON_BUSINESS_ID` default if omitted) |

**Returns:** Array of wallet objects with IDs, names, and types.

## `neucron_create_wallet`

**Create a new MPC or encrypted wallet.**

Creates a wallet on the Neucron platform. Supports MPC (Multi-Party Computation) wallets and encrypted wallets. Optionally initializes the MPC shard via WebSocket during creation.

| Parameter     | Type    | Description                                          |
| ------------- | ------- | ---------------------------------------------------- |
| `businessId`  | string  | Business ID                                          |
| `name`        | string  | Display name for the wallet                          |
| `type`        | string  | Wallet type (MPC or encrypted)                       |
| `refreshList` | boolean | Refresh wallet list after creation (default: `true`) |

**Returns:** New wallet details including wallet ID.

## `neucron_get_balances`

**Fetch asset balances for a wallet across chains and networks.**

Returns the current balance for each asset held in a specified wallet. If no wallet is specified, defaults to the first available wallet.

| Parameter    | Type   | Description                          |
| ------------ | ------ | ------------------------------------ |
| `businessId` | string | Business ID                          |
| `walletID`   | string | Wallet ID (defaults to first wallet) |
| `ledger`     | object | Optional ledger filters              |
| `balances`   | object | Balance query options                |

**Returns:** Asset balances grouped by chain and network.

## `neucron_get_transaction_history`

**Retrieve paginated wallet transaction history with optional filters.**

Returns a list of transactions for a wallet. Supports pagination and optional chain/network filters. Can also fetch detailed information for a single transaction when a transaction ID is provided.

| Parameter        | Type    | Description                                    |
| ---------------- | ------- | ---------------------------------------------- |
| `businessId`     | string  | Business ID                                    |
| `walletID`       | string  | Wallet ID                                      |
| `pageNumber`     | number  | Page number for pagination                     |
| `pageSize`       | number  | Number of records per page                     |
| `includeDetails` | boolean | Fetch full detail for a single transaction     |
| `txid`           | string  | Transaction ID (for single-transaction lookup) |

**Returns:** Paginated list of transactions with amounts, timestamps, and statuses.

## `neucron_export_transaction_history`

**Export filtered transaction history to CSV or JSON.**

Fetches transaction history (optionally across all pages) and generates a downloadable export file in your chosen format.

| Parameter       | Type                | Description                                        |
| --------------- | ------------------- | -------------------------------------------------- |
| `businessId`    | string              | Business ID                                        |
| `walletID`      | string              | Wallet ID                                          |
| `format`        | `"csv"` \| `"json"` | Export format (default: `csv`)                     |
| `fetchAllPages` | boolean             | Fetch all pages before exporting (default: `true`) |

**Returns:** Exported data in the requested format.

## `neucron_get_notification_logs`

**List notification and activity logs, and mark items as read.**

Retrieves platform notifications and activity events for your account. Optionally marks specific notifications as read.

| Parameter         | Type      | Description                      |
| ----------------- | --------- | -------------------------------- |
| `state`           | string    | Filter by notification state     |
| `pageNumber`      | number    | Page number                      |
| `pageSize`        | number    | Records per page                 |
| `notificationIds` | string\[] | Notification IDs to mark as read |

**Returns:** Paginated notification list.

## `neucron_get_asset_list`

**List registered assets with optional filters.**

Returns all assets registered on the Neucron platform that are available to your business, including asset IDs, names, and chain information.

| Parameter          | Type    | Description                 |
| ------------------ | ------- | --------------------------- |
| `businessId`       | string  | Business ID                 |
| Additional filters | various | Optional asset list filters |

**Returns:** List of registered assets.

## `neucron_get_ledger_list`

**List wallet asset ledger entries.**

Returns ledger entries for assets held in a wallet — useful for detailed accounting and reconciliation of asset movements.

| Parameter    | Type      | Description                   |
| ------------ | --------- | ----------------------------- |
| `businessId` | string    | Business ID                   |
| `walletID`   | string    | Wallet ID                     |
| `pageNumber` | number    | Page number                   |
| `pageSize`   | number    | Records per page              |
| `status`     | string\[] | Filter by ledger entry status |

**Returns:** Paginated ledger entries.