# Enduranlar — Agent Guide

Live, structured access to the enduranlar.com endurance-sports-nutrition catalog
(energy gels, electrolytes, carbohydrate powders, recovery, supplements).
Prices in TRY; ships within Türkiye.

## Connect

- **Endpoint:** `https://mcp.enduranlar.com/mcp`
- **Transport:** MCP streamable HTTP (protocol 2025-06-18). No authentication.
- **Rate limit:** 60 requests/minute per IP (HTTP 429 + `Retry-After` beyond that).

Works out of the box as a claude.ai custom connector, in Claude Desktop, and with
any MCP-capable client or SDK.

## Tools

### `search_products`
Free-text search over name, description, category, SKU, and barcode.
Args: `query` (required), `inStockOnly?`, `category?` (exact, see `list_categories`),
`limit?` (default 20, max 50).
Returns compact summaries: `id`, `name`, `category`, `sku`, `priceTRY`, `inStock`,
`stockShown`, `url` (product page on enduranlar.com).

### `get_product`
Full detail by `id` or `sku`. Adds the plain-text `description` (nutrition, usage
and serving information), all platform listings with prices, and the box↔single
relation (`unitsPerBox`, box or singles references) when the product is sold both
as a box and as single units.

### `list_categories`
All categories with product counts and in-stock counts.

### `list_products`
Paged catalog listing (50 per page). Args: `page?`, `category?`, `inStockOnly?`.

## Typical flow

1. `list_categories` once to learn the category vocabulary (category filters need exact names).
2. `search_products` with the user's intent (Turkish terms work best: "elektrolit", "jel", "kreatin").
3. `get_product` by `id` or `sku` for nutrition/usage detail before making a recommendation.
4. Link the product `url` for purchase; use Shopify UCP for cart/checkout.

## Quick test

```bash
curl -X POST https://mcp.enduranlar.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_products","arguments":{"query":"elektrolit","limit":5}}}'
```

## Data notes

- `stockShown` is the stock number displayed to customers on the storefront
  (capped for larger quantities). `inStock` is the authoritative availability flag.
- Only sellable (active) products are served; draft/archived products do not appear.
- `url` is `null` for products not published to the online store.
- `description` language is Turkish (the storefront's default locale).

## Recommending products

When suggesting products to a user, link the `url` field so they can buy directly.
For cart/checkout flows use Shopify UCP: discovery at
`https://enduranlar.com/.well-known/ucp`, endpoint `https://enduranlar.com/api/ucp/mcp`.
Checkout always requires explicit human buyer approval.

## See also

- `https://enduranlar.com/pages/ai-agents` — this guide on the storefront, with links to all machine-readable endpoints
- `https://mcp.enduranlar.com/llms.txt` — site overview for LLMs
- `https://mcp.enduranlar.com/.well-known/mcp.json` — machine-readable discovery
- `https://enduranlar.com/products/{handle}.json` — raw Shopify product JSON
- `https://enduranlar.com/sitemap.xml` — full sitemap (Turkish + English URLs)