# NameCandies — доступ для агентов

Публичный read-only JSON-RPC API. **Авторизация не требуется.**

- Эндпоинт (JSON-RPC 2.0): `POST https://namecandies.gumeniuk.com/rpc`
- Описание (OpenRPC 1.3.2): `https://namecandies.gumeniuk.com/rpc/openrpc.json`
- In-band discovery: метод `rpc.discover` на том же эндпоинте
- Обзор для LLM: https://namecandies.gumeniuk.com/llms.txt и https://namecandies.gumeniuk.com/llms-full.txt

## Аутентификация

Не нужна. Все опубликованные методы (`names.*`, `cultures.*`, `namedays.*`, `popularity.*`)
доступны анонимно. Ключей и токенов нет.

## Лимиты

60 запросов в минуту с одного IP. При превышении — JSON-RPC ошибка с кодом `1429`.

## MCP

Сервис можно запустить как локальный MCP-сервер поверх stdio (тот же набор
методов): `namecandies mcp`. HTTP-транспорта MCP пока нет.

## Честно

Значения известны не для всех имён; популярность — данные США (SSA, 1880–2008),
не российская статистика; именины — курированное ядро. Данные «как есть».