list_catalog_items — Paginated products and services

The list_catalog_items tool returns a paginated list of catalog items, the products and services an organization sells. Every request must include intent and organizationId, and the token must carry the catalog-items.read scope.

Receivables tools require the organization to have invoicing set up in Relay. If it does not, the tool returns an error instead of data.

Scope

Required OAuth scope: catalog-items.read

Input

string

required

The organization to query. Must be one of the organizations the token can access.

string

Free-text search across catalog item fields.

string

Filter by item type. Allowed values: SERVICE, INVENTORY, NON_INVENTORY.

string

Opaque pagination cursor from a previous response. Keep the same pageSize and filters when following cursors. Never parse, edit, or reuse a cursor across different filter sets.

integer

Number of results per page. Must be between 1 and 100. Defaults to 50.

string

required

What the user asked for and why this call serves it, in 1 to 500 characters. Required on every tool call. See Common tool arguments.

Output

CatalogItem[]

required

Array of catalog items matching the filters.

Show CatalogItem

string

required

Unique catalog item identifier. Use this value as catalogItemId.

string

required

Organization the catalog item belongs to.

string

required

Display name of the item.

string

required

Description of the item.

Money | null

required

Unit price as a Money object, rounded to cents. null when no price is set.

string

required

Exact unit price as a decimal string. Use this when a price has more precision than cents.

string

required

Item type. Values: SERVICE, INVENTORY, NON_INVENTORY.

string

required

Stock keeping unit (SKU) of the item.

string

required

Unit the item is sold in, for example hour or each.

string

required

Where the item was created or synced from. Values: relay, quickbooks.

string

required

Timestamp when the item was created, in RFC 3339 format.

string

required

Timestamp when the item was last updated, in RFC 3339 format.

object

required

Cursor-based pagination metadata.

Show Pagination

boolean

required

Whether more results are available.

integer

required

Number of results in this page.

string

Opaque cursor to fetch the next page. Present only when hasNextPage is true.

Example

{
  "jsonrpc": "2.0",
  "id": 12,
  "method": "tools/call",
  "params": {
    "name": "list_catalog_items",
    "arguments": {
      "intent": "User asked what we charge per consulting hour.",
      "organizationId": "org_1",
      "search": "consulting",
      "type": "SERVICE",
      "pageSize": 10
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 12,
  "result": {
    "structuredContent": {
      "data": [
        {
          "id": "item_1",
          "organizationId": "org_1",
          "name": "Consulting hour",
          "description": "Strategy consulting, billed hourly",
          "unitPrice": {
            "cents": 15000,
            "display": "150.00",
            "currency": "USD"
          },
          "unitPriceDecimal": "150.00",
          "type": "SERVICE",
          "sku": "CONSULT-HR",
          "unitOfMeasure": "hour",
          "source": "relay",
          "createdAt": "2026-02-10T12:00:00.000Z",
          "updatedAt": "2026-02-10T12:00:00.000Z"
        }
      ],
      "pagination": {
        "hasNextPage": false,
        "pageSize": 10
      }
    }
  }
}

Notes

unitPrice is rounded to cents. Use unitPriceDecimal when you need the exact price.
Follow nextCursor until hasNextPage is false. Keep the same pageSize and filters on every page.

get_catalog_item

Fetch a single catalog item by ID.

Result conventions

Learn how pagination, Money objects, and dual-channel output work across all tools.

Organizations

Transactions

Accounts

Cards

Statements

Contacts

Catalog items

Invoices

list_catalog_items — Paginated products and services

Scope

Input

Output

Example

Notes

get_catalog_item

Result conventions

​Scope

​Input

​Output

​Example

​Notes

get_catalog_item

Result conventions

Scope

Input

Output

Example

Notes