NUM MCP Сервер

Удаленный MCP сервер для туристических мест. Поиск по каталогу из 2 529 721 места в 77 направлениях в 38 странах, а также отправка бизнесов или акций на проверку человеком.

Управляется 5arz Inc. · Конечная точка: https://itsnum.com/mcp · Внесен в официальный реестр MCP как com.itsnum/num.

Этот репозиторий содержит документацию, конфигурации подключения и примеры клиентов. Сам сервер размещен — устанавливать или запускать ничего не нужно.

Быстрый старт

Обнаружение инструментов открыто. Вы можете увидеть, что предлагает сервер, без каких-либо учетных данных:

curl -sS -X POST https://itsnum.com/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Для вызова инструмента требуется бесплатный API-ключ:

curl -sS -X POST https://itsnum.com/api/agent/signup \
  -H 'content-type: application/json' \
  -d '{
        "agent_name": "Acme Listings Bot",
        "operator_name": "Acme Ltd",
        "operator_email": "ops@acme.example",
        "purpose": "Suggest restaurants and bars to travellers in Thailand."
      }'

Ключ возвращается один раз и не подлежит восстановлению. Сохраните его немедленно. Ротация по POST /api/agent/me/rotate; проверка использования по GET /api/agent/me.

Рабочие версии всего вышеперечисленного находятся в examples/.

Related MCP server: discava – Business Directory for AI

Подключение

Транспорт: Streamable HTTP. Аутентификация: Authorization: Bearer numa_live_…

{
  "mcpServers": {
    "num": {
      "type": "http",
      "url": "https://itsnum.com/mcp",
      "headers": { "Authorization": "Bearer numa_live_YOUR_KEY" }
    }
  }
}

{
  "mcpServers": {
    "num": {
      "url": "https://itsnum.com/mcp",
      "headers": { "Authorization": "Bearer numa_live_YOUR_KEY" }
    }
  }
}

{
  "servers": {
    "num": {
      "type": "http",
      "url": "https://itsnum.com/mcp",
      "headers": { "Authorization": "Bearer ${input:num_key}" }
    }
  },
  "inputs": [
    { "id": "num_key", "type": "promptString", "description": "NUM API key", "password": true }
  ]
}

Инструменты

Все пять инструментов имеют аннотации MCP (readOnlyHint, destructiveHint, openWorldHint), чтобы клиент мог определить, какие инструменты только читают, а какие записывают.

Квоты — чтений в день: бесплатно 100 · пакет 2 000 · pro 20 000 · full 200 000. Записи не ограничены на любом уровне, включая бесплатный. Мы предпочитаем ваши данные вашим деньгам.

Две вещи, которые стоит понять перед созданием

Отправки не публикуются автоматически. Все, что отправлено через num_submit_business или num_submit_promo, сохраняется, но остается невидимым для путешественников до тех пор, пока человек в 5arz не одобрит это. Это сделано намеренно, и это не очередь, которую можно обойти. Не говорите пользователю, что его объявление активно, потому что инструмент вернул успех — опрашивайте num_list_submissions для получения решения проверяющего.

«Проверено» имеет здесь конкретное значение, и это не оценка отзыва. В NUM проверено описывает человека или заявленное объявление — никогда не место:

• Проверенный гость — это путешественник, которого 5arz подтвердил как уникального реального человека.

• Проверенное объявление — это объявление, владелец которого доказал контроль над уже опубликованными в нем контактными данными.

• Незаявленные объявления нанесены на карту, но не проверены.

Если вы предоставляете данные NUM конечным пользователям, пожалуйста, не отображайте «проверено» как сигнал качества, рейтинга или одобрения. Это означает это реальный человек или этот владелец реален — ничего о том, хорошая ли еда.

Честно указывайте отношения

num_submit_business запрашивает ваши отношения с бизнесом, и значение имеет значение:

Угадывание owner, чтобы выглядеть более убедительно, — самый быстрый способ получить отзыв ключа агента. Никогда не выдумывайте контактные данные — недоступный номер телефона хуже пустого поля.

Лимиты запросов и этикет

• Чтения тарифицируются в день по уровню; записи не тарифицируются.

• Регистрация ограничена 5 ключами на адрес в день. Одного ключа на агента более чем достаточно — используйте его повторно.

• 429 означает, что вы достигли лимита. Отступите; не повторяйте попытку в плотном цикле.

Поверхности для обнаружения

Ценообразование

Бесплатно для путешественников, и нет комиссии за бронирование для путешественников. Бизнесы размещаются бесплатно и платят 10% от бронирования, совершенного NUM, из своей доли, никогда не добавляется к счету путешественника. Ничего за незапланированные визиты, ничего за постоянных клиентов самого бизнеса, без ежемесячного минимума. Полные детали на itsnum.com/pricing.

Поддержка

• Вопросы, ошибки, партнерство: info@5arz.com

• Безопасность: см. SECURITY.md

• Приветствуются вопросы по этому репозиторию для документации и проблем с примерами клиентов.

Лицензия

Документация и примеры в этом репозитории: MIT. Сервис NUM, его данные и сам каталог являются собственностью 5arz Inc. и не лицензируются этим репозиторием.