Skip to main content
Glama

Rahul D Sarker: Marketing & RevOps Tools

Renewals Pipeline Health Grader

renewals_pipeline_health_grader
Read-onlyIdempotent

Grade an account renewal on weighted 90-day signals (adoption, sponsor strength, support sentiment, realised value) and quantify ARR at risk. See the full version at https://rahuldsarker.co/calculators/renewals-pipeline-health-grader

Input Schema

NameRequiredDescriptionDefault
currencyNoISO 4217 code for money in the result, e.g. "USD", "INR", "EUR", "GBP". Omit to show plain numbers.
accountArrYesAccount ARR
productAdoptionTrendYesProduct adoption / usage trend, weight 30
realisedValueVsGoalsYesRealised value vs. goals, weight 30
supportSentimentTrendYesSupport sentiment / ticket trend, weight 20
executiveSponsorStrengthYesExecutive sponsor strength, weight 20

Output Schema

NameRequiredDescriptionDefault
urlYes
kindYes
toolYesThe calculator tool that produced this result
notesYes
titleYes
inputsYes
compactYes
metricsYesEvery "Label: value" line of the result; value is the first number on the line
currencyYes
benchmarksYesRule-of-thumb verdicts for the headline numbers
bookingUrlYes
calculatorYesSlug of the interactive calculator on rahuldsarker.co

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedInput schema / properties / currency
      Added value: +{
      +  "description": "ISO 4217 code for money in the result, e.g. \"USD\", \"INR\", \"EUR\", \"GBP\". Omit to show plain numbers.",
      +  "pattern": "^[A-Za-z]{3}$",
      +  "type": "string"
      +}
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$schema": "https://json-schema.org/draft/2020-12/schema",
      +  "additionalProperties": false,
      +  "properties": {
      +    "benchmarks": {
      +      "description": "Rule-of-thumb verdicts for the headline numbers",
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "band": {
      +            "type": "string"
      +          },
      +          "display": {
      +            "type": "string"
      +          },
      +          "metric": {
      +            "type": "string"
      +          },
      +          "name": {
      +            "type": "string"
      +          },
      +          "read": {
      +            "type": "string"
      +          },
      +          "segment": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "source": {
      +            "type": "string"
      +          },
      +          "target": {
      +            "type": "string"
      +          },
      +          "tone": {
      +            "enum": [
      +              "good",
      +              "ok",
      +              "warn",
      +              "bad"
      +            ],
      +            "type": "string"
      +          },
      +          "value": {
      +            "type": "number"
      +          }
      +        },
      +        "required": [
      +          "metric",
      +          "name",
      +          "value",
      +          "display",
      +          "band",
      +          "tone",
      +          "read",
      +          "target",
      +          "segment",
      +          "source"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "bookingUrl": {
      +      "type": "string"
      +    },
      +    "calculator": {
      +      "description": "Slug of the interactive calculator on rahuldsarker.co",
      +      "type": "string"
      +    },
      +    "compact": {
      +      "type": "boolean"
      +    },
      +    "currency": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "inputs": {
      +      "additionalProperties": {},
      +      "propertyNames": {
      +        "type": "string"
      +      },
      +      "type": "object"
      +    },
      +    "kind": {
      +      "const": "calculator",
      +      "type": "string"
      +    },
      +    "metrics": {
      +      "description": "Every \"Label: value\" line of the result; value is the first number on the line",
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "display": {
      +            "type": "string"
      +          },
      +          "label": {
      +            "type": "string"
      +          },
      +          "unit": {
      +            "anyOf": [
      +              {
      +                "enum": [
      +                  "currency",
      +                  "x",
      +                  "%",
      +                  "months"
      +                ],
      +                "type": "string"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "value": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          }
      +        },
      +        "required": [
      +          "label",
      +          "value",
      +          "unit",
      +          "display"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "notes": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "title": {
      +      "type": "string"
      +    },
      +    "tool": {
      +      "description": "The calculator tool that produced this result",
      +      "type": "string"
      +    },
      +    "url": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "kind",
      +    "tool",
      +    "title",
      +    "calculator",
      +    "url",
      +    "bookingUrl",
      +    "currency",
      +    "compact",
      +    "inputs",
      +    "metrics",
      +    "notes",
      +    "benchmarks"
      +  ],
      +  "type": "object"
      +}
  2. First observed

TDQS

A3.7/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint, idempotentHint, destructiveHint=false and openWorldHint=false, so safety behavior needs no restatement. The description adds the 90-day weighted-scoring framing and the ARR-at-risk outcome, but no computational caveats beyond what the schema's weight annotations already convey.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The purpose and outputs are front-loaded in one dense sentence; the second sentence is purely a promotional link, which is the only element not strictly earning its place. Still compact and well-ordered overall.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists so return values are covered, and annotations cover the safety profile. Combined with a 100%-documented parameter schema this is nearly complete; only the external-link sentence and absent usage prerequisites keep it from a 5.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% and each input has an enum plus a weight note, so the schema does the heavy lifting. The description only restates the same four signal names and adds no extra meaning (no rating criteria, no threshold interpretation).

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb (Grade) and resource (an account renewal), names the four weighted signals it consumes, and adds the concrete second outcome (ARR at risk). That combination distinguishes it from adjacent graders such as ltv_to_cac_ratio_health_grader or product_usage_frequency_grader without needing the schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The usage context is only implied: an agent can infer it is for renewal-risk assessment of a single account, but there is no explicit when-to-use, no prerequisites (e.g. data needed to rate the signals), and no pointer to alternatives like net_revenue_retention_forecaster or saas_churn_cohort_visualizer.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources