get_merchants
Updated May 19, 20261 min read
List merchants the current user can use within a tenant.
The natural follow-up to get_accessible_tenants. Once the agent
knows which tenant the user wants to work in, this tool tells it
which merchants are in scope.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
tenantId | string | Yes | The tenant to list merchants in. |
Returns
An array of merchants — typically { merchantId, merchantName, ...}
plus any per-merchant config the user is permitted to see.
Example agent prompt
"Which merchants are configured in this tenant?"
get_merchants(tenantId="…")
Common chain
The standard "agent first turn":
get_accessible_tenants → get_merchants → …user's question…
When the user explicitly mentions a merchant by name, the agent
should still call get_merchants once per session to map the name
to the merchant id used by other tools.
Related tools
get_accessible_tenants— precedes this call.- Most shipment and report tools accept
merchantas a filter to scope to one or more merchant ids returned here.
Notes
- The merchant list is small and stable; cache for the session.