Servidor MCP

scenariosim-mcp

io.github.inity13/scenariosim-mcp
Negocio y operaciones Datos y analítica Público y accesible MCP 2026-07-28

Qué hace este MCP

Runs deterministic business and financial what-if projections, scenario comparisons, sensitivity analyses, and break-even calculations.

break_even
Solve for the input value required to make an output metric hit a target value (deterministic bisection root-finding). Provide 'template', 'solve_for' (the input to solve), 'target_metric' (defaults to the primary output), and 'target_value'. Optionally pass 'bounds' [low, high] to constrain the search. Returns the required input value, the change from baseline, the achieved metric, and the residual. Assumes the metric is monotonic in the solved input over the range.
Esquema de entrada
{'type': 'object', 'required': ['template', 'solve_for', 'target_value'], 'properties': {'bounds': {'type': 'array', 'items': {'type': 'number'}, 'description': 'Optional [low, high] search range for the solved input. Auto-derived + expanded if omitted.'}, 'inputs': {'type': 'object', 'description': 'Scenario assumptions as {name: value}. Which keys are valid depends on the template (call list_templates). Unlisted keys fall back to documented defaults; unknown keys are ignored and reported in notes. You may also pass assumptions at the top level.'}, 'horizon': {'type': 'integer', 'default': 12, 'description': 'Number of periods to project forward (1..1200). Default depends on template (usually 12).'}, 'template': {'type': 'string', 'description': "Pre-built scenario template id: saas_growth, pricing_change, churn_impact, cost_reduction, hiring_plan, cash_runway, unit_economics, marketing_funnel, compound_growth (aliases like 'saas','pricing','runway','ltv' also resolve). Omit (or use 'custom') to run a free-form 'metrics' projection."}, 'solve_for': {'type': 'string', 'description': 'Name of the input variable to solve for.'}, 'period_label': {'enum': ['day', 'week', 'month', 'quarter', 'year'], 'type': 'string', 'default': 'month', 'description': 'Label for each period; also sets annualization (periods/year).'}, 'target_value': {'type': 'number', 'description': 'The value the target_metric should reach.'}, 'target_metric': {'type': 'string', 'description': "Output metric to hit (defaults to the template's primary output)."}}}
compare_scenarios
Run 2-3 scenarios and compare their key_results side by side, with deltas against the first (baseline) scenario. Provide a 'scenarios' array where each entry is {name?, template, inputs} (each may set its own horizon, or pass a shared top-level 'horizon'). Optionally rank on 'compare_metric' with 'goal' ('max' default | 'min') to pick a winner, and set include_projections:true to also return per-period series.
Esquema de entrada
{'type': 'object', 'required': ['scenarios'], 'properties': {'goal': {'enum': ['max', 'min'], 'type': 'string', 'default': 'max', 'description': 'Whether higher (max) or lower (min) is better for compare_metric.'}, 'horizon': {'type': 'integer', 'description': "Optional shared horizon applied to scenarios that don't set their own."}, 'scenarios': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'inputs': {'type': 'object', 'description': 'Scenario assumptions as {name: value}. Which keys are valid depends on the template (call list_templates). Unlisted keys fall back to documented defaults; unknown keys are ignored and reported in notes. You may also pass assumptions at the top level.'}, 'horizon': {'type': 'integer', 'default': 12, 'description': 'Number of periods to project forward (1..1200). Default depends on template (usually 12).'}, 'metrics': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'start'], 'properties': {'mode': {'enum': ['compound', 'linear'], 'type': 'string', 'default': 'compound'}, 'name': {'type': 'string'}, 'start': {'type': 'number'}, 'growth_rate': {'type': 'number'}}}, 'description': "For a CUSTOM free-form scenario (template omitted or 'custom'): a list of independently-growing metrics. Each: {name, start, growth_rate (per period, default 0), mode: 'compound' (default) | 'linear'}."}, 'template': {'type': 'string', 'description': "Pre-built scenario template id: saas_growth, pricing_change, churn_impact, cost_reduction, hiring_plan, cash_runway, unit_economics, marketing_funnel, compound_growth (aliases like 'saas','pricing','runway','ltv' also resolve). Omit (or use 'custom') to run a free-form 'metrics' projection."}, 'period_label': {'enum': ['day', 'week', 'month', 'quarter', 'year'], 'type': 'string', 'default': 'month', 'description': 'Label for each period; also sets annualization (periods/year).'}}}, 'description': '2-3 scenarios to compare. Each: {name?, template, inputs, horizon?, period_label?} or {name?, metrics:[...]} for a custom model.'}, 'compare_metric': {'type': 'string', 'description': 'Metric to rank scenarios on (optional).'}, 'include_projections': {'type': 'boolean', 'default': False, 'description': "Include each scenario's full per-period projections."}}}
health_check
Server health, version, and capabilities (tools, templates, period labels, max horizon). No parameters.
Esquema de entrada
{'type': 'object', 'properties': {}}
list_templates
Discovery tool: list every pre-built scenario template (id, label, category, description, primary output, documented inputs with defaults/units, and available output metrics), plus how to run a custom free-form scenario and the supported period labels. No required parameters.
Esquema de entrada
{'type': 'object', 'properties': {}}
run_scenario
Main simulation tool. Run a deterministic what-if projection from a pre-built template (saas_growth, pricing_change, churn_impact, cost_reduction, hiring_plan, cash_runway, unit_economics, marketing_funnel, compound_growth) OR a free-form 'metrics' model. Returns period-by-period projections, headline key_results, the exact assumptions used (with defaults filled in), the methodology, notes, and a plain-language explanation. Pass 'template' + 'inputs' (assumptions), plus optional 'horizon' and 'period_label'. 100% deterministic (40-digit decimal math).
Esquema de entrada
{'type': 'object', 'properties': {'inputs': {'type': 'object', 'description': 'Scenario assumptions as {name: value}. Which keys are valid depends on the template (call list_templates). Unlisted keys fall back to documented defaults; unknown keys are ignored and reported in notes. You may also pass assumptions at the top level.'}, 'horizon': {'type': 'integer', 'default': 12, 'description': 'Number of periods to project forward (1..1200). Default depends on template (usually 12).'}, 'metrics': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'start'], 'properties': {'mode': {'enum': ['compound', 'linear'], 'type': 'string', 'default': 'compound'}, 'name': {'type': 'string'}, 'start': {'type': 'number'}, 'growth_rate': {'type': 'number'}}}, 'description': "For a CUSTOM free-form scenario (template omitted or 'custom'): a list of independently-growing metrics. Each: {name, start, growth_rate (per period, default 0), mode: 'compound' (default) | 'linear'}."}, 'template': {'type': 'string', 'description': "Pre-built scenario template id: saas_growth, pricing_change, churn_impact, cost_reduction, hiring_plan, cash_runway, unit_economics, marketing_funnel, compound_growth (aliases like 'saas','pricing','runway','ltv' also resolve). Omit (or use 'custom') to run a free-form 'metrics' projection."}, 'period_label': {'enum': ['day', 'week', 'month', 'quarter', 'year'], 'type': 'string', 'default': 'month', 'description': 'Label for each period; also sets annualization (periods/year).'}}}
sensitivity_analysis
Vary one or more input assumptions and show the impact on a target output metric (one-at-a-time sensitivity). Provide 'template', the input to sweep via 'variable' (or 'variables' array), and 'target_metric' (defaults to the template's primary output). Control the sweep with 'variation' (fractional +/- around the baseline, default 0.2), 'steps' (default 5), or explicit 'values' / 'min'+'max'. Returns per-variable sweeps, an elasticity estimate, the output range, and a ranking of the most influential inputs.
Esquema de entrada
{'type': 'object', 'required': ['template'], 'properties': {'max': {'type': 'number', 'description': "Sweep upper bound (with 'min')."}, 'min': {'type': 'number', 'description': "Sweep lower bound (with 'max')."}, 'steps': {'type': 'integer', 'default': 5, 'description': 'Number of sweep points per variable (2-200).'}, 'inputs': {'type': 'object', 'description': 'Scenario assumptions as {name: value}. Which keys are valid depends on the template (call list_templates). Unlisted keys fall back to documented defaults; unknown keys are ignored and reported in notes. You may also pass assumptions at the top level.'}, 'values': {'type': 'array', 'items': {'type': 'number'}, 'description': "Explicit sweep values for a single 'variable'."}, 'horizon': {'type': 'integer', 'default': 12, 'description': 'Number of periods to project forward (1..1200). Default depends on template (usually 12).'}, 'template': {'type': 'string', 'description': "Pre-built scenario template id: saas_growth, pricing_change, churn_impact, cost_reduction, hiring_plan, cash_runway, unit_economics, marketing_funnel, compound_growth (aliases like 'saas','pricing','runway','ltv' also resolve). Omit (or use 'custom') to run a free-form 'metrics' projection."}, 'variable': {'type': 'string', 'description': 'A single input name to sweep.'}, 'variables': {'type': 'array', 'items': {'type': 'object', 'required': ['name'], 'properties': {'max': {'type': 'number'}, 'min': {'type': 'number'}, 'name': {'type': 'string'}, 'steps': {'type': 'integer'}, 'values': {'type': 'array', 'items': {'type': 'number'}}, 'variation': {'type': 'number'}}}, 'description': 'Multiple inputs to sweep (one at a time). Each: {name, variation?|values?|min?+max?, steps?}.'}, 'variation': {'type': 'number', 'default': 0.2, 'description': 'Fractional sweep around the baseline (0<v<=1). 0.2 = +/-20%.'}, 'period_label': {'enum': ['day', 'week', 'month', 'quarter', 'year'], 'type': 'string', 'default': 'month', 'description': 'Label for each period; also sets annualization (periods/year).'}, 'target_metric': {'type': 'string', 'description': "Output metric to track (see a template's 'outputs' via list_templates). Defaults to the template's primary output."}}}
Añadido
health_check
17 de September de 2026 a las 12:42
Añadido
list_templates
17 de September de 2026 a las 12:42
Añadido
compare_scenarios
17 de September de 2026 a las 12:42
Añadido
break_even
17 de September de 2026 a las 12:42
Añadido
sensitivity_analysis
17 de September de 2026 a las 12:42
Añadido
run_scenario
17 de September de 2026 a las 12:42