Tools

Markets & definitions

Five read tools over the operations layer: the account's Shopify markets, and the schema layer — the custom-field and structured-content definitions that tell an assistant what fields exist and how they are typed. All require pim:read.

list_markets_v1

list_markets_v1pim:read

List the account's Shopify markets with their per-store records and the catalogs attached to them — regions, currency, and price-list handles. Read this before reasoning about regional pricing or localization. No arguments.

get_market_v1

get_market_v1pim:read

Get one market with its per-store records and catalogs.

Argument	Type	Description
`id`	string, required	The market id. Must belong to the token's account; cross-account ids return "not found".

list_metafield_definitions_v1

list_metafield_definitions_v1pim:read

List the custom-field definitions an item may carry and how each is typed.

Argument	Type	Description
`owner_type`	string	Narrow to one owner kind: `Product`, `Variant`, or `Collection`.

Read this before writing a metafield.

It tells you the key and the type a value must match before you call update_master_attributes_v1 or update_projection_attributes_v1.

list_metaobject_definitions_v1

list_metaobject_definitions_v1pim:read

List the structured-content types the account defines, each with its field structure and entry count. No arguments. Use list_metaobject_entries_v1 to read the records under one.

list_metaobject_entries_v1

list_metaobject_entries_v1pim:read

List the structured-content records under one metaobject definition, with paging and search.

Argument	Type	Description
`definition_id`	string, required	The metaobject definition's id.
`page`	integer	1-based page number.
`page_size`	integer	Rows per page (clamped at 100 with a visible note).
`search`	string	Free-text search over the entry name and handle.