API ВЕГА

Prism MCP server

Лицензия MIT, размещённая в этом репозитории, распространяется только на документацию и примеры. На сервис Prism она не распространяется.

Prism анализирует договоры — договоры аренды жилых и коммерческих помещений, ипотечные договоры, страховые полисы и документы HOA — и возвращает все важные сроки: уведомления о продлении, периоды для отмены, пересмотра арендной платы, даты реализации опционов. Для каждого срока сервис указывает точную дату, последствия пропуска и фразу из договора, на которой основан результат. Даты вычисляются по правилам, указанным в самом договоре, а не оцениваются приблизительно. В этом репозитории описано, как подключить AI-агента к размещённому MCP-серверу Prism.

Размещённый endpoint

URLhttps://prism.parad1gm.com/api/prism-mcp
ТранспортMCP Streamable HTTP
АвторизацияВход через OAuth или API-ключ Prism в качестве bearer token
Имя в реестреcom.parad1gm/prism

Чтобы начать работу, API-ключ не нужен. При первом подключении клиент выполнит вход в аккаунт Prism через OAuth, после чего вы сможете выбрать, какие действия разрешить агенту.

Параметры OAuth

  • Поток авторизации OAuth 2.1 с PKCE (S256); публичные клиенты, без client secret.

  • Поддерживается динамическая регистрация клиентов, поэтому MCP-клиенты регистрируются самостоятельно.

  • Области доступа:

    • prism:read -- просмотр сохранённых договоров, сроков и рисков, выявленных Prism.

    • prism:write -- отправка договоров на обработку Prism с использованием ваших кредитов.

  • Метаданные защищённого ресурса: https://prism.parad1gm.com/.well-known/oauth-protected-resource/api/prism-mcp

  • Метаданные сервера авторизации: https://prism.parad1gm.com/.well-known/oauth-authorization-server

Без OAuth

Создайте API-ключ на странице оплаты и передавайте его в качестве bearer token:

Authorization: Bearer YOUR_PRISM_KEY

Описания в машиночитаемом формате

  • Карточка MCP-сервера: https://prism.parad1gm.com/.well-known/mcp/server-card.json

  • Карточка A2A-агента: https://prism.parad1gm.com/.well-known/agent-card.json

  • Сводка для LLM: https://prism.parad1gm.com/llms.txt

Подключение

Claude (claude.ai и Claude Desktop)

  • Откройте Settings, затем Connectors.

  • Выберите Add custom connector.

  • Вставьте https://prism.parad1gm.com/api/prism-mcp и выполните вход в Prism, когда появится запрос.

См. examples/claude-desktop.md.

Claude Code

claude mcp add --transport http prism https://prism.parad1gm.com/api/prism-mcp

См. examples/claude-code.md.

Cursor

Добавьте конфигурацию в ~/.cursor/mcp.json (для всех проектов) или .cursor/mcp.json (для одного проекта):

{
  "mcpServers": {
    "prism": { "url": "https://prism.parad1gm.com/api/prism-mcp" }
  }
}

См. examples/cursor-mcp.json.

VS Code

Добавьте конфигурацию в .vscode/mcp.json в рабочей области:

{
  "servers": {
    "prism": {
      "type": "http",
      "url": "https://prism.parad1gm.com/api/prism-mcp"
    }
  }
}

См. examples/vscode-mcp.json.

Windsurf и другие MCP-клиенты

Для подключения к удалённым MCP-серверам клиенту нужны три параметра:

  • URL: https://prism.parad1gm.com/api/prism-mcp

  • Транспорт: Streamable HTTP

  • Авторизация: OAuth (клиент получает настройки с сервера) или заголовок Authorization: Bearer YOUR_PRISM_KEY

В большинстве клиентов подойдёт структура mcpServers, приведённая в примере для Cursor. Точное название ключа для удалённого URL уточните в документации клиента: например, Windsurf использует serverUrl.

Инструменты

ИнструментНазначение
prism_review_contractОтправляет договор аренды, ипотечный договор, страховой полис, документ HOA или договор коммерческой аренды, указав ровно один из параметров: url, text или fileBase64 (PDF или фотографию размером до 25MB). Сразу возвращает contractId; обработка занимает около минуты.
prism_get_contractВозвращает статус и результаты обработки одного договора по contractId: все сведения, если договор оплачен, или бесплатный предварительный результат из 3 пунктов. Кредиты не расходуются.
prism_unlock_contractВозвращает все сроки и риски для договора, обработка которого завершена. Расходует 1 кредит ($0.50), если договор ещё не оплачен. Если кредитов нет, возвращает предварительный результат с code: "insufficient_credits".
prism_upcoming_deadlinesВозвращает открытые сроки по всем договорам аккаунта, начиная с ближайших, в пределах периода withinDays (по умолчанию 90 дней).
prism_list_contractsВозвращает все договоры аккаунта, начиная с самых новых, с указанием статуса и доступности полных результатов. Поддерживается постраничная выдача.
prism_get_accountВозвращает остаток кредитов, цены, сведения о том, покрывает ли подписка Unlimited все операции, и количество договоров, добавленных в этом месяце. Поле creditStatus принимает значение ok, low (осталось не более 2 кредитов), empty или unlimited. В purchaseOptions указано, кто может выполнить покупку: пользователь по ссылке на оплату или сам агент.
prism_buy_creditsВозвращает варианты покупки от 20 до 2000 кредитов по $0.50 за кредит: ссылку Stripe для оплаты пользователем и, если доступно, URL для покупки через MPP, которую агент может оплатить самостоятельно.
prism_send_feedbackПозволяет сообщить команде Prism об ошибочном результате, пропущенных сведениях или подходящей цене. Каждое сообщение читает сотрудник. Бесплатно. Если команда подтвердит ошибку, воспроизведя её, на аккаунт начислят 10 бесплатных кредитов.

Полные схемы входных и выходных данных доступны в карточке сервера.

Обычный порядок работы: вызовите prism_review_contract, подождите около минуты, затем вызовите prism_get_contract. Если договор не оплачен, вызовите prism_unlock_contract, чтобы получить полные результаты за 1 кредит. При повторной отправке того же документа возвращается тот же договор.

Как избежать неожиданного списания кредитов. Перед пакетной обработкой проверьте значение creditStatus с помощью prism_get_account. Если оно равно low или empty либо при разблокировке возвращён code: "insufficient_credits", вызовите prism_buy_credits. Любой подключённый агент может сделать это самостоятельно: инструмент вернёт ссылку на оплату для пользователя, а если purchaseOptions.agentPayment имеет значение true — URL для самостоятельной оплаты агентом через Machine Payments Protocol (MPP). Только для перехода по ссылке на оплату нужен человек.

A2A

Prism также поддерживает протокол Agent2Agent (A2A) с привязкой JSON-RPC, версии 1.0 и 0.3.

  • Карточка агента: https://prism.parad1gm.com/.well-known/agent-card.json

  • Навыки: read-contract (отправляет договор сообщением, затем проверяет состояние задачи) и unlock-contract (отправляет unlock в задаче со статусом input-required).

В A2A используются тот же сервер OAuth и те же токены, что и в MCP-сервере. API-ключ Prism также подходит в качестве bearer token. Цены одинаковы.

Цены

Для агентов (MCP и A2A)

  • $0.50 за договор (1 кредит). Оплата списывается один раз при первой выдаче полных результатов.

  • При создании аккаунта начисляются 3 бесплатных кредита.

  • Предварительный просмотр, повторная обработка и документы, которые Prism не может прочитать, бесплатны. За один и тот же документ плата не взимается повторно.

  • Кредиты продаются пакетами от 20 штук (минимальная стоимость — $10). Агент может предоставить вам ссылку на оплату или самостоятельно оплатить покупку через MPP-кошелёк, если этот вариант доступен.

  • Для договоров, разблокированных агентом, действуют те же напоминания по электронной почте, что и для договоров, добавленных вами самостоятельно: за 90, 30 и 7 дней до каждого срока.

  • Чтобы сообщить об ошибке, допущенной Prism, вызовите prism_send_feedback и укажите договор, а также ожидаемую дату или пункт. Если команда подтвердит ошибку, воспроизведя её, на аккаунт начислят 10 бесплатных кредитов.

Для пользователей (на сайте)

  • $1 за договор, единоразово; или

  • $9 в месяц за подписку Unlimited, включающую до 50 договоров в месяц.

Конфиденциальность и данные

  • Подключённый агент имеет доступ только к вашему аккаунту Prism. Вы можете разрешить ему просмотр данных без отправки договоров, предоставив только доступ prism:read. Отключить агента можно в любое время в разделе Security.

  • Prism не продаёт ваши данные. Документы передаются только поставщикам услуг, необходимым для работы Prism: AI-провайдерам, обрабатывающим документы, почтовому провайдеру, отправляющему уведомления, Stripe для приёма платежей и облачному хостингу.

  • Платёжные данные обрабатывает Stripe. Prism не видит и не хранит номера банковских карт.

  • Загрузка документа не передаёт Prism право собственности на него. Загружайте только документы, которыми вы имеете право делиться.

  • Данные хранятся, пока ваш аккаунт активен. Чтобы экспортировать данные или удалить аккаунт, напишите на support@parad1gm.com.

  • Prism помогает разбираться в документах, но не предоставляет юридических консультаций и может допускать ошибки. Важные сведения проверяйте по самому документу.

Полные версии документов доступны на страницах Политика конфиденциальности и Условия использования. Оператор Prism — Built AI, Inc.

Поддержка

Напишите на support@parad1gm.com. Если возникли проблемы с подключением клиента, можно также создать issue. Не публикуйте в issue текст договоров, личные данные, API-ключи или токены.

О репозитории

В этом репозитории собраны документация и конфигурации клиентов для размещённого сервера Prism MCP, а также файл server.json, опубликованный в MCP Registry. Сам сервис Prism имеет закрытый исходный код; кода сервера в этом репозитории нет.