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/mcp
One line. Your agent gets 52 tools, shared memory, and a wallet.

Hunt the web

6

Find items and stores across the whole web, and go deep when scraping is not enough.

  • find_items

    Comprehensive shopping hunt from a prompt (e.g.

  • find_local_stores

    Discover local stores and sellers on Google Maps (via Apify) and save the new ones to the wish list, deduped by domain then name.

  • search_web

    Search the web (Tavily) for items, listings, prices, and reviews, e.g.

  • google_search

    Run a Google web search via Apify and get organic results (title, URL, snippet) - good for price checks and availability.

  • deep_shopping_session

    Start a deep-shopping browser session (Browserbase): a real headless browser for hunts that scraping cannot cover - forums, marketplaces, listings tha.

  • source_manufacturers

    Source manufacturers and suppliers for a product from a prompt (e.g.

Wish list

6

Save, read, update, and check off the things you want to buy.

  • save_item

    Save an item the user wants to the wish list.

  • list_items

    List items on the wish list, newest first.

  • update_item

    Update 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_purchased

    Check an item off: set it PURCHASED (stamps the purchase time), or back to WANTED. This is the shopping-list check-off.

  • delete_item

    Remove an item from the wish list by id.

  • search_wishlist

    Search across saved items, sellers, and seller contacts in the wish list.

Shopping lists

4

Group items into lists an agent works and checks off as they arrive.

  • list_shopping_lists

    List the user's shopping lists with item tallies (total and how many are purchased).

  • get_shopping_list

    Get a shopping list with all its items (wanted first, then purchased).

  • create_shopping_list

    Create a shopping list with a name and optional goal (e.g.

  • delete_shopping_list

    Delete a shopping list by id.

Sellers & sources

9

Track, enrich, and vet the stores and makers behind every find.

  • list_sources

    List sellers and sources (stores, marketplaces, brands, manufacturers) saved in the wish list, newest first.

  • get_source

    Get one seller or source by id, including its saved seller contacts.

  • create_source

    Save a seller, store, marketplace, or manufacturer into the wish list (the place that carries the goods).

  • update_source

    Update fields on a saved seller, source, or item record (price changes, status, notes).

  • enrich_source

    Enrich a seller or manufacturer via Explorium using its domain (company data + firmographics).

  • delete_source

    Permanently delete a seller, source, or item record from the wish list by id.

  • verify_seller

    Verify a seller or manufacturer against authoritative public registries: GLEIF (global LEI), UK Companies House, and SEC EDGAR (US public companies).

  • detect_store_tech

    Detect the technologies a store's website uses (ecommerce platform, CMS, payments, support tools, hosting) by fingerprinting its homepage.

  • extract_seller_details

    Extract 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

7

People at stores and manufacturers, for sourcing and quotes.

  • list_seller_contacts

    List seller contacts (people at stores, marketplaces, and manufacturers), newest first.

  • get_seller_contact

    Get one seller contact by id, including the linked seller and saved email context.

  • create_seller_contact

    Save a seller contact (a person at a store, marketplace, or manufacturer).

  • update_seller_contact

    Update fields on a seller contact (including status and seller assignment).

  • delete_seller_contact

    Permanently delete a seller contact from the wish list by id.

  • enrich_seller_contact

    Find and save a seller contact's missing LinkedIn, work email, or phone (key for supplier sourcing).

  • save_email_context

    Save an email exchanged with a seller contact (quotes, availability, order threads) onto their record as reusable context.

Collections

4

Group seller contacts for sourcing and outreach.

  • list_collections

    List wish list collections (grouped seller contacts) with member counts.

  • get_collection

    Get a collection and its member seller contacts.

  • create_collection

    Create a collection manually, optionally with member seller-contact ids.

  • build_smart_collection

    Build a collection from a goal: vector-matches the closest eligible seller contacts (enriched, not yet contacted, not already on a shopping list).

Outreach & calls

8

Reach sellers, place and log calls, and chase quotes.

  • place_call

    Call 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_calls

    Get the phone-call history with a seller contact (direction, numbers, status, duration, transcript, recording), newest first.

  • sync_call

    Refresh a logged call from AgentPhone: pull the latest status, duration, transcript, and recording onto the call record.

  • log_call

    Record a phone call with a seller that happened outside Shopper (for context).

  • log_outreach

    Record 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_followups

    List 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_activity

    Log a timestamped note, call, or reply on a seller contact or seller without overwriting its notes field.

  • list_activities

    Get the activity trail (outreach, notes, calls, replies) for a seller contact or seller, newest first.

Memory & context

4

Durable state every connected agent shares.

  • get_user_context

    Read 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_context

    Write the About You context.

  • recall

    Recall relevant past context (earlier hunts, saved preferences, wish list notes) by similarity.

  • remember

    Persist a durable note or fact to long-term memory so a future session can recall it.

Billing (agent self-pay)

4

Agents check balance and buy their own usage with USDC over x402.

  • get_balance

    Your current Shopper usage balance: credits remaining, plan, and when the meter next resets.

  • get_usage

    The Shopper price list: how many credits each metered action costs, the plans you can buy, top-up limits, and your current balance.

  • buy_credits

    Buy more Shopper usage credits with USDC over x402 (pay as you go, $0.01 per credit).

  • buy_plan

    Buy 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.

Connect your agent