# lookup

Хостинговый MCP-сервер, который отвечает агенту, можно ли звонить или писать на номер прямо сейчас: оператор, тип линии, спам-репутация, доставляемость SMS.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Автор: verirouteintel
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/verirouteintel/veriroute-intel-mcp
- Обновлён: 2026-09-06
- HTML: https://affpapa.org/nevibecode/mcp/lookup

## Что делает

Сервер подключается к `https://verirouteintel.com/api/mcp` по Streamable HTTP и JSON-RPC 2.0, авторизация — заголовок `Authorization: Bearer <ключ>`. Ставить и запускать локально нечего: клиент обращается к удалённому эндпоинту. Для CI и клиентов без поддержки remote MCP есть npm-шим `veriroute-intel-mcp`, который просто пересылает запросы на тот же хост.

Внутри шесть инструментов. `vri_number_lookup` отдаёт данные по одному номеру: оператор записи, тип линии, маршрутизация LRN, дата переноса, при желании — CNAM и репутация. `vri_spam_check` смотрит на жалобы и робозвонки, `vri_sms_deliverability` выносит один вердикт для рассылок: примет ли номер SMS и уместно ли время отправки. Массовые задачи закрывают `vri_bulk_lookup` (до 100 номеров за вызов), `vri_submit_job` (асинхронная задача до 10 000 номеров) и `vri_bulk_status` для прогресса.

Ключ нужен до первого вызова инструмента: без него работает только обнаружение. Бесплатный sandbox-ключ даёт тестовые данные и не списывает деньги, боевой ключ платит с предоплаченного баланса по тарифам REST API. Неудачные запросы не тарифицируются, а вызов сверх баланса отклоняется сразу.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://verirouteintel.com/api/mcp`
- Переменные окружения: `VRI_API_KEY` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

1. **Командой платформы**
```bash
claude mcp add lookup -e VRI_API_KEY=<VRI_API_KEY> -- npx -y veriroute-intel-mcp
```
Вместо <…> подставьте свои значения

2. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http lookup https://verirouteintel.com/api/mcp
```

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add lookup --url https://verirouteintel.com/api/mcp
```

2. **Командой платформы**
```bash
codex mcp add lookup --env VRI_API_KEY=<VRI_API_KEY> -- npx -y veriroute-intel-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "lookup": {
            "url": "https://verirouteintel.com/api/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "lookup": {
            "command": "npx",
            "args": [
                "-y",
                "veriroute-intel-mcp"
            ],
            "env": {
                "VRI_API_KEY": "<VRI_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "lookup": {
            "type": "http",
            "url": "https://verirouteintel.com/api/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "lookup": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "veriroute-intel-mcp"
            ],
            "env": {
                "VRI_API_KEY": "<VRI_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http lookup https://verirouteintel.com/api/mcp
```

2. **Командой платформы**
```bash
gemini mcp add -e VRI_API_KEY=<VRI_API_KEY> lookup npx -y veriroute-intel-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- проверить список номеров перед обзвоном и отсеять мёртвые и VoIP
- узнать, не помечен ли ваш исходящий номер как спам
- убедиться, что номер примет SMS, прежде чем запускать рассылку
- подтянуть в CRM актуального оператора и тип линии
- прогнать базу на 10 000 номеров фоновой задачей

## Примеры запросов агенту
- Проверь номер +1 555 010 0199: какой оператор, тип линии и есть ли жалобы на спам
- Можно ли сейчас отправить SMS на этот номер?
- Запусти массовую проверку списка из файла `leads.csv` и покажи прогресс

## Похожие
- [twilio-lookup-phone-intelligence](https://affpapa.org/nevibecode/skills/twilio-lookup-phone-intelligence.md) — скилл · ★ 7604
- [rcs-agent-onboarding](https://affpapa.org/nevibecode/skills/rcs-agent-onboarding.md) — скилл · 2900 установок
- [telnyx](https://affpapa.org/nevibecode/mcp/telnyx.md) — MCP-сервер · ★ 198
- [database-lookup](https://affpapa.org/nevibecode/skills/database-lookup.md) — скилл · 2100 установок
- [sms-10dlc-registration](https://affpapa.org/nevibecode/skills/sms-10dlc-registration.md) — скилл · 2900 установок
- [klaviyo](https://affpapa.org/nevibecode/skills/klaviyo.md) — скилл · 517 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
