get_health
Health & tag status
Health check for Home Office Builder. Returns ok, storage, paapi, trackingTag, tagConfigured, domain, catalogCount. tagConfigured is false until real Associates IDs are set (links omit tag=). OpenAPI: getHealth.
Takes no parameters.
search_desk_gear
Search desk gear
Search Amazon for home-office desk gear on the user's marketplace. Filter by role + budgetBand. Returns PA-API products when configured, otherwise desk-setup search deep-link cards + catalogMatches. ALWAYS pass marketplace + locale. Amazon URLs omit tag= until tagConfigured is true. OpenAPI: searchAmazon.
ParametersqrequiredrolelimitlocalerequiredbudgetBandmarketplacerequired
get_catalog
Curated desk catalog
Paginated curated desk starters (~51). Prefer search_desk_gear for discovery. ALWAYS pass marketplace + locale. Filter by role + budgetBand. OpenAPI: getCatalog.
ParametersqrolelimitlocalerequiredoffsetcategorybudgetBandmarketplacerequired
resolve_product
Resolve buy / product link
Resolve an ASIN, pasted Amazon /dp/ URL, or keywords to an buyUrl (product /dp or desk search). ALWAYS pass marketplace + locale. Does not invent tracking tags — when unset, URLs omit tag= and tagConfigured is false. OpenAPI: resolveProduct.
ParametersurlasinrolelocalerequiredkeywordsbudgetBandmarketplacerequired
create_desk_board
Create desk board
Create a home-office desk board (wishlist). Returns id, editToken, ownerUrl, shopUrl, wishlist, storage. Save editToken for add_desk_item. Prefer create_and_fill for one-shot. OpenAPI: createWishlist.
ParametersroleitemslocaledeskNamebudgetBandpersonNamemarketplace
create_and_fill
One-shot create and fill
One call: create a curated home office setup gift wishlist and return shopUrl (share link) + ownerUrl. Preferred agent path: create a desk board and add ASINs / keywords / search queries in one call. Pass marketplace + locale + role + budgetBand. Returns id, editToken, ownerUrl, shopUrl. OpenAPI: agentCreateAndFill.
ParametersrolelocaledeskNameitemAsinsbudgetBandpersonNameitemQueriesmarketplaceitemKeywords
get_desk_board
Get desk board
Fetch a desk board by id. Returns items with buy links when available, plus ownerUrl and shopUrl. OpenAPI: getWishlist.
Parametersidrequired
add_desk_item
Add desk item
Add an item to a desk board. Requires editToken from create. Body: name/title plus asin, url (pasted /dp), searchKeywords, or catalogId. Token storage may return a new id — update bookmarks. OpenAPI: addWishlistItem.
ParametersidrequiredurlasinnameemojititlecatalogIdeditTokenrequiredsearchKeywords