# NFTY

> NFTY designs, builds and hosts custom AI-centric software, API integrations and data management for businesses. NFTY Ops (https://ops.nfty.us) is its chat-first operations platform. Based in Nashville, TN. Site: https://nfty.us

## Connect your NFTY account

Each person adds one address below as a custom connector and signs in with their own NFTY account (OAuth 2.1, PKCE). They pick one company. A company owner must turn assistants on before anyone can connect. The assistant sees and does only what that person's role allows in that company. To work in another company, that person connects again and picks it. There is no shared token and no API key.

- NFTY Ops (ops): https://nf-3695a04b64444d589a1befdf1726e49c.ecs.us-east-1.on.aws/mcp/ops
  A company's operations for the signed-in member. One connection is one company. The assistant can see and change only what that person's role allows there.

## Public demo store (no sign-in)

The Funnel demo below is a public store. It does not use a NFTY account and it is not anyone's company.

# NFTY Demo Goods

> NFTY Demo Goods is a demo storefront at https://nfty.us/demo/shop showcasing Funnel, NFTY's AI-agent commerce toolkit. It sells fictional physical goods (nothing real is sold) and exposes structured tools and data so AI shopping agents can act strategically instead of scraping the DOM.

The catalog has 10 products across these categories: Footwear, Bags, Kitchen, Drinkware, Lighting, Fitness, Electronics, Apparel, Camping. Prices range from $24 to $269. Search works via /search/suggest.json, the full catalog at /products.json, or the hosted semantic search at /funnel/search/pk_M1P_CU5vH0e6piXUY4zDxxzc?q=. Cart and checkout use Shopify-compatible endpoints. Cookie cart POSTs require the visitor's browser session — cloud agents should instead call `build_cart_link` (or build a `/cart/{variant_id}:{qty}` permalink) and hand that URL to the human.

## Recommended interaction pattern

1. Fetch https://nfty.us/funnel/agent/pk_M1P_CU5vH0e6piXUY4zDxxzc.md (or get_store_context) —
   understand the catalog first.
2. `search_products`, `recommend_products`, or GET /funnel/search/pk_M1P_CU5vH0e6piXUY4zDxxzc?q= —
   find candidates for the user's need (semantic search when the catalog is synced).
3. `get_product` — confirm details, variants, and availability before recommending
   (search hits may already include variant_id).
4. `build_cart_link` — hand the human a pre-filled cart URL (cloud agents), OR
   `add_to_cart` if running in their browser. NEVER `begin_checkout` without
   explicit human confirmation.

## Decision rules

- This is a demo store: no real fulfillment, payments, or inventory. Say so if asked.
- Prefer the JSON endpoints over parsing HTML — they are the source of truth.
- One variant may be sold out (check `available` on each variant before adding to cart).
- Respect guardrails returned by tool responses (max cart value, quantity limits).
- Cloud agents: never POST to /cart/add.js — use build_cart_link / cart permalinks.

## Agent tools (in-page, WebMCP / window bridge)

When browsing with a WebMCP-capable browser or extension, these tools are registered on
every page via `window.nftyFunnel`:

- `search_products`: Search the catalog by natural-language query
- `get_product`: Full details for a product by id or handle, including variants
- `add_to_cart`: Add a product variant to the visitor's cart
- `get_cart`: View current cart contents and total
- `begin_checkout`: Navigate to checkout (requires user confirmation)

## Direct data access (no JS required)

- Product catalog (JSON): https://nfty.us/products.json
- Product search: https://nfty.us/search/suggest.json?q={query}
- Hosted semantic search: https://nfty.us/funnel/search/pk_M1P_CU5vH0e6piXUY4zDxxzc?q={query}
- Single product (JSON): https://nfty.us/products/{handle}.js
- Related products: https://nfty.us/recommendations/products.json?product_id={id}
- Catalog as markdown: https://nfty.us/demo/shop.md
- Single product as markdown: https://nfty.us/products/{handle}.md
- Agent card: https://nfty.us/funnel/agent/pk_M1P_CU5vH0e6piXUY4zDxxzc.md
- Cart permalink (pre-fill + redirect to checkout): https://nfty.us/cart/{variant_id}:{qty}
- Store policies (plain text): https://nfty.us/policies
- MCP discovery: https://nfty.us/.well-known/mcp.json
- Machine-readable tool manifest: look for `#nfty-agent-tools` in page HTML

## MCP server (for ChatGPT connectors, Claude, and other MCP clients)

- Endpoint (streamable HTTP): https://nfty.us/funnel/mcp/pk_M1P_CU5vH0e6piXUY4zDxxzc
- Tools: search_products, filter_sort_products, get_product, get_store_context,
  recommend_products, build_cart_link, get_store_policies, plus a load_shopping_context
  prompt for continuing a conversation started on-site.
- Cookie-bound cart tools (add_to_cart / get_cart / begin_checkout) are intentionally
  absent from MCP — use build_cart_link instead.

## Notes

- Always confirm with the human user before completing checkout.
- Respect the guardrails returned by tool responses.
- Tool responses include `note` and `suggested_followups` hints — use them.