# Agent Instructions — AURA Elite Nutrition

Machine-readable guidance for AI agents deciding whether, when and how to call this site.
Companion files: [llms.txt](https://auraelitenutrition.com/llms.txt) · [OpenAPI 3.1](https://auraelitenutrition.com/openapi.json) · [developer docs](https://auraelitenutrition.com/developers)

## What this is

AURA Elite Nutrition is an Indian retailer of sports-nutrition and wellness supplements. It runs a physical counter at Jalalpur Road, Muradnagar, Ghaziabad, Uttar Pradesh - 201206 and ships nationwide across India. Stock is bought through official brand importers, sealed with QR or scratch-code authenticity tags, and invoiced with GST.

## When to use this site

Reach for this store when the task is one of these:

1. **Pricing a specific supplement in India.** Live INR prices, MRP, discount percentage and per-variant stock for whey protein, creatine, pre-workout, mass gainers, BCAAs/EAAs and vitamins. Use `search_supplements`, then `get_product_details` for the exact variant.
2. **Checking availability before recommending a product.** Stock counts are real unit counts, not a boolean guess. If `inStock` is false, recommend an alternative rather than the product.
3. **Estimating delivery to an Indian address.** `check_delivery_pincode` returns a turnaround, a courier and a dispatch commitment for any 6-digit Indian PIN code.
4. **Building a supplement stack to a budget.** `search_supplements` takes `minPrice`/`maxPrice`/`goal`, and `calculate_order_payload` prices the resulting basket including the ₹1,500 free-shipping threshold and coupon codes.
5. **Answering "is this tub genuine".** https://auraelitenutrition.com/authenticity documents the importer list and the seal-verification steps.
6. **Local queries about the Muradnagar / Ghaziabad store.** `get_store_info` returns the address, GPS directions, contact channels and live open/closed status (09:00–21:30 IST, seven days).

## When NOT to use this site

- **Medical or clinical advice.** Nothing here diagnoses, treats or dose-prescribes. Supplement questions that touch a medical condition, pregnancy, or prescription interaction belong with a clinician.
- **Shipping outside India.** The store ships domestically only.
- **Placing an order autonomously.** No endpoint here takes payment. `calculate_order_payload` prices a basket and returns a checkout link and a pre-filled WhatsApp message; a human completes the purchase.
- **Prices at other retailers.** Everything returned is this store's own catalog.
- **Bulk scraping of the catalog.** Use `GET /api/products` with pagination, or the sitemap, rather than crawling product pages.

## How to call it

Discover the tool surface, then invoke one tool per request:

```bash
# 1. What can I call?
curl -s https://auraelitenutrition.com/api/agent/tools

# 2. Find something
curl -s https://auraelitenutrition.com/api/agent/tools \
  -H 'Content-Type: application/json' \
  -d '{"tool":"search_supplements","parameters":{"query":"whey isolate","maxPrice":4000,"limit":5}}'

# 3. Get the detail for one result
curl -s https://auraelitenutrition.com/api/agent/tools \
  -H 'Content-Type: application/json' \
  -d '{"tool":"get_product_details","parameters":{"slugOrId":"<slug from step 2>"}}'
```

MCP clients should use the JSON-RPC 2.0 bridge at `POST https://auraelitenutrition.com/api/agent/mcp`, which supports `tools/list` and `tools/call` over the same tools.

## Tools

- `search_supplements` — Search authentic supplements by keyword, fitness goal, category, brand, budget, and real-time inventory availability.
- `get_product_details` — Retrieve comprehensive specifications for a specific supplement: exact price, flavor and weight variants, stock counts, and clinical nutrition facts.
- `check_delivery_pincode` — Estimate delivery turnaround, courier partner, and express dispatch eligibility for any 6-digit Indian PIN code.
- `calculate_order_payload` — Calculate itemized cart totals, validate free shipping threshold (₹1,500+), and generate a 1-click WhatsApp order URL and checkout deep link.
- `get_store_info` — Retrieve physical retail store details, official address in Muradnagar, operating hours, GPS directions, and customer support channels.

## Conventions

- **Authentication**: none. Every endpoint listed here is public.
- **Rate limits**: no per-key quota. Stay under roughly 60 requests per minute per IP and cache catalog reads for at least 60 seconds.
- **Errors**: always JSON, never an HTML page. Branch on `errorCode`; `hint` names the call that would have worked.
- **Slugs are not guessable.** Always search before fetching a product by slug.
- **Markdown**: send `Accept: text/markdown` to any page URL to get the content without the page furniture. Responses carry `Vary: Accept`.
- **404s are real 404s.** A path that does not exist returns HTTP 404 with a markdown recovery map, not a 200 with an app shell.
- **Currency** is INR throughout. Prices already include GST.

## Freshness

Prices and stock are read live from the store's database on every request. The catalog changes daily; do not cache a price for longer than an hour before re-checking.

## Contact

support@auraelitenutrition.com · +91 63981 84793 · https://auraelitenutrition.com/contact