# AquaMania — оснащение спортобъектов (agent-native платформа)

> Производитель мебели и оборудования для раздевалок, бассейнов и спортзалов (шкафы для переодевания, ПВХ-стеллажи, скамьи, тумбы, дорожки, корзины). Платформа даёт ИИ-агентам MCP-сервер: подобрать позиции, рассчитать НМЦК (ст. 22 ФЗ-44) и собрать тендерпакеты 44/223-ФЗ по реальным ценам производителя. Ключевой принцип: цена у агента = цена на сайте = цена в КП.

## MCP-сервер (для ИИ-агентов)

- [MCP endpoint](https://aqmania.com/api/mcp): JSON-RPC 2.0 поверх Streamable HTTP (stateless). Только POST. Вызовите `tools/list` — схемы инструментов всегда актуальны. Читающие инструменты доступны без ключа; пишущие (генерация файлов и заказов) — по API-ключу в заголовке `Authorization: Bearer <ключ>`.
- [Документация и живая песочница](https://aqmania.com/agents): как подключить агента, тарифы, лимиты, live-вызов инструментов прямо со страницы.

## Как получить ключ (самообслуживание, без звонка)

1. Вызовите `request_api_key` — обязателен только `email`; полезно указать `org`, `purpose`, `contact`.
2. Заявку рассматривает человек (владелец платформы), обычно в рабочее время в течение дня. Сохраните `requestToken` из ответа — забрать ключ можно только по нему.
3. Вызывайте `check_api_key_request` с этим `requestToken` (не чаще раза в 10 минут). При одобрении в ответе придёт `apiKey` — он показывается **один раз**.

Ключ самообслуживания: 100 вызовов в сутки, 1000 в месяц; доступны все инструменты, **кроме** `dealer_order` — размещение заказа по дилерским ценам подключает менеджер (8 800 700 99 12).

## Диагностика авторизации

Коды различимы, машиночитаемый код дублируется в `structuredContent.error`:

- `401` `missing_api_key` — заголовок `Authorization` не передан.
- `401` `invalid_api_key` — ключ не распознан: проверьте схему `Bearer` и опечатки.
- `403` `revoked_api_key` — ключ существует, но деактивирован.
- `403` `insufficient_scope` — инструмент вне прав ключа (например, `dealer_order`).
- `429` — исчерпан лимит запросов или квота тарифа, смотрите `Retry-After`.
- `503` `db_unavailable` — ключ временно нельзя проверить; проблема на нашей стороне, не в вашем ключе.

## Инструменты

Без ключа:

- `list_concepts` / `configure_locker` / `get_quote` — концепции, раскладка шкафов раздевалок и цены
- `find_product` — поиск по каталогу продукции, 162 SKU (по артикулу платформы и 1С, названию, габаритам, описанию)
- `calc_nmck` / `calc_nmck_cart` — обоснование НМЦК ст. 22 ФЗ-44 по конфигурации раздевалки ИЛИ по произвольной корзине каталога / явным позициям заказчика
- `quote_project` — единая смета на объект из нескольких зон
- `object_status` — статус заказа по своему телефону (`phone`); просмотр по номеру заказа (`orderId`) — только с ключом
- `request_api_key` / `check_api_key_request` — подать заявку на ключ и забрать его

По ключу:

- `make_kp` / `make_tender_package` / `make_tender_package_cart` / `make_project` — генерация готовых КП, ТЗ, тендерпакета 44/223-ФЗ (docx/xlsx/ZIP) по раздевалке, объекту или произвольной корзине
- `dealer_order` — заказ от дилера по нетто-ценам (ключам самообслуживания недоступен)

## Как выбирать позицию

`find_product` возвращает `description` (габариты · материал · особенности конструкции) и `size`. Цена **не** означает «базовость» модели: если у нескольких позиций совпали габариты и материал, в поле `note` придёт предупреждение — уточните выбор у заказчика или менеджера, не угадывайте.

## Ссылки

- [Каталог продукции](https://aqmania.com/catalog)
- [Госзаказ: НМЦК-калькулятор и тендерпакет](https://aqmania.com/gov-nmck)
- Менеджер AquaMania (дилерские условия, повышение лимитов): 8 800 700 99 12