onehq-comissions-calculator — Claude Code MCP server: guide
onehq-comissions-calculator — an MCP server for modeling insurance distribution hierarchies and calculating tiered payouts. It validates contract percentages against carrier limits directly in your coding assistant.
no license 1,274 installs updated 2026-04-08
claude mcp add --transport http onehq-comissions-calculator https://onehq-comissions-calculator.run.toolsWhat onehq-comissions-calculator does
This integration connects your coding client with insurance compensation logic. Running calculate_commission breaks down an annual premium into direct agent earnings and tiered override spreads. To structure payouts before calculating them, build_hierarchy organizes custom tiers or applies pre-configured setups such as Standard BGA and Multi-Level.
Compliance checks run through validate_hierarchy. The tool flags percentages that exceed carrier caps and highlights numbers outside typical boundaries. You can query get_carrier_info to inspect industry contract benchmarks from Agent up to IMO tiers, or fetch the full list of supported carriers.
Because this server operates over HTTP at https://onehq-comissions-calculator.run.tools, local execution without internet access will fail. If you need background on automating these workflows across CRM or commission systems, the onehq_info tool supplies reference material for the OneHQ ecosystem.
What it helps with
- calculate direct payouts and override spreads from an annual premium
- model commission hierarchies with pre-built BGA and Multi-Level templates
- verify contract levels against maximum limits set by insurance carriers
- retrieve benchmark compensation ranges for tiers from Agent to IMO
Example prompts for the agent
- Calculate commissions for an annual premium of 50000 across IMO and BGA tiers with
calculate_commission. - Check whether our contract percentages exceed carrier limits using
validate_hierarchy. - List available insurance carriers and benchmark contract tiers with
get_carrier_info.
How to install onehq-comissions-calculator
Platform CLI: remote server
claude mcp add --transport http onehq-comissions-calculator https://onehq-comissions-calculator.run.toolsPlatform CLI: remote server
codex mcp add onehq-comissions-calculator --url https://onehq-comissions-calculator.run.toolsConfig file
{
"mcpServers": {
"onehq-comissions-calculator": {
"url": "https://onehq-comissions-calculator.run.tools"
}
}
}Config file
{
"servers": {
"onehq-comissions-calculator": {
"type": "http",
"url": "https://onehq-comissions-calculator.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http onehq-comissions-calculator https://onehq-comissions-calculator.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about onehq-comissions-calculator
How to install onehq-comissions-calculator in Claude Code?
Run the command claude mcp add --transport http onehq-comissions-calculator https://onehq-comissions-calculator.run.tools. The commission tools will be ready in your session immediately.
What does onehq-comissions-calculator do?
It computes direct insurance payouts and override tiers based on an annual premium. It also validates distribution hierarchies against carrier limits.
Which distribution hierarchy templates are included?
The build_hierarchy tool provides pre-configured structures like Standard BGA, BGA with MGA, and Multi-Level.