signal-found/sf-mcp

Сценарий введения в курс дела без начального контекста для агентов, использующих этот MCP сервер. Возвращает рекомендуемую последовательность вызовов, общие ограничения и подсказки для восстановления.

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

Изменяет состояние конверсии в CRM (категорию) клиента для продукта.

Извлекает образцы подтверждённых и незаинтересованных диалогов и возвращает сопоставленные фрагменты сообщений.

Читает и обновляет активы стратегии продукта: позиционирование на рынке, заметки о конверсии и воронки.

Читает и обновляет таргетинг сабреддитов и ключевые слова для продукта.

Создаёт совершенно новый клиентский аккаунт Signal Found для онбординга. Требуется: - business_name - email Возвращает созданный client_id и (по умолчанию) выполняет вход этой MCP-сессии в него. Следующий шаг после успеха: - вызовите create_new_product

Создаёт продукт и инициализирует контекст сессии агентского онбординга. Ответ включает: - результат создания продукта - контекстный пакет (существующие артефакты + URI скриншота) - пакет подсказок + метаданные версии Предварительное условие: - аутентифицированная сессия через login_with_client_id (или явное указание client_id) Следующий шаг после успеха: - вызов run_full_agentic_onboarding (или ручной запуск инструментов поэтапно)

Выводит список данных CRM-клиентов, отфильтрованных по состояниям конверсии, с явной диагностикой дедупликации.

Возвращает статистику состояний CRM (количество уникальных дедуплицированных клиентов по conversion_state).

Операции чтения/записи CRM (без генерации ответов и отправки личных сообщений). Используйте action для выбора операции; у каждого действия свои обязательные поля. Этот инструмент намеренно исключает поведение исходящих сообщений. Поддерживаемые действия: - list_customers - prospect_stats - get_conversation_by_id - update_conversion_state - update_blacklist - get_notes - update_notes

Возвращает текущий аутентифицированный контекст клиента для этого сеанса сервера MCP.

Получает сообщения беседы по идентификатору беседы в области продукта.

Получает заметки для CRM-разговора в разрезе продукта.

Извлекает дедублицированные записи CRM по одному статусу или корзине категории лидов.

Получает промпт-контракты, подобранные сервером, которые определяют необходимые результаты на этапе онбординга. Используйте это, когда агенту требуется точное форматирование/ожидания перед генерацией: - уточнения - стенограмма разговора - позиционирование на рынке - ключевые слова/сабреддиты Используйте artifact для сфокусированных контрактов: - уточнения - market_position - разговор - ключевые слова - сабреддиты

Каноническое представление прогресса онбординга для продукта/сессии. Возвращает: - текущую фазу - следующее обязательное действие - состояние подтверждения prompt-pack - состояние одобрения таргетинга - отсутствующие артефакты + блокировщики готовности Используйте это для восстановления, если предыдущий запуск онбординга был частичным или завершился с ошибкой.

Получает вложенные папки и продукты для клиента, что эквивалентно дереву продуктов на фронтенде.

Перечисляет кампании для клиента (активные/неактивные, маппинг продуктов, бюджет и сигналы предупреждений).

Возвращает канонические состояния конверсии CRM, доступные для рекатегоризации.

Перечисляет все продукты для клиента (slug, display_name, product_unique, folder_id).

Аутентифицирует сессию MCP для клиентской учетной записи Signal Found. Запускайте это в начале каждой сессии перед бизнес-инструментами. Большинство инструментов требуют аутентифицированного контекста и будут использовать этот идентификатор сессии клиента, если только вы не передадите явный аргумент client_id.

Очищает контекст активного аутентифицированного клиента для этой сессии MCP сервера.

Читает или обновляет заметки о конвертации с явными обязательными именами ключей. Как использовать: - Вызывайте без conversion_notes, чтобы просмотреть текущие заметки. - Для обновлений передавайте все три канонических ключа для согласованности. Ожидаемые ключи (строковые значения): - Product Name - Payment Terms/Plans - General Notes

Читает или заменяет воронки с явной проверкой структуры. Как использовать: - Вызывайте без funnels для просмотра текущего списка воронок. - Обновление выполняется заменой: предоставьте полный предполагаемый список воронок. Ожидаемая структура элемента: - url (string) - description (string) - primary_use_case (string) - qualification (optional string)

Читает или обновляет таргетинг по ключевым словам с необязательными параметрами поиска. Как использовать: - Вызывайте без keywords, чтобы просмотреть текущую конфигурацию ключевых слов. - Обновление записывает явный список ключевых слов и необязательные параметры поиска. Ожидаемая структура payload: - keywords: list[str] - search_params (необязательно): - sort: одно из relevance|hot|top|new|comments - time_filter: одно из hour|day|week|month|year|all - per_keyword_limit: int

Читает или обновляет позиционирование на рынке с четкими указаниями по формату. Как использовать: - Вызывайте без market_position_patch, чтобы просмотреть текущие данные перед редактированием. - Отправляйте только те ключи, которые хотите изменить (семантика частичного обновления). Ожидаемые ключи для обновления (значения — строки): - one_line_pitch - icp - competitive_alternatives - uniqueness - value_proof - market_category - trends - additional_info

Читает или обновляет группы таргетинга по сабреддитам. Как использовать: - Вызовите без subreddit_groups, чтобы просмотреть текущий таргетинг. - Для обновления передайте формат groups, который использует onboard API targeting endpoint. Ожидаемая структура элемента subreddit_groups: - subreddits: список названий сабреддитов (без префикса r/, предпочтительно).

Оценивает готовность и опционально запускает кампанию немедленно. Если не готова и заблокирована по кредитам, также возвращает ссылку на оформление заказа. Используйте это после того, как онбординг достигнет одобрения таргетинга. Установите start_now=true, чтобы попытаться запустить кампанию.

Вычисляет коэффициент закрытия по всем продуктам на основе состояний конверсии в CRM.

Перенесите дневной бюджет исходящей рекламы с худшей активной кампании в целевую продуктовую кампанию.

Выполняет полный поэтапный процесс онбординга от начала до конца за один вызов. Предназначен для zero-context агентов, которые хотят безопасный путь по умолчанию. Этот инструмент выполняет по порядку: - версия prompt-pack + подтверждение (ack) - уточнения (вопросы/режим/ответы) - беседа (режим/стенограмма/извлечение) - валидация артефактов + запись - отправка нацеливания (+ опционально утверждение) - снимок готовности Требования: - clarifying_questions должен содержать ровно 3 элемента - передавать корректные полезные нагрузки схем для артефактов/нацеливания При частичном сбое возвращает failed_stage, retry_hint и завершённые этапы.

Сводка командного центра для клиента: продукты, состояние кампаний, коэффициент закрытия и рекомендации. Лучший первый операционный инструмент после входа в систему, когда пользователь спрашивает: «Что нам делать дальше?»

Отправляет Reddit-сообщения собранным лидам через расширение Chrome Signal Found. Три режима (должен быть установлен ровно один): - target_username: холодное сообщение конкретному пользователю Reddit - crm_reply_to: ответ на существующий диалог в CRM - batch_from_working_leads=True: отправка всем неконтактированным рабочим лидам этого продукта Содержимое сообщения: укажите сообщение вручную или установите generate_message=True (по умолчанию) для автоматической генерации на основе рыночного позиционирования продукта и заметок по конверсии через Phase 2. В пакетном режиме повторно используются предварительно вычисленные значения suggested_response, если они доступны. Требуется подключенное и активное на Reddit расширение Chrome. Немедленно завершается ошибкой, если ни одно не онлайн.

Выполняет предварительную проверку соединения MCP с onboard_api и контекста аутентификации. Используйте эту проверку первой в новом сеансе, чтобы подтвердить: - бэкенд доступен - текущее состояние аутентификации сеанса MCP - настроен ли идентификатор клиента по умолчанию

Сохраняет артефакты таргетинга (ключевые слова/сабреддиты) и возвращает политику/предпросмотр. Предварительные требования: - пакет подсказок должен быть подтверждён для session_id - артефакты уже должны быть сохранены для лучших результатов Обычный следующий шаг: - одобрить таргетинг (выполняется автоматически run_full_agentic_onboarding когда включено) Форматы: - keywords: list[str] - subreddit_groups: [{'subreddits': ['name1','name2']}]

Проверяет и сохраняет ключевые артефакты адаптации для продукта/сессии. Предварительные требования: - prompt pack должен быть подтвержден для session_id - payloads должны соответствовать схемам артефактов, указанным ниже Обычное использование: - вызывается из run_full_agentic_onboarding - также может использоваться для поэтапных/восстановительных запусков Ожидаемые форматы: - market_position: patch-объект с ключами позиционирования на рынке - conversion_notes: {'Product Name','Payment Terms/Plans','General Notes'} - funnels: [{'url','description','primary_use_case', необязательное 'qualification'}]

Обновляет заметки для разговора CRM в контексте продукта.

Создаёт или обновляет заметку к беседе по объёму продукта.

Создает отчет Voice of Customer, объединяющий метрики результатов и подтвержденные/незаинтересованные образцы разговоров.