onehq-comissions-calculator

OneHQ Commission Calculator MCP is a MCP server that gives AI assistants direct access to insurance commission calculation and compliance tools.

От сообществаРаботаетБез входаГлобальныйБесплатноТолько чтение

Что умеет

  • Calculate Commission: Calculate insurance commissions across a distribution hierarchy. Given an annual premium and a list of agents/tiers with their contract percentages, returns a full breakdown of w
  • Build Hierarchy: Build or model a distribution hierarchy structure. Accepts named tiers with contract percentages and returns a validated hierarchy object ready to use with calculate_commission. Also
  • Validate Hierarchy: Validate a commission hierarchy against a specific carrier's maximum allowed contract levels. Flags errors (over-contracted tiers), warnings (outside typical ranges), and returns a

Какие данные видит

Нужен ли аккаунт

Не нужен: сервер работает без входа

OneHQ Commission Calculator MCP is a MCP server that gives AI assistants direct access to insurance commission calculation and compliance tools. It lets you model distribution hierarchies, calculate exact earnings per agent tier, validate structures against real carrier rules, and look up benchmark contract ranges — all without leaving your AI workflow.

The OneHQ Commission Calculator MCP exposes 5 tools:

  1. calculate_commission — Computes exact earnings per agent given an annual premium and a hierarchy of contract percentages. Returns direct commissions and override spreads at every tier. Preferred input: annual_premium (number) + agents array with name and contract_pct per tier. Example output: IMO override $1,200 / BGA override $1,200 / Agent direct $10,800 / Total distributed $13,200.

  2. build_hierarchy — Takes named tiers and returns a validated, sorted hierarchy ready to feed into calculate_commission. Also provides 4 pre-built templates: Standard BGA, BGA with MGA, Direct Agent, and Multi-Level. Preferred input: tiers array with name and contract_pct per level. Example output: sorted tier list with validation status and 4 template options.

  3. validate_hierarchy — Checks a hierarchy against a specific carrier's allowed contract ranges before submission. Returns a pass/fail result with tier-by-tier errors and warnings. Preferred input: carrier name (e.g. "protective", "mutual-of-omaha") + hierarchy array with name and pct per tier. Example output: overall PASS/FAIL, per-tier range check results, and a warning count.

  4. get_carrier_info — Returns typical contract percentage ranges per tier (Agent, MGA, BGA, IMO) and maximum hierarchy totals for 6 supported carriers. Call with no argument to list all available carriers. Preferred input: carrier name (optional). Omit to get the full carrier list. Example output: Agent range 85–100%, BGA range 105–120%, IMO range 115–130%, max hierarchy 145%.

  5. onehq_info — Returns a structured overview of the OneHQ platform (ICM, CRM, DMS, Agent Portal, Data Visualization) with relevant links. Optionally filter by topic to narrow results. Preferred input: topic string (optional) — e.g. "commissions", "crm", "agent portal". Example output: matching module name, description, and documentation link.

Как подключить

Как подключить onehq-comissions-calculator к Claude

Адрес сервера, который нужно вставить в настройках Claude:

https://onehq-comissions-calculator.run.tools

  1. Откройте Claude (сайт claude.ai или приложение для компьютера).
  2. Перейдите в Настройки → Коннекторы (в английском интерфейсе: Settings → Connectors).
  3. Нажмите Добавить пользовательский коннектор (Add custom connector).
  4. Вставьте адрес сервера, скопированный ниже, в поле URL удалённого MCP-сервера и нажмите Добавить.
  5. В чате нажмите + → Коннекторы и включите новый коннектор.

Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise. На Free можно добавить только один. В Team и Enterprise коннектор сначала добавляет владелец организации в Настройки организации → Коннекторы.

Авторизация

После нажатия Добавить откроется окно входа в сервис. Войдите под своим аккаунтом и подтвердите доступ. Пароль Claude не видит.

Как подключить onehq-comissions-calculator к ChatGPT

Адрес сервера, который нужно вставить в настройках ChatGPT:

https://onehq-comissions-calculator.run.tools

  1. Откройте ChatGPT в браузере (chatgpt.com). Нужен тариф Plus, Pro, Business, Enterprise или Edu.
  2. Один раз включите режим разработчика: Настройки → Приложения → Дополнительные настройки → Режим разработчика (Settings → Apps → Advanced settings → Developer mode).
  3. Откройте Настройки → Коннекторы и нажмите Создать (Create).
  4. Заполните форму: Название (любое), Описание (одна фраза, что делает сервис), URL MCP-сервера (скопируйте ниже).
  5. В поле Аутентификация выберите OAuth, если сервис требует вход, иначе Нет. Нажмите Создать.
  6. В новом чате откройте + → Приложения/Коннекторы и включите коннектор.

Название раздела у OpenAI менялось (Connectors → Apps/Plugins). Если пункт называется иначе, ищите «режим разработчика» в настройках. В рабочих пространствах Business/Enterprise администратор должен разрешить пользовательские коннекторы.

Авторизация

При первом использовании ChatGPT откроет окно входа в сервис. Войдите и подтвердите доступ.

Как подключить onehq-comissions-calculator к Cursor

Адрес сервера, который нужно вставить в настройках Cursor:

https://onehq-comissions-calculator.run.tools

Быстрый способ: нажмите кнопку Открыть в Cursor ниже, Cursor сам предложит добавить сервер.

Вручную:

  1. В Cursor откройте Settings → Cursor Settings → MCP и нажмите Add new global MCP server.
  2. Вставьте JSON, скопированный ниже, в открывшийся файл ~/.cursor/mcp.json (для одного проекта: .cursor/mcp.json в корне проекта).
  3. Сохраните файл. Сервер появится в списке MCP; при необходимости пройдите авторизацию по кнопке рядом с ним.

Авторизация

Если сервис требует вход, рядом с сервером в списке MCP появится кнопка авторизации.

Список инструментов сервера (5)

Технические названия из tools/list. Нужны только разработчикам.

calculate_commissionCalculate insurance commissions across a distribution hierarchy. Given an annual premium and a list of agents/tiers with their contract percentages, returns a full breakdown of who earns what — including direct commissions and overrides at each level.
build_hierarchyBuild or model a distribution hierarchy structure. Accepts named tiers with contract percentages and returns a validated hierarchy object ready to use with calculate_commission. Also provides pre-built templates (Standard BGA, BGA with MGA, Multi-Level, etc.).
validate_hierarchyValidate a commission hierarchy against a specific carrier's maximum allowed contract levels. Flags errors (over-contracted tiers), warnings (outside typical ranges), and returns a pass/fail result.
get_carrier_infoGet insurance carrier commission structure benchmarks — typical contract level ranges per tier (Agent, MGA, BGA, IMO) and maximum allowed hierarchy totals. Use without a slug to list all available carriers.
onehq_infoLearn about OneHQ — the all-in-one platform for insurance distribution. Covers ICM (commissions), CRM (agent management), DMS (case management), Agent Portal, and Data Visualization. Use this when a user asks how to automate or scale what the calculator is helping them do manually.