> 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/pay.md).

# pay

Tools for managing vendors, creating and paying bills, sending payouts, scheduling future payments, and tracking expenses.

These tools cover the **Pay** section of the Neucron Console — everything related to outgoing payments and vendor management.

## `neucron_vendor_manage`

**Create, update, delete, list, retrieve, invite, suspend, or accept vendors — all through a single tool.**

A unified vendor management tool. Specify the `action` to perform the desired operation.

| Action    | Description                    |
| --------- | ------------------------------ |
| `create`  | Add a new vendor               |
| `update`  | Update vendor details          |
| `delete`  | Remove a vendor                |
| `list`    | List vendors with pagination   |
| `get`     | Retrieve a single vendor by ID |
| `invite`  | Send a vendor invitation       |
| `suspend` | Suspend a vendor account       |
| `accept`  | Accept a vendor invitation     |

| Parameter | Type   | Description                                   |
| --------- | ------ | --------------------------------------------- |
| `action`  | string | One of the actions above                      |
| `options` | object | Action-specific parameters (varies by action) |

**Example — list vendors**

```json
{
  "action": "list",
  "options": {
    "businessId": "<business-id>",
    "page": 1,
    "size": 20
  }
}
```

**Returns:** Vendor data matching the requested action.

## `neucron_manage_bill`

**Create or update a vendor bill with optional document upload.**

Manages the full bill lifecycle — create new bills, update existing ones, or submit for review. Supports attaching supporting documents (receipts, invoices from vendors).

| Parameter       | Type                                   | Description                                   |
| --------------- | -------------------------------------- | --------------------------------------------- |
| `businessId`    | string                                 | Business ID                                   |
| `mode`          | `"create"` \| `"update"` \| `"review"` | Bill operation mode                           |
| `vendorList`    | object                                 | Optional vendor list filters                  |
| `billID`        | string                                 | Bill ID (required for update/review)          |
| `createPayload` | object                                 | Bill creation data                            |
| `updatePayload` | object                                 | Bill update data                              |
| `review`        | object                                 | Review submission data                        |
| `filePath`      | string                                 | Absolute path to attached document (optional) |
| `fileBase64`    | string                                 | Base64-encoded document (optional)            |

**Returns:** Bill ID, status, and details.

## `neucron_pay_bill`

**Pay an approved bill by creating and triggering a payout.**

Initiates payment for a bill that has been approved. Creates a payout from your wallet to the vendor using the specified asset and amount.

| Parameter       | Type   | Description                            |
| --------------- | ------ | -------------------------------------- |
| `businessId`    | string | Business ID                            |
| `billID`        | string | Approved bill ID                       |
| `payoutPayload` | object | Payout details (asset, wallet, amount) |
| `confirmPayout` | object | Optional payout confirmation data      |

**Example**

```json
{
  "businessId": "<business-id>",
  "billID": "<bill-id>",
  "payoutPayload": {
    "asset_id": "<asset-id>",
    "wallet_id": "<wallet-id>",
    "amount": "1000"
  }
}
```

**Returns:** Payout ID and payment status.

## `neucron_schedule_payment`

**Schedule a future payout for a bill or vendor.**

Sets up a payment to be executed at a future date. Useful for managing cash flow and recurring vendor payments.

| Parameter       | Type   | Description                                           |
| --------------- | ------ | ----------------------------------------------------- |
| `businessId`    | string | Business ID                                           |
| `billID`        | string | Bill ID to schedule payment for                       |
| `payoutPayload` | object | Payout details (asset, wallet, amount, schedule date) |
| `vendorList`    | object | Optional vendor list filters                          |
| `billList`      | object | Optional bill list filters                            |

**Returns:** Scheduled payment ID and execution date.

## `neucron_create_payout`

**Send funds to an email, address, username, paymail, or vendor via payout.**

A flexible payout tool supporting three modes:

| Mode         | Description                                                |
| ------------ | ---------------------------------------------------------- |
| `transfer`   | Direct transfer to a blockchain address, email, or paymail |
| `payout`     | Create and optionally trigger a structured payout          |
| `pay_vendor` | Pay a registered vendor directly                           |

| Parameter             | Type                                         | Description                                             |
| --------------------- | -------------------------------------------- | ------------------------------------------------------- |
| `mode`                | `"transfer"` \| `"payout"` \| `"pay_vendor"` | Payout mode                                             |
| `trigger`             | boolean                                      | Trigger payout immediately after creation (payout mode) |
| `options`             | object                                       | Mode-specific payout parameters                         |
| `updateBeforeTrigger` | object                                       | Update payout details before triggering                 |

**Returns:** Payout ID, status, and transaction details.

## `neucron_get_payout_history`

**List and retrieve payout records with status filters.**

Returns a paginated history of all payouts sent from your business. Can filter by status and retrieve details for a specific payout.

| Parameter      | Type    | Description                               |
| -------------- | ------- | ----------------------------------------- |
| `businessId`   | string  | Business ID                               |
| `pageNumber`   | number  | Page number                               |
| `pageSize`     | number  | Records per page                          |
| `payoutID`     | string  | Specific payout ID to retrieve (optional) |
| Status filters | various | Filter by payout status                   |

**Returns:** Paginated payout records with amounts, recipients, and statuses.

## `neucron_get_expenses`

**Retrieve expense summary and graph analytics for vendor spend.**

Returns expense totals, trends, and breakdowns over a configurable date range. Useful for tracking outgoing payments and vendor spend patterns.

| Parameter          | Type    | Description                                   |
| ------------------ | ------- | --------------------------------------------- |
| `businessId`       | string  | Business ID                                   |
| Date range filters | various | Start/end dates and graph granularity options |

**Returns:** Expense totals, graph data, and vendor spend breakdowns.