Skip to main content
Glama

Rahul D Sarker: Marketing & RevOps Tools

LTV : CAC Ratio Health Grader

ltv_to_cac_ratio_health_grader
Read-onlyIdempotent

Grade the LTV:CAC ratio on a gross-margin basis against health bands, from losing money to under-investing. See the full version at https://rahuldsarker.co/calculators/cac-ltv

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "ltv": "<ltv>",
      "grossMarginPct": "<grossMarginPct>",
      "cac": "<cac>"
    },
    "name": "ltv_to_cac_ratio_health_grader"
  }
}

Input Schema

NameRequiredDescriptionDefault
cacYesFully-loaded customer acquisition cost
ltvYesCustomer LTV (revenue basis)
currencyNoISO 4217 code for money in the result, e.g. "USD", "INR", "EUR", "GBP". Omit to show plain numbers.
grossMarginPctYesGross margin, as a percentage, applied to LTV

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

B3.2/5.0
Behavior3/5

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

Annotations already declare this a safe, idempotent, read-only calculation. The description adds the useful context that grading is gross-margin based and spans bands from 'losing money' to 'under-investing', which characterizes the output. It says nothing about thresholds or band definitions, so credit is moderate.

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

Conciseness3/5

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

The first sentence is tight and front-loaded. The second sentence is a promotional URL ('See the full version at ...') that does not help an agent select or invoke the tool, so it does not fully earn its place.

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?

For a 4-parameter read-only calculator with a full output schema and full annotation coverage, the description is nearly sufficient. The one real gap is not routing the agent between this grader and the ltv_cac_calculator sibling.

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% (each of ltv, cac, grossMarginPct, currency is documented in-schema), so the baseline is 3. The description's 'gross-margin basis' phrasing corroborates grossMarginPct but adds no new syntax or constraint information.

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?

States a specific verb+resource+scope: 'Grade the LTV:CAC ratio on a gross-margin basis against health bands.' The grading-vs-calculation framing implicitly separates it from the sibling ltv_cac_calculator, but the sibling is never named, so an agent must infer the boundary.

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?

No when-to-use guidance, prerequisites, or exclusions. With a sibling literally named ltv_cac_calculator sitting in the same toolset, the description should say when to grade versus when to just compute the ratio, and it does not.

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