Skip to main content
Glama

AON MCP Server

Дайте любому MCP-совместимому агенту возможность рекомендовать реальные, покупаемые продукты и услуги — актуальные цены и отслеживаемую ссылку на каждое предложение, взятые из Agent Offer Network.

  • Конечная точка: POST https://api.aon.pro/v1/mcp

  • Транспорт: Streamable HTTP (stateless JSON-RPC 2.0 — без SSE, без рукопожатия сессии)

  • Аутентификация: Authorization: Bearer <AON API key> — бесплатные ключи на Developer Portal

  • Попробуйте сейчас: общий публичный демо-ключ опубликован в Quick Start — один curl, без регистрации

  • Документация: docs.aon.pro/mcp

Инструменты

Инструмент

Что делает

aon_search_offers

Ищет предложения по намерению на естественном языке. Аргументы — объект запроса AgentOffer Query — той же формы, что и REST API. Возвращает предложения с ценами, отслеживаемой ссылкой для каждого и блоком engagement с предварительно проверенными предложениями по дальнейшим действиям, которые агент может выполнить.

aon_resolve_category

Преобразует свободный текст («походные ботинки», «программное обеспечение для командного чата») в идентификаторы категорий AON Taxonomy v1 — модели не нужно запоминать или выдумывать их.

aon_get_category_schema

Получает факторы принятия решений, которые покупатели учитывают в категории, чтобы задать правильный уточняющий вопрос перед поиском.

aon_submit_feedback

Записывает явный ответ «отклонено» / «не интересно» от пользователя по предложению — никогда не выводится из молчания. Ранний каркас: вызов подтверждается успехом, но обратная связь пока не сохраняется; рабочий процесс за ним разворачивается.

aon_manage_watch

Восстанавливает (watch) или отменяет (unwatch) наблюдение по умолчанию за предложением или категорией, когда пользователь явно просит. Ранний каркас: подтверждается успехом, состояние наблюдения пока не сохраняется.

Примечания по дизайну, полезные агентам:

  • Прощающий по дизайну — недопустимые значения никогда не приводят к сбою поиска; они рассматриваются как «не отправленные» и исправляются в extra.hints[]. Только неверная аутентификация, неверный JSON, отсутствующий intent.content или слишком большое тело запроса приводят к жёсткому сбою.

  • Ограниченный релевантностью — пустой список результатов — это настоящий ответ, а не заполнитель.

  • Цикл руководства — последующие предложения содержат request_patch RFC 7386, который напрямую объединяется в следующий вызов, а также origin для обратного эха для атрибуции принятия.

Related MCP server: Agentic Travel Recommendations Service

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

curl -s -X POST https://api.aon.pro/v1/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AON_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "aon_search_offers",
      "arguments": {
        "intent": {
          "content": [
            { "type": "input_text", "text": "credit card with cashback" }
          ]
        }
      }
    },
    "id": 1
  }'

Ещё нет ключа? Скопируйте общий демо-ключ из Quick Start в $AON_API_KEY.

Настройка клиента

Готовые к вставке конфигурации находятся в examples/:

Клиент

Конфигурация

Claude Code

examples/claude-code

Claude Desktop

examples/claude-desktop (via mcp-remote)

Cursor

examples/cursor

VS Code

examples/vscode

Простой curl

examples/curl

Ограничения скорости

/v1/mcp позволяет 60 запросов tools/call в минуту на ключ; вызовы рукопожатия (initialize, tools/list, notifications/*) никогда не учитываются. Превышающий лимит tools/call возвращает HTTP 200 с ошибкой JSON-RPC -32000, чтобы модель могла прочитать совет по повторной попытке. Подробности: Лимиты и FAQ.

Монетизация и атрибуция

Каждое предложение содержит отслеживаемую ссылку назначения (action.payload.target). Показывайте её дословно — клики и конверсии атрибутируются приложению вашего API-ключа, что является основой для доли дохода разработчика. Отчётность находится в Developer Portal.

Манифест реестра

server.json — это манифест реестра MCP для этого сервера (схема 2025-12-11, пространство имён pro.aon — проверено через DNS для домена aon.pro).

Связанные репозитории

  • protocol — спецификации AgentOffer Protocol (нормативные)

  • schema — JSON-схемы, TypeScript-типы, таксономия

  • examples — примеры интеграции HTTP / SDK / агентов

  • rfcs — предложения по развитию протокола

Лицензия

Apache-2.0

Related MCP Connectors

Related MCP Servers