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:
- Find the brand in the public Nash directory.
- Show you the matching products visually — with images, variants, and prices.
- Ask focused questions to confirm the right variant (flavor, size, color, etc.) one at a time.
- Collect your email + shipping address if you haven't already provided them.
- 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:
- Go to claude.ai/download.
- Download the installer for your OS (macOS, Windows, or Linux).
- Open it, drag Claude into Applications (macOS) or run the installer (Windows/Linux).
- Launch Claude Desktop and sign in.
Step 2 — Add the Nash MCP connector
- Open Settings (gear icon at the top right).
- Go to the Connectors section in the sidebar.
- Scroll to the bottom and click Add custom connector.
- Fill in the dialog:
- Name:
Nash- Remote MCP server URL:https://mcp.pier39.ai/mcp - 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:
find_stores— search the public Nash directorydiscover_store— probe a domain fornash.v1compliancelist_products— list a store's products with variants + imagescreate_nash_order— charge the customer and place the order on their behalf
(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:
- Call
find_stores(query="olipop")and show you the Olipop entry. - Call
list_products(...)to show you product cards with images. - Ask you to confirm the variant if multiple match.
- Ask for your email + shipping address (you can paste it all at once: name, street, city, state, ZIP).
- Call
create_nash_order(...)with the full order details. - 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
- Go to chatgpt.com and sign in.
- 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:
- From the app page: click Start chat at the top of the Nash Agent detail page.
- From any chat: in the message composer, click the + icon (or type @) and pick Nash Agent from the app picker. The Nash Agent chip appears under the composer.
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"
- Go back to the Nash Agent app page and click Connect again.
- Some browsers block the connect modal — try Chrome or Safari if you're on a less common browser.
ChatGPT: The Nash Agent chip doesn't appear in the composer
- Click the + icon at the left of the message composer and pick Nash Agent from the menu.
- Or type @ to bring up the app picker and select Nash Agent.
Claude: "Nash" doesn't appear in the tools menu
- Did you fully quit Claude Desktop (Cmd-Q on macOS) and reopen? Closing the window doesn't reload Custom Connectors.
- Re-open Settings → Connectors and confirm "Nash" appears in your list. If it's missing, the Add step didn't save — try Step 2 again.
- Confirm the URL you entered is exactly
https://mcp.pier39.ai/mcp(no trailing slash, no typos).
Claude: tools loaded but Claude won't use them
- Be more direct: "Use the Nash tools to find me Olipop and place an order" instead of "can you order this for me?"
- If Claude tries to call deprecated tools like
start_negotiation, remind it: "Use create_nash_order, that's the current flow."
"Connection error" mid-conversation
- The connector might be temporarily unreachable. Try
curl -s https://mcp.pier39.ai/mcpfrom your terminal — if it returns406 Not Acceptable, the server is healthy. - The Nash backend might be cold-starting (it auto-stops when idle). Wait 5 seconds and ask Claude to retry.
- Heavy testing in a short window can hit per-IP rate limits. Wait a minute and retry.
The order URL gives me a Stripe error page
- Make sure the URL is the exact one Nash returned (starts with
https://nash-checkout.pier39.ai/p/). Third-party link shorteners can break the redirect. - The Stripe Checkout Session expires after 30 minutes if unpaid. If too much time passed, ask Nash to create a new order.
Claude says the store doesn't speak the protocol
- The store you asked for hasn't joined the Nash directory yet. Currently only stores listed in negotiate-directory are Nash-ready.
- Ask Nash to suggest a similar brand that's already in the directory.
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
- Nash Agent on ChatGPT — one-click install from the ChatGPT Apps directory
- PROTOCOL.md — the formal
nash.v1protocol spec - STORE_SETUP.md — for merchants who want to deploy Nash on their storefront
- CHATGPT_SETUP.md — for developers who want to build their own Custom GPT against the Nash API
- negotiate-mcp on PyPI — the Claude Desktop MCP source
- negotiate-directory — public registry of Nash-ready brands
License
The connector and protocol are MIT-licensed. The skills are Apache 2.0.