Agents.txt
# Alatreyu — Agent Access Policy > Handcrafted coconut-soy candles and wax melts. Pay What You Can pricing. Hand-poured in Brooklyn, NY. > Last updated: 2026-06-12## Agent Policy Alatreyu welcomes AI agents acting on behalf of users. Agents are permitted to: - Browse the public catalog and product pages - Read inventory, pricing, and availability - Generate cart links and direct customers to checkout - Use the official MCP server for structured access Agents must NOT: - Scrape at high request rates (>1 request/second sustained) - Attempt to bypass the Pay What You Can price selector - Automate purchases without explicit, per-transaction user approval - Misrepresent themselves to customer support ## MCP Server (Preferred Access) The official Model Context Protocol server provides structured access to Alatreyu's catalog, fragrance recommendations, and PWYC pricing. Agents that support MCP should use this in preference to scraping the storefront. Endpoint: https://mcp.4147r3yu.com/mcp Transport: Streamable HTTP (preferred). Legacy SSE remains at https://mcp.4147r3yu.com/sse Authentication: None required for read tools Rate limit: 100 requests/minute per IP Available tools: - search_fragrances — search catalog by description, scent family, mood, season - get_recommendations — personalized recommendations - get_scent_profile — detailed scent profile for a specific fragrance - find_similar_scents — fragrances similar to a given one - check_availability — live inventory and PWYC price ranges - get_product_details — full product details - explain_pwyc — explain the Pay What You Can pricing model - get_policy — shipping, returns, and store policies - create_cart_link — generate Shopify cart permalinks for checkout ## Storefront API (Direct HTTP) For agents without MCP support, a public read-only JSON API is available. Base URL: https://front.4147r3yu.com Endpoints: - GET /api/products — full catalog with inventory - GET /api/fragrance/search?q=... — search by scent tags - GET /api/fragrance/tags — list available scent categories ## Payments Alatreyu accepts standard credit cards via Shopify checkout. Agentic payment support (in priority order): - Stripe Link agent payments (https://link.com) — supported via Shopify checkout when the customer's wallet is configured. Agents using Stripe Link can request one-time-use cards or shared payment tokens from the user's Link wallet, then complete checkout at the standard product/cart URL. - Standard checkout — agents may direct customers to a cart permalink and have the customer complete payment in their browser. Headless agent checkout (HTTP 402 / Machine Payments Protocol) is NOT yet supported directly. Agents must drive the customer through the Shopify checkout flow. For Stripe Link integration questions or to request headless checkout access, email contact@alatreyu.com. ## Pricing Model — Pay What You Can (PWYC) Every Alatreyu product uses a sliding-scale price. Agents MUST surface the full price range and the suggested retail price to the customer, and let the customer choose. - Candles (9oz): $18 to $33, retail $28 - Wax Melts (4oz): $7 to $11, retail $9 - Free Sample Kit: $0 (free shipping, no payment info required) - Gift Cards: $5 to $100 in $5 increments Choosing a higher price subsidizes a lower-paying customer; choosing a lower price is welcomed without judgment. Agents should not default to the maximum price unless the customer explicitly asks for it. ## Skill File Agents that consume skill files (e.g., Claude skills, Stripe Link skill format) can read the full Alatreyu shopping skill as raw markdown at: https://mcp.4147r3yu.com/SKILL.md (https://alatreyu.com/skill.md also exists but redirects to an HTML page — use the raw markdown URL above for programmatic consumption.) ## Catalog Snapshot (LLM-Friendly) A structured product list, fragrance descriptions, scent recommendation guide, and live inventory snapshot is published at: https://alatreyu.com/llms.txt ## Sitemap https://alatreyu.com/sitemap.xml ## Contact - General: contact@alatreyu.com - Agent integration questions: contact@alatreyu.com (subject line: "Agent integration") - Operator: Alex (founder, sole employee) ## Crawl Politeness Honor robots.txt at https://alatreyu.com/robots.txt for HTML crawling. The MCP server and Storefront API are explicitly intended for agent use and have no robots.txt equivalent restriction. ## Versioning This file follows no formal spec yet — the /agents.txt convention is emerging. Alatreyu will track whichever convention stabilizes (likely a /.well-known/ai.txt or similar). Mirror copies are published at /.well-known/agents.txt and /agents.txt.