The toolbox
52 tools your agent gets in one line
Connect over MCP and every one of these is available to your agent, with OAuth or an API key. Reads and writes to your data are free; you only spend credits when a tool goes out to the real web.
claude mcp add --transport http shopper https://shopper.sh/api/mcpHunt the web
6Find items and stores across the whole web, and go deep when scraping is not enough.
find_itemsComprehensive shopping hunt from a prompt (e.g.
find_local_storesDiscover local stores and sellers on Google Maps (via Apify) and save the new ones to the wish list, deduped by domain then name.
search_webSearch the web (Tavily) for items, listings, prices, and reviews, e.g.
google_searchRun a Google web search via Apify and get organic results (title, URL, snippet) - good for price checks and availability.
deep_shopping_sessionStart a deep-shopping browser session (Browserbase): a real headless browser for hunts that scraping cannot cover - forums, marketplaces, listings tha.
source_manufacturersSource manufacturers and suppliers for a product from a prompt (e.g.
Wish list
6Save, read, update, and check off the things you want to buy.
save_itemSave an item the user wants to the wish list.
list_itemsList items on the wish list, newest first.
update_itemUpdate a saved item: fix the price, add a listing url, move it to a shopping list (listId), attach a seller (sellerId), or set status.
mark_item_purchasedCheck an item off: set it PURCHASED (stamps the purchase time), or back to WANTED. This is the shopping-list check-off.
delete_itemRemove an item from the wish list by id.
search_wishlistSearch across saved items, sellers, and seller contacts in the wish list.
Shopping lists
4Group items into lists an agent works and checks off as they arrive.
list_shopping_listsList the user's shopping lists with item tallies (total and how many are purchased).
get_shopping_listGet a shopping list with all its items (wanted first, then purchased).
create_shopping_listCreate a shopping list with a name and optional goal (e.g.
delete_shopping_listDelete a shopping list by id.
Sellers & sources
9Track, enrich, and vet the stores and makers behind every find.
list_sourcesList sellers and sources (stores, marketplaces, brands, manufacturers) saved in the wish list, newest first.
get_sourceGet one seller or source by id, including its saved seller contacts.
create_sourceSave a seller, store, marketplace, or manufacturer into the wish list (the place that carries the goods).
update_sourceUpdate fields on a saved seller, source, or item record (price changes, status, notes).
enrich_sourceEnrich a seller or manufacturer via Explorium using its domain (company data + firmographics).
delete_sourcePermanently delete a seller, source, or item record from the wish list by id.
verify_sellerVerify a seller or manufacturer against authoritative public registries: GLEIF (global LEI), UK Companies House, and SEC EDGAR (US public companies).
detect_store_techDetect the technologies a store's website uses (ecommerce platform, CMS, payments, support tools, hosting) by fingerprinting its homepage.
extract_seller_detailsExtract a store or seller site's public contact details (emails, phones, social links) via Firecrawl-grade scraping (Apify), deduped and tied to the s.
Seller contacts
7People at stores and manufacturers, for sourcing and quotes.
list_seller_contactsList seller contacts (people at stores, marketplaces, and manufacturers), newest first.
get_seller_contactGet one seller contact by id, including the linked seller and saved email context.
create_seller_contactSave a seller contact (a person at a store, marketplace, or manufacturer).
update_seller_contactUpdate fields on a seller contact (including status and seller assignment).
delete_seller_contactPermanently delete a seller contact from the wish list by id.
enrich_seller_contactFind and save a seller contact's missing LinkedIn, work email, or phone (key for supplier sourcing).
save_email_contextSave an email exchanged with a seller contact (quotes, availability, order threads) onto their record as reusable context.
Collections
4Group seller contacts for sourcing and outreach.
list_collectionsList wish list collections (grouped seller contacts) with member counts.
get_collectionGet a collection and its member seller contacts.
create_collectionCreate a collection manually, optionally with member seller-contact ids.
build_smart_collectionBuild a collection from a goal: vector-matches the closest eligible seller contacts (enriched, not yet contacted, not already on a shopping list).
Outreach & calls
8Reach sellers, place and log calls, and chase quotes.
place_callCall a seller via the user's connected AgentPhone account: the AI phone agent dials the number and follows your systemPrompt (ask about stock, conditi.
list_contact_callsGet the phone-call history with a seller contact (direction, numbers, status, duration, transcript, recording), newest first.
sync_callRefresh a logged call from AgentPhone: pull the latest status, duration, transcript, and recording onto the call record.
log_callRecord a phone call with a seller that happened outside Shopper (for context).
log_outreachRecord that you reached out to a seller or supplier: stamps when, advances status (defaults to CONTACTED), and logs what you said as an activity.
list_due_followupsList seller contacts that need a follow-up (quotes you are waiting on, suppliers who have not replied): in a given status (default CONTACTED) and not.
add_activityLog a timestamped note, call, or reply on a seller contact or seller without overwriting its notes field.
list_activitiesGet the activity trail (outreach, notes, calls, replies) for a seller contact or seller, newest first.
Memory & context
4Durable state every connected agent shares.
get_user_contextRead the About You context: the durable profile that grounds every hunt - sizes, styles and brands loved or avoided, budgets, home and vehicle details.
update_user_contextWrite the About You context.
recallRecall relevant past context (earlier hunts, saved preferences, wish list notes) by similarity.
rememberPersist a durable note or fact to long-term memory so a future session can recall it.
Billing (agent self-pay)
4Agents check balance and buy their own usage with USDC over x402.
get_balanceYour current Shopper usage balance: credits remaining, plan, and when the meter next resets.
get_usageThe Shopper price list: how many credits each metered action costs, the plans you can buy, top-up limits, and your current balance.
buy_creditsBuy more Shopper usage credits with USDC over x402 (pay as you go, $0.01 per credit).
buy_planBuy a Shopper plan for 30 days with USDC over x402 (plus or pro; cheaper per credit than top-ups for sustained work).
Plus Radar, in the app
Standing scans watch the web 24/7 for what you want and drop new finds straight into your wish list. Set them up in the dashboard.