About mcp-erid
mcp-erid is an MCP server for checking the format of Russian advertising-marking erid tokens and looking up creatives in a client's VK ORD account. It also provides brief guidance on marking requirements; it does not access the ERIR registry or register ads.
Key features
- 01Check erid length and allowed characters
- 02Look up erid in VK ORD with a client key
- 03Brief guidance on marking requirements
- 04No lookup against the ERIR registry
Use cases
- 01Validate an erid token's format
- 02Check for a creative in a VK ORD account
- 03Consult a brief explanation of marking requirements
MCP support
The server exposes tools for erid format verification, VK ORD lookup using the client's API key, and short requirement explanations. It does not access ERIR; lookup requires the client's ORD key.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
uvx atomno-mcp-eridMCP_ERID_ORD_TOKENSecretAPI key from the client's ORD cabinet (VK documented).MCP_ERID_ORD_PROVIDERORD operator id. Currently vk. yandex lookup spec is not public.MCP_ERID_API_KEYSecretOptional key for Atomno hosted placement. Not an ORD key.Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
6Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| erid | string | Yes | Advertising identifier token to check the format (e.g. «2Vfnxxxxxx»). |
Details
From the project READMEatomno-mcp-erid
Проверка формата токена маркировки рекламы (erid) — без ключа, в реестр не ходит. Поиск креатива — в кабинете вашего ОРД по вашему ключу. Своего доступа к ЕРИР у нас нет и не будет; на живом ключе клиента обмен не проверяли.
Ad-marking MCP: erid format check; ORD cabinet lookup on the client key.
Инструмент — читалка, не регистрация рекламы. Ответ не юридическое заключение; ответственность за маркировку по 38-ФЗ несёт рекламодатель / рекламораспространитель.
Что умеет сейчас
verify_erid— длина и допустимые символы токена. Не ищет в ЕРИР.lookup_erid— если задан ключ ОРД VK, идёт в кабинет оператора по официальному методуGET /v2/creative/by_erid/{erid}. Не найден в кабинете —found: falseс оговоркой, что это не вся база ЕРИР. Неверный ключ — отказ, не «не найдено».explain_marking_requirement— краткая справка по темам.
Что не подключено
- Общий реестр ЕРИР (закрыт для всех, кроме ведомств и операторов)
- ОРД Яндекса: в открытой справке нет устойчивого метода «найти по erid» — запрос не выдумываем
- Разбор рекламной страницы
- Пакетная проверка списка URL
Быстрый старт
pipx install atomno-mcp-erid
Формат токена — без переменных:
{
"mcpServers": {
"erid": {
"command": "uvx",
"args": ["atomno-mcp-erid"]
}
}
}
Кабинет ОРД — ключ из вашего кабинета оператора (VK: «Ключи доступа к API»):
{
"mcpServers": {
"erid": {
"command": "uvx",
"args": ["atomno-mcp-erid"],
"env": {
"MCP_ERID_ORD_PROVIDER": "vk",
"MCP_ERID_ORD_TOKEN": "<ключ из кабинета ОРД VK>"
}
}
}
}
Своего доступа к ЕРИР у нас нет. Наше размещение — отдельная услуга (MCP_ERID_API_KEY), не замена ключа ОРД.
Переменные окружения
| Переменная | Описание | Обязательна |
|---|---|---|
MCP_ERID_ORD_TOKEN | Ключ API кабинета ОРД | нет (нужна для lookup_erid) |
MCP_ERID_ORD_PROVIDER | Сейчас: vk. yandex — описание поиска по erid закрыто | нет |
MCP_ERID_ORD_BASE_URL | Адрес API ОРД (по умолчанию прод VK) | нет |
MCP_ERID_API_KEY | Ключ нашего размещения | нет |
MCP_ERID_API_BASE | URL нашего размещения | нет |
MCP_ERID_TIMEOUT | Таймаут HTTP, сек | нет |
MCP_ERID_LOG_LEVEL | Уровень логирования | нет |
Тулы
| Тул | Вход | Что отвечает сейчас |
|---|---|---|
verify_erid | erid | проверка формата, не реестр |
lookup_erid | erid | кабинет ОРД VK по ключу клиента |
explain_marking_requirement | topic | краткая справка |
audit_ad_page | url | отказ: разбор не подключён |
check_compliance_38fz | признаки страницы | отказ: чек-лист не подключён |
audit_batch | urls[] | отказ: пакет не подключён |
Дисклеймер
Полная база ЕРИР закрыта. Ответ не является юридическим заключением. Не аффилировано с ЕРИР, ОРД, РКН или ФАС. Своего доступа к ЕРИР у нас нет; на живом ключе клиента обмен не проверяли.
Лицензия
MIT © Atomno
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.