# ShopWell.ai — Full Reference for AI Agents > Long-form, retrieval-friendly summary of ShopWell.ai. Operated by Axiom Strategies. For the short index, see /llms.txt. For machine actions, see /.well-known/mcp.json. ## 1. What ShopWell.ai is ShopWell.ai is a social planning platform for shopping, events, trips, and projects. It unifies four planning pillars — Smart Lists, Events, Trips, and Projects — plus a Home dashboard that brings them together, so people can plan together with AI-powered lists, itineraries, budgets, and RSVPs. The product is built for dreamers: the homeowner imagining a remodel, the parent throwing a kid's birthday, the traveler planning a long weekend, the host pulling off a dinner party. ShopWell.ai sits quietly in service so the user can stay in the moment. ShopWell.ai is NOT a grocery store, a retailer, a marketplace, or a recipe / meal-planning app. It does not sell food, host recipes, or generate menus. Editorial commerce content uses fully disclosed affiliate links and never replaces planning content. ## 2. Five pillars ### Smart Lists Real-time collaborative shopping and wish lists. Add items by typing, by voice, by photo, by URL, or by sharing into the app from any browser. AI categorizes items into aisles, estimates prices (prefixed with `~` when estimated), and surfaces price drops. Lists support joint purchases (split-cost), thank-you blasts after purchases, and granular share permissions. ### Events Plan parties, birthdays, gift exchanges, and gatherings. Tracks RSVPs, themed potlucks, schedules, and budgets. Includes auto-drafted holiday parties on the calendar and a Secret Santa exchange with auto-pairing. Owners and editors are excluded from thank-you blasts. ### Trips Multi-day itinerary generator that combines a destination and dates into an optimized plan with drive-time sanity checks, weather adaptation, packing lists, document parsing (boarding passes, hotel confirmations), and an OSRM-routed map. Supports VRBO/rental hints and inbound email forwarding for booking confirmations. ### Projects Home and life projects with blueprint-style concepts, Gantt timelines, budgets, vendor suggestions (50-mile localized), permit guidance, and before/after photo tracking. ### Home The unified dashboard. Surfaces today's tasks, upcoming events and trips, deals on tracked items, polaroid-style connections, and the daily brand video. ## 3. Core AI capabilities - AI itinerary, party, and project drafting from natural-language goals. - Product discovery across CJ, Amazon, eBay, Rainforest, and a Gemini-powered web fallback. - Predictive pricing with `~` markers and Buy-or-Wait recommendations. - Price monitoring with anti-false-positive guards (ignores >3x or <0.25x swings). - AI list analysis: background categorization with visual caching. - Document parsing for trip artifacts (PDF/email/screenshot). - Voice planner with Gemini transcription and conflict review. - Watermark removal pipeline for user-uploaded media. ## 4. Brand identity - Name: ShopWell.ai - Parent: Axiom Strategies - Category: Productivity / Organizer / Planner - Voice: Aspirational, dreamer-focused, quiet in service. Honor the dreamer, not the trait. - Voice rules: Never use "Type A," "planner addict," color-code/spreadsheet jokes, anxiety humor, or jokes that roast "go with the flow" people. - Design: "Neural Expressive" — teal/blue/purple gradients, Plus Jakarta Sans body, Instrument Serif display, frosted glass surfaces. ## 5. Platforms - Web: https://shopwell.ai - iOS and Android: native shell built with buildnatively.com (NOT Expo, NOT Capacitor) - Browser extension and bookmarklet for one-click capture from any site. - Inbound email per user (e.g. forward a booking to a private address to attach it to a trip). ## 6. Privacy and data - Email/password auth only. Social logins (Google, Facebook, Apple) are intentionally not offered. - Soft-deletion: Lists, Events, and Trips are retained for 24 hours after deletion before purge. - Per-user inbound email tokens and Facebook tokens are stored in a private profile table with owner-only RLS. - Sensitive storage buckets (screenshots, voice recordings) are private and folder-scoped. - No personal data is sold. Affiliate links are disclosed at /affiliate-disclosure. ## 7. Affiliate and editorial policy - Amazon links canonicalize to `https://www.amazon.com/dp/{ASIN}?tag=sw0ai07-20` and are live-checked daily. - eBay and CJ links carry the appropriate publisher IDs. Generic fallbacks are CJ-tagged. - Editorial product picks and gift guides are rated 4.0+ stars and pass intent-validation gates. - Articles never lead with "Rated X.X/5" in titles; ratings appear in body content only. ## 8. Public surfaces - / Home - /platform Platform overview - /features Feature catalog - /ai-trip-itinerary AI Trip Itinerary - /ai-party-organizer AI Party Organizer - /ai-project-planner AI Project Planner - /universal-wishlist Universal Wishlist - /shared-shopping-list Shared Shopping List - /gift-list-maker Gift List Maker - /price-tracking Price Tracking - /secret-santa Secret Santa exchange - /holiday-gifts Holiday gift ideas - /quick-search Fast product discovery - /blog Blog - /tips Planning tips and how-tos - /whats-new Latest product updates - /changelog Release history - /picks Editorial product picks - /gift-ideas-ratings Editorially rated gift guides - /daily-video Daily 9:16 brand motion clip - /extension Browser extension - /bookmarklet Bookmarklet capture tool - /corporate For teams and partners - /about About ShopWell.ai - /contact Contact - /affiliate-disclosure Affiliate disclosure - /cookies Cookie policy ## 9. Agent integration (WebMCP) When the page renders, ShopWell.ai exposes a WebMCP-compatible server over `window.postMessage` on channel `shopwell-mcp`. The protocol mirrors MCP 2024-11-05 JSON-RPC with `initialize`, `tools/list`, and `tools/call` methods. Discovery manifest: /.well-known/mcp.json Available tools (all run under the current Supabase session; RLS enforced; mutations return `auth_required` if no session): - `search_lists(query?: string)` — Return up to 25 of the user's shopping lists. - `add_item_to_list(list_id: string, name?: string, url?: string, quantity?: number, notes?: string)` — Add an item. - `create_list(name: string, description?: string)` — Create a new list. - `search_products(query: string, limit?: number)` — Run the product-discovery pipeline. - `set_price_alert(item_id: string, target_price: number)` — Set a price alert. - `create_trip_draft(title: string, destination: string, start_date?: string, end_date?: string)` — Create a trip. - `create_event_draft(title: string, event_date?: string, location?: string)` — Create an event. - `get_whats_new(limit?: number)` — Return latest non-fix release notes. ## 10. FAQ **Q: Is ShopWell.ai a grocery store?** A: No. ShopWell.ai is a planning and organizer app. It builds lists you take to any store. **Q: Does it generate recipes or meal plans?** A: No. It does not handle nutrition, recipes, or menu planning. **Q: What does AI do here?** A: Drafts itineraries, party plans, and project blueprints; categorizes list items; estimates prices; matches products across retailers; transcribes voice; parses booking documents. **Q: How is pricing data sourced?** A: A multi-phase pipeline combining CJ, Amazon, eBay, Rainforest, and a Gemini-powered web fallback. Estimated prices are prefixed with `~`. **Q: How are price alerts triggered?** A: A monitor checks tracked items on a schedule and notifies on real drops, ignoring implausible swings (>3x up or <0.25x down). **Q: Can I share a list?** A: Yes. Lists support granular share permissions (view, edit, purchase) with link-based invites and expirations. **Q: How are deleted items recovered?** A: Lists, Events, and Trips are soft-deleted for 24 hours. After that they are purged. **Q: How does the gift exchange work?** A: Secret Santa pairs participants automatically based on RSVPs and budget; reveals are timed. **Q: Is there a browser extension?** A: Yes — see /extension. A bookmarklet alternative is at /bookmarklet. **Q: Can ShopWell.ai capture a booking from email?** A: Yes. Each user has a private inbound email address that attaches forwarded confirmations to the right trip. **Q: Are there affiliate links?** A: Yes, fully disclosed. Amazon, eBay, and CJ. See /affiliate-disclosure. **Q: Does ShopWell.ai sell personal data?** A: No. **Q: What logins are supported?** A: Email and password only. No Google, Facebook, or Apple SSO. **Q: How can an AI agent take action on my behalf?** A: Browser-based agents can use the in-page WebMCP server (see /.well-known/mcp.json). The agent operates inside the same authenticated session you're in. **Q: Is there a public API?** A: For machine reading: /llms.txt, /llms-full.txt, /sitemap.xml, and the RSS feeds. For machine action: the in-page WebMCP server. No public REST API is currently offered.