Skip to main content
Glama

Startup Valuation MCP Server

Options & Scenario Analysis

valuation_advanced
Read-onlyIdempotent

Advanced techniques: Black-Scholes call value, binomial-tree option value, and scenario analysis. Method selects the technique. For a quick expected value over arbitrary outcome lists, prefer valuation_probability with method 'probability_weighted'; scenario_analysis here is for explicit named bull/base/bear scenario tables. Parameters apply per method: black_scholes and binomial need underlying + strike + risk_free_rate + volatility + time_to_maturity (binomial adds steps); scenario_analysis needs scenarios. Not for plain discounted cash flow — for that use valuation_time_value. Only method is required; all other parameters are method-dependent, so supply those the selected method names and omit the rest (defaults apply where defined). Rate and decimal inputs are fractions (0.10 = 10%); probability and weight lists are in [0,1] and sum to 1. Returns value, method, inputs, assumptions, chapter, formula_number and calculation steps; pure arithmetic — no I/O and no external calls — rounded to 2 decimals, with no auth or rate limits. An unknown method, or a missing method-required parameter, returns an error instead of a value.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
stepsNoBinomial tree time steps (higher = more accurate).
methodYesFormula to apply. Options: black_scholes = C = N(d₁)S - N(d₂)Ke^(-rT).; binomial = Cox-Ross-Rubinstein binomial option value.; scenario_analysis = E[V] = Σ pᵢ·Vᵢ over named scenarios.
strikeNoStrike / exercise price K, currency units.
scenariosNoScenario objects: {name: str, probability: 0-1, value: currency}; probabilities should sum to 1.
underlyingNoUnderlying asset value S, currency units.
volatilityNoAnnualised volatility σ as a decimal (0.80 = 80%).
risk_free_rateNoRisk-free rate as a decimal (e.g. 0.04 for 4%).
time_to_maturityNoTime to expiry in years T.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
errorNoError message when the call fails.
stepsNoIntermediate steps for traceability.
valueYesComputed valuation or metric.
inputsNoEcho of the normalised inputs used.
methodNoFormula / method name that produced the result.
chapterNoSource textbook chapter.
assumptionsNoModelling assumptions applied.
formula_numberNoSource textbook formula number (e.g. '3.1').

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.6/5.0
Behavior4/5

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

Annotations already declare readOnly, idempotent, non-destructive, and closed-world, so the safety profile is covered. The description adds genuinely new behavioral facts: pure arithmetic with no I/O or external calls, no auth or rate limits, output rounded to 2 decimals, and error-on-unknown-method/missing-parameter behavior. Only slightly below top marks because the return-field listing partly overlaps the existing output schema.

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?

Dense but well-organized: technique enumeration, then routing guidance, then per-method parameter mapping, then output/error behavior. Nearly every sentence carries information, though the return-value sentence is somewhat redundant given the output schema.

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

Completeness5/5

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

For an 8-parameter, one-required method-dispatch tool with full schema coverage and an output schema, the description covers selection, per-method parameter requirements, unit conventions, and failure modes. Nothing an agent needs to invoke it correctly is missing.

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

Parameters4/5

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

Schema coverage is 100%, so the baseline is 3. The description goes beyond that by mapping parameters to methods (black_scholes/binomial need underlying+strike+risk_free_rate+volatility+time_to_maturity, binomial adds steps, scenario_analysis needs scenarios) and by confirming fraction/[0,1] conventions and that omitted method-relevant defaults apply.

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?

The opening states specific techniques (Black-Scholes call value, binomial-tree option value, scenario analysis) and the controlling parameter (method selects the technique). It explicitly distinguishes itself from siblings, naming valuation_probability for quick expected values and valuation_time_value for DCF, so an agent can route without opening any schema.

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

Usage Guidelines5/5

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

Explicit when-to-use and when-not-to-use guidance is given: scenario_analysis here is for explicit named bull/base/bear tables, whereas arbitrary outcome lists should go to valuation_probability; plain DCF belongs to valuation_time_value. It also states only method is required and that the remaining parameters are method-dependent.

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.