Skip to main content
Glama

Rahul D Sarker: Marketing & RevOps Tools

SaaS Quick Ratio Engine

saas_quick_ratio_engine
Read-onlyIdempotent

Divide MRR gained (new + expansion) by MRR lost (contraction + churn) to measure growth durability. See the full version at https://rahuldsarker.co/calculators/saas-quick-ratio-engine

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
newMrrYesNew MRR added this period
currencyNoISO 4217 code for money in the result, e.g. "USD", "INR", "EUR", "GBP". Omit to show plain numbers.
churnedMrrYesMRR lost to cancellations/churn
expansionMrrYesExpansion MRR from existing customers
contractionMrrYesMRR lost to downgrades/contraction

Output Schema

TableJSON 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

B3.2/5.0
Behavior3/5

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

Annotations already declare readOnlyHint=true, idempotentHint=true, destructiveHint=false and openWorldHint=false, so safety and reproducibility are fully covered. The description adds the ratio formula (useful behavioral detail) but says nothing about edge cases such as a zero denominator or what happens when optional currency is omitted. Adequate but not rich.

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?

Two short sentences with the core formula front-loaded and no padding. The trailing URL is mildly extraneous for an agent invocation context, keeping it just below a 5.

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 need not be explained, and annotations cover the safety profile. For a simple deterministic calculator the remaining gap is minor — only undefined behavior at a zero denominator is missing, which is a small omission given the low complexity.

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 description coverage is 100%, so all five parameters are already documented in the schema, establishing a baseline of 3. The description reinforces the grouping of the four required inputs into numerator and denominator, which is genuine added meaning, but it says nothing about the optional currency parameter beyond what the schema states.

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

Purpose4/5

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

The description states the exact computation — (new + expansion MRR) ÷ (contraction + churn MRR) — which pins down both the operation and the inputs unambiguously. It never names a sibling tool or explains how it differs from neighbors like mrr_bridge_planner or net_revenue_retention_forecaster, so it falls short of the top tier.

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

Usage Guidelines2/5

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

There is no when-to-use guidance, no prerequisites, and no alternatives named. The only pointer is a URL to a web version of the same calculator, which is not routing guidance for an agent choosing between ~110 sibling analytics tools.

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