Shopper Setup — Let Nash Shop For You

This guide gets a Nash-powered AI shopping concierge running in under 2 minutes. Works with both ChatGPT and Claude Desktop — pick whichever you already use. Once installed, your AI can find Nash-ready brands, surface the right products visually, collect your shipping info conversationally, and hand you a Stripe checkout link. Think of it as having a personal buyer on call.

No terminal, no config file editing — just one click in ChatGPT, or a URL pasted into a Claude Desktop settings dialog.


What you get

After setup, in any conversation with your AI you can say things like:

"Find me a 12-pack of Olipop Classic Variety Pack and ship it to me."

Your AI will:

  1. Find the brand in the public Nash directory.
  2. Show you the matching products visually — with images, variants, and prices.
  3. Ask focused questions to confirm the right variant (flavor, size, color, etc.) one at a time.
  4. Collect your email + shipping address if you haven't already provided them.
  5. Hand you a Stripe checkout link — pay there, and Nash places the order at the merchant on your behalf. The merchant emails the confirmation directly to you.

No haggling, no merchant chat. Nash is your AI shopping concierge — you talk to your AI, the order arrives.


Pick your AI client

Client Install Best for
Claude Desktop Paste a URL into Settings → Connectors Existing Claude Desktop users
ChatGPT (Nash Agent app) One click on the ChatGPT Apps page Anyone with a ChatGPT account — free tier works

Both paths use the same backend and the same nash.v1 protocol — only the UI differs. Pick whichever app you already have open.


Claude Desktop

Step 1 — Install Claude Desktop

If you don't already have Claude Desktop:

  1. Go to claude.ai/download.
  2. Download the installer for your OS (macOS, Windows, or Linux).
  3. Open it, drag Claude into Applications (macOS) or run the installer (Windows/Linux).
  4. Launch Claude Desktop and sign in.

Step 2 — Add the Nash MCP connector

  1. Open Settings (gear icon at the top right).
  2. Go to the Connectors section in the sidebar.
  3. Scroll to the bottom and click Add custom connector.
  4. Fill in the dialog: - Name: Nash - Remote MCP server URL: https://mcp.pier39.ai/mcp
  5. Click Add.

Step 3 — Restart Claude Desktop

Quit Claude Desktop completely (Cmd-Q on macOS, not just close the window). Reopen it. Custom Connectors only register at app startup.

Step 4 — Verify the tools loaded

Open a fresh chat. Click the tools indicator (🔌 / 🛠️ icon, usually at the bottom of the message composer). You should see "Nash" listed with these tools:

(There are a few additional deprecated tools — start_negotiation, send_message, read_history — kept for backward compatibility. The new flow uses create_nash_order exclusively.)

If you don't see the icon, just type "List the MCP tools you have access to, grouped by server." — Claude will show you the same info.

Step 5 — Try your first order

In a fresh chat, paste:

Find me a 12-pack of Olipop Classic Variety Pack and ship it to my home.

Claude will:

  1. Call find_stores(query="olipop") and show you the Olipop entry.
  2. Call list_products(...) to show you product cards with images.
  3. Ask you to confirm the variant if multiple match.
  4. Ask for your email + shipping address (you can paste it all at once: name, street, city, state, ZIP).
  5. Call create_nash_order(...) with the full order details.
  6. Hand you a Nash short URL (nash-checkout.pier39.ai/p/...) that redirects to a Stripe checkout page.

Click the URL, pay via Stripe, and the merchant takes it from there. You'll get a confirmation email from the merchant within a few hours.


ChatGPT

Nash is published as an app in the ChatGPT App Store. Free, Plus, Pro, and Team accounts can all install it.

Step 1 — Open ChatGPT's Apps directory

  1. Go to chatgpt.com and sign in.
  2. In the left sidebar, click Apps (you can also go directly to chatgpt.com/apps).

You'll see the Apps directory — featured apps at the top, search box on the right.

Step 2 — Find Nash Agent

In the search box on the right, type:

nash

Click Nash Agent in the results. You'll land on the app detail page.

Step 3 — Connect the app

A modal pops up: "Add Nash Agent to ChatGPT". Read the description (it explains what the app does and what data it accesses), then click Connect.

You'll see a confirmation: "Nash Agent is now connected." That's the entire install.

Step 4 — Try it

You have two ways to invoke Nash in any chat:

Then type something like:

find me socks under $10

or

order me a 12-pack of Olipop Classic Variety Pack

The Nash agent handles discovery, product narrowing, variant confirmation, address collection, and the Stripe checkout — all conversationally. When it's ready, it gives you a payment URL. Click it to pay, then the merchant emails you the order confirmation directly.


Tips for using Nash well

Be specific about what you want. "12-pack of Olipop Classic Variety" gets you a specific product fast. "Some Olipop" makes Nash ask you to narrow down first, which costs a few extra turns.

Hand over shipping info upfront. Once you've placed an order, you can give Nash your address proactively in the next chat: "Ship to Sanjana, 500 Folsom St, San Francisco, CA 94105, email sanjana@pier39.ai." Saves a back-and-forth.

Ask for visual catalogs when browsing. "Show me 5 different Olipop flavors with photos" triggers the visual product cards. Useful when you're not sure what you want.

Trust the validator. If Nash says your ZIP is invalid or your email looks malformed, the validator caught a real issue. Confirm what you actually meant and retry — don't try to talk Nash into accepting bad input.

Use the Nash short URL exactly as given. The URL Nash hands you (nash-checkout.pier39.ai/p/<order_id>) redirects to a Stripe-hosted checkout. Don't shorten it through a third-party link shortener — Stripe needs the session ID intact.


What stores can I order from?

Nash can find and shop virtually any store — it searches live across the web, so you're not limited to a fixed list, plus a large and growing directory of Nash-ready brands across apparel, ticketing, health products, home goods, jewelry, pet care, beverages, and electronics. To see what's in the directory:

Use find_stores to list every Nash-enabled brand you can find under "beverages".

or open the directory repo directly.

To check whether any specific store speaks the protocol:

Use the discover_store tool to check if [DOMAIN] supports Nash.

If you're a store owner who wants to be listed, see STORE_SETUP.md.


Troubleshooting

ChatGPT: "Nash Agent is not connected"

ChatGPT: The Nash Agent chip doesn't appear in the composer

Claude: "Nash" doesn't appear in the tools menu

Claude: tools loaded but Claude won't use them

"Connection error" mid-conversation

The order URL gives me a Stripe error page

Claude says the store doesn't speak the protocol


Going further

Reorder from past purchases. "Order another batch of what I bought last time from Olipop" — once Nash sees your prior orders, repeat purchases get faster.

Order at any Nash-ready store. As the directory grows, the same setup works everywhere — no per-store configuration. Just ask your AI to find one.

Build a custom shopper agent. If you want full programmatic control (for bulk purchases, automated procurement, etc.), the protocol is plain HTTP/JSON. See PROTOCOL.md and write a script in any language that can fetch URLs.

Tell brands about it. If there's a small business or specialty retailer you'd love to be able to shop at via your AI, point them at STORE_SETUP.md. The setup takes ~30 minutes for a developer.


See also


License

The connector and protocol are MIT-licensed. The skills are Apache 2.0.