{
  "version": "1.0",
  "protocolVersion": "2025-11-25",
  "serverInfo": {
    "name": "horizon-retention-tools",
    "title": "Horizon retention tools",
    "version": "1.0.0"
  },
  "description": "Free, read-only retention calculators (GRR and NRR, customer health score, retention lift vs a holdout, cost of churn) and search over Horizon's Customer Success guides and glossary.",
  "websiteUrl": "https://renewalfix.com/",
  "documentationUrl": "https://renewalfix.com/developers/",
  "iconUrl": "https://renewalfix.com/logo.png",
  "transport": {
    "type": "streamable-http",
    "endpoint": "https://renewalfix.com/mcp"
  },
  "remotes": [
    {
      "type": "streamable-http",
      "url": "https://renewalfix.com/mcp"
    }
  ],
  "capabilities": {
    "tools": {
      "listChanged": false
    }
  },
  "authentication": {
    "required": false,
    "schemes": []
  },
  "tools": [
    {
      "name": "calculate_grr_nrr",
      "title": "GRR and NRR calculator",
      "description": "Calculate gross revenue retention (GRR) and net revenue retention (NRR) for a period from starting ARR, churned ARR, downgrade (contraction) ARR and expansion ARR. Same formula as renewalfix.com/tools/grr-nrr-calculator/.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "starting_arr": {
            "type": "number",
            "minimum": 0,
            "description": "ARR from existing customers at the start of the period"
          },
          "churned_arr": {
            "type": "number",
            "minimum": 0,
            "description": "ARR lost from customers who left"
          },
          "contraction_arr": {
            "type": "number",
            "minimum": 0,
            "description": "ARR lost to downgrades from customers who stayed",
            "default": 0
          },
          "expansion_arr": {
            "type": "number",
            "minimum": 0,
            "description": "ARR added by upsell and cross-sell to existing customers",
            "default": 0
          }
        },
        "required": [
          "starting_arr",
          "churned_arr"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "calculate_health_score",
      "title": "Customer health score calculator",
      "description": "Score a customer account from 0 to 100 from four areas (product, adoption, relationship, commercial), each 0 to 100. The weighted average is capped at the weakest area plus 25 points, and at 50 if a champion or sponsor left, so one weak area can't hide. Returns the score, a Red/Yellow/Green band and the reason. Same rule as renewalfix.com/tools/customer-health-score-calculator/.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "product": {
            "type": "number",
            "minimum": 0,
            "maximum": 100,
            "description": "Product health: bugs, outages, support friction (100 = no problems)"
          },
          "adoption": {
            "type": "number",
            "minimum": 0,
            "maximum": 100,
            "description": "Adoption: seats and features in use (100 = fully adopted)"
          },
          "relationship": {
            "type": "number",
            "minimum": 0,
            "maximum": 100,
            "description": "Relationship: champion, sponsor, engagement (100 = strong)"
          },
          "commercial": {
            "type": "number",
            "minimum": 0,
            "maximum": 100,
            "description": "Commercial: renewal intent, budget, competition (100 = no risk)"
          },
          "weights": {
            "type": "object",
            "description": "Optional weights per area (any positive numbers). Default 25 each.",
            "properties": {
              "product": {
                "type": "number",
                "minimum": 0
              },
              "adoption": {
                "type": "number",
                "minimum": 0
              },
              "relationship": {
                "type": "number",
                "minimum": 0
              },
              "commercial": {
                "type": "number",
                "minimum": 0
              }
            },
            "additionalProperties": false
          },
          "champion_left": {
            "type": "boolean",
            "description": "True if the champion or executive sponsor left. Caps the score at 50.",
            "default": false
          }
        },
        "required": [
          "product",
          "adoption",
          "relationship",
          "commercial"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "calculate_retention_lift",
      "title": "Retention lift calculator (outreach vs holdout)",
      "description": "Compare the renewal rate of at-risk accounts that got outreach with a holdout group that didn't. Returns the 95% range for the lift in percentage points, whether the lift is likely to be real or could be chance, both renewal rates, the lift, and an estimate of the ARR kept if the lift holds. When the range includes zero, report the range first and don't present the ARR as kept. Same method as renewalfix.com/tools/retention-lift-calculator/.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "outreach_accounts": {
            "type": "integer",
            "minimum": 1,
            "description": "At-risk accounts that got outreach"
          },
          "outreach_renewed": {
            "type": "integer",
            "minimum": 0,
            "description": "How many of them renewed"
          },
          "holdout_accounts": {
            "type": "integer",
            "minimum": 1,
            "description": "At-risk accounts in the holdout group (no outreach)"
          },
          "holdout_renewed": {
            "type": "integer",
            "minimum": 0,
            "description": "How many of them renewed"
          },
          "average_arr": {
            "type": "number",
            "minimum": 0,
            "description": "Average ARR per at-risk account",
            "default": 0
          }
        },
        "required": [
          "outreach_accounts",
          "outreach_renewed",
          "holdout_accounts",
          "holdout_renewed"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "calculate_cost_of_churn",
      "title": "Cost of churn calculator",
      "description": "Estimate what churned ARR costs: the sales and marketing cost of winning the same ARR back, plus the gross profit lost in the months it takes to replace it. Same model as renewalfix.com/tools/cost-of-churn-calculator/.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "lost_arr": {
            "type": "number",
            "minimum": 0,
            "description": "ARR lost to churn and downgrades"
          },
          "gross_margin_percent": {
            "type": "number",
            "minimum": 0,
            "maximum": 100,
            "description": "Gross margin, in percent",
            "default": 75
          },
          "months_to_replace": {
            "type": "number",
            "minimum": 0,
            "description": "Months it takes to win the same ARR back",
            "default": 6
          },
          "cost_per_new_arr_dollar": {
            "type": "number",
            "minimum": 0,
            "description": "Sales and marketing cost per $1 of new ARR (CAC ratio)",
            "default": 1.5
          }
        },
        "required": [
          "lost_arr"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "calculate_churn_rate",
      "title": "Churn rate calculator",
      "description": "Calculate customer (logo) churn and revenue churn for a period (a month or a year) from customers and ARR at the start and what was lost, and convert each rate between monthly and annual (annual = 1 \u2212 (1 \u2212 monthly)^12). Give customers_at_start with customers_lost, starting_arr with churned_arr, or both pairs. Same formulas as renewalfix.com/tools/churn-rate-calculator/.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "period": {
            "type": "string",
            "enum": [
              "month",
              "year"
            ],
            "description": "The period the figures cover",
            "default": "month"
          },
          "customers_at_start": {
            "type": "integer",
            "minimum": 0,
            "description": "Paying customers on the first day of the period"
          },
          "customers_lost": {
            "type": "integer",
            "minimum": 0,
            "description": "Customers who canceled or didn't renew during the period",
            "default": 0
          },
          "new_customers": {
            "type": "integer",
            "minimum": 0,
            "description": "Customers won during the period (changes the ending count, not the churn rate)",
            "default": 0
          },
          "starting_arr": {
            "type": "number",
            "minimum": 0,
            "description": "ARR from existing customers at the start of the period"
          },
          "churned_arr": {
            "type": "number",
            "minimum": 0,
            "description": "ARR of the customers who left",
            "default": 0
          },
          "contraction_arr": {
            "type": "number",
            "minimum": 0,
            "description": "ARR lost to downgrades from customers who stayed",
            "default": 0
          }
        },
        "additionalProperties": false
      }
    },
    {
      "name": "calculate_customer_lifetime_value",
      "title": "Customer lifetime value (CLV) calculator",
      "description": "Calculate customer lifetime value (CLV, also called LTV) as gross profit: average ARR per customer \u00d7 gross margin \u00f7 annual customer churn rate. Also returns the expected customer lifetime in years (1 \u00f7 annual churn), gross profit per customer a year, CLV if churn were 2 points lower, and the CLV:CAC ratio when cac is given. Same formula as renewalfix.com/tools/customer-lifetime-value-calculator/.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "average_arr": {
            "type": "number",
            "minimum": 0,
            "description": "Average ARR per customer (total ARR \u00f7 customers)"
          },
          "gross_margin_percent": {
            "type": "number",
            "minimum": 0,
            "maximum": 100,
            "description": "Subscription gross margin, in percent",
            "default": 80
          },
          "annual_churn_percent": {
            "type": "number",
            "minimum": 0,
            "maximum": 100,
            "description": "Annual customer (logo) churn rate, in percent"
          },
          "cac": {
            "type": "number",
            "minimum": 0,
            "description": "Cost to acquire a customer (sales and marketing spend \u00f7 new customers). Optional; enables the CLV:CAC ratio"
          }
        },
        "required": [
          "average_arr",
          "annual_churn_percent"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "calculate_nrr_forecast",
      "title": "NRR forecast calculator",
      "description": "Project net revenue retention (NRR), gross revenue retention (GRR) and ending ARR for the next 12 months from starting ARR and the gross churn, contraction and expansion you expect, as percentages of starting ARR. Includes a sensitivity: NRR and ending ARR if churn is 2 points better or worse. Same formulas as renewalfix.com/tools/nrr-forecast-calculator/.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "starting_arr": {
            "type": "number",
            "minimum": 0,
            "description": "ARR from today's customers"
          },
          "gross_churn_percent": {
            "type": "number",
            "minimum": 0,
            "maximum": 100,
            "description": "Expected ARR lost to customers who leave, as a percent of starting ARR"
          },
          "contraction_percent": {
            "type": "number",
            "minimum": 0,
            "maximum": 100,
            "description": "Expected ARR lost to downgrades, as a percent of starting ARR",
            "default": 0
          },
          "expansion_percent": {
            "type": "number",
            "minimum": 0,
            "description": "Expected expansion from these customers, as a percent of starting ARR",
            "default": 0
          }
        },
        "required": [
          "starting_arr",
          "gross_churn_percent"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "calculate_csm_capacity",
      "title": "CSM capacity calculator",
      "description": "Work out how many customer success managers (CSMs) a book of accounts needs, from the number of accounts in each tier (high-touch, low-touch, tech-touch), the hours each tier takes per account per month, the hours a CSM has for account work each month and a target utilization. Returns CSMs needed (rounded up), accounts per CSM, and, when current_csms is given, the hours short or spare. Same formulas as renewalfix.com/tools/csm-capacity-calculator/.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "high_touch_accounts": {
            "type": "integer",
            "minimum": 0,
            "description": "Accounts in the high-touch tier",
            "default": 0
          },
          "low_touch_accounts": {
            "type": "integer",
            "minimum": 0,
            "description": "Accounts in the low-touch tier",
            "default": 0
          },
          "tech_touch_accounts": {
            "type": "integer",
            "minimum": 0,
            "description": "Accounts in the tech-touch tier",
            "default": 0
          },
          "high_touch_hours_per_account": {
            "type": "number",
            "minimum": 0,
            "description": "Hours per high-touch account per month",
            "default": 8
          },
          "low_touch_hours_per_account": {
            "type": "number",
            "minimum": 0,
            "description": "Hours per low-touch account per month",
            "default": 2
          },
          "tech_touch_hours_per_account": {
            "type": "number",
            "minimum": 0,
            "description": "Hours per tech-touch account per month",
            "default": 0.25
          },
          "hours_per_csm_per_month": {
            "type": "number",
            "minimum": 0,
            "description": "Hours each CSM has for account work in a month, after internal meetings, training and time off",
            "default": 120
          },
          "target_utilization_percent": {
            "type": "number",
            "minimum": 0,
            "maximum": 100,
            "description": "Share of those hours to plan on using, leaving slack for escalations and renewal peaks",
            "default": 80
          },
          "current_csms": {
            "type": "integer",
            "minimum": 0,
            "description": "CSMs on the team today. Optional; enables the hours short or spare"
          }
        },
        "additionalProperties": false
      }
    },
    {
      "name": "search_horizon_resources",
      "title": "Search Horizon's guides, glossary and product pages",
      "description": "Search renewalfix.com for Customer Success and retention topics: guides (renewal risk warning signs, champion left playbook, health score template, churn prediction, board reporting), glossary definitions (GRR, NRR, churn rate, health score and more), free tools, and Horizon product pages. Returns titles, URLs and summaries; add index.md to a URL to read it as markdown.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "minLength": 1,
            "description": "What to look for, e.g. 'champion left' or 'net revenue retention'"
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 10,
            "default": 5
          }
        },
        "required": [
          "query"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "read_horizon_page",
      "title": "Read a renewalfix.com page as markdown",
      "description": "Return the markdown version of a page on renewalfix.com (a guide, glossary term, tool, product, comparison or customer story), given its path or URL.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "path": {
            "type": "string",
            "description": "Path or full URL on renewalfix.com, e.g. /glossary/net-revenue-retention/"
          }
        },
        "required": [
          "path"
        ],
        "additionalProperties": false
      }
    },
    {
      "name": "get_walkthrough_link",
      "title": "Book a Horizon walkthrough",
      "description": "Get the link to book a 30-minute walkthrough of Horizon, renewal risk software for Customer Success teams, on a demo book or the customer's own top accounts.",
      "inputSchema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      }
    }
  ]
}