get_catalog_item — Retrieve a single catalog item

The get_catalog_item tool returns a single catalog item by catalogItemId within an organization. Use it to resolve the catalogItemId on an invoice line item. intent, organizationId, and catalogItemId are required, 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 that owns the catalog item. Must be one of the organizations the token can access.

string

required

The unique catalog item identifier to retrieve.

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

The requested catalog item.

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.

Example

{
  "jsonrpc": "2.0",
  "id": 13,
  "method": "tools/call",
  "params": {
    "name": "get_catalog_item",
    "arguments": {
      "intent": "User asked for details of the item billed on invoice INV-0042.",
      "organizationId": "org_1",
      "catalogItemId": "item_1"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 13,
  "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"
      }
    }
  }
}

Notes

unitPrice is rounded to cents. Use unitPriceDecimal when you need the exact price.
If the item does not exist or is not accessible with the provided token, the tool returns an MCP error: Catalog item not found or not accessible.

list_catalog_items

Search and list catalog items.

Result conventions

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

Organizations

Transactions

Accounts

Cards

Statements

Contacts

Catalog items

Invoices

get_catalog_item — Retrieve a single catalog item

Scope

Input

Output

Example

Notes

list_catalog_items

Result conventions

​Scope

​Input

​Output

​Example

​Notes

list_catalog_items

Result conventions

Scope

Input

Output

Example

Notes