Skip to main content
Glama

run_smart_predict_forecast

SmarterDeck SmartPredict™ Probabilistic Forecasting Engine (TimesFM 2.5 P10/P50/P90 + Quantitative Baselines). Exclusively for SmarterDeck Pro & Enterprise accounts. Takes a historical numerical series, computes calibrated P10 (Downside), P50 (Base Median), and P90 (Upside) scenarios in < 5 seconds, and compiles an editable Corporate Brand-Kit PowerPoint (.pptx) with native editable Excel forecast charts.

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": {
      "metric_name": "<metric_name>",
      "historical_values": "<historical_values>"
    },
    "name": "run_smart_predict_forecast"
  }
}

Input Schema

NameRequiredDescriptionDefault
themeNoTema visual de respaldo si no hay Brand Kit activo.corporate_navy
horizonNoCantidad de períodos futuros a proyectar (de 1 a 12).
languageNoIdioma del reporte y del PowerPoint ('es' o 'en').es
metric_nameYesNombre del indicador a proyectar (ej. 'ARR Consolidado ($M)', 'EBITDA Trimestral', 'Flujo de Caja Operativo').
unit_prefixNoPrefijo monetario o de unidad (ej. '$', 'USD ', '€').
unit_suffixNoSufijo de unidad (ej. 'M', '%', 'k').
use_brand_kitNoAplica el Brand Kit Corporativo guardado en la cuenta de SmarterDeck.
historical_labelsNoEtiquetas temporales opcionales para cada valor histórico (ej. ['Q1 23', 'Q2 23', 'Q3 23', 'Q4 23', 'Q1 24', 'Q2 24']).
historical_valuesYesLista ordenada de valores históricos reales (mínimo 3 períodos, ej. [12.4, 13.8, 15.5, 17.2, 18.9, 21.3]).

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • removedInput schema / properties / api_key
      Removed value: -{
      -  "description": "Tu API Key de SmarterDeck (`smd_live_...`), requerida si el cliente MCP no envía header Authorization.",
      -  "type": "string"
      -}
  2. Added

TDQS

A3.6/5.0
Behavior4/5

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

Annotations declare readOnlyHint=false, openWorldHint=true, idempotentHint=false, destructiveHint=false, so the mutation profile is already covered. The description still earns credit by adding context the annotations cannot: the sub-5-second execution claim, the fact that it produces a downloadable .pptx artifact with editable native charts, and the account-tier requirement. It does not state whether repeated runs overwrite or accumulate artifacts, which is the main gap on a non-idempotent tool.

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 opening clause is marketing padding — the brand name, 'SmartPredict™', and the TimesFM version string — that delays the actual capability. It is only two sentences long, so it is not bloated, but the front-loaded branding means the useful content (computes P10/P50/P90, emits .pptx) arrives second. Trimming the trademark and model-version framing would strengthen it.

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 9-parameter tool with full schema coverage and no output schema, this is adequately complete: the description itself explains what the return artifact is (a branded, editable .pptx with native Excel charts), compensating for the missing output schema. Account-tier and performance expectations are also disclosed. The exposure of the sibling relationship remains unaddressed, which keeps 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 description coverage is 100%, so each of the 9 parameters is already documented in the schema, which sets the baseline at 3. The description adds only indirect color: naming P10/P50/P90 and the 'Corporate Brand-Kit' ties loosely to use_brand_kit and the theme fallback. It adds no syntax or interaction detail beyond what the schema already 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 names a concrete action chain: it consumes a historical numeric series, computes calibrated P10/P50/P90 scenarios, and emits an editable .pptx deck with native Excel charts. The verb and resource are specific enough for an agent to match a request to this tool. It stops short of a 5 because it never distinguishes itself from the sibling generate_presentation_suite, even though both clearly produce presentations.

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 only explicit guidance is eligibility: 'Exclusively for SmarterDeck Pro & Enterprise accounts', plus an implicit precondition that a historical numerical series exists. There is no statement of when to prefer this over generate_presentation_suite, nor any when-not-to-use or minimum-data caveat at the description level (the 3-period minimum lives only in the schema). Usage is therefore inferable but not directed.

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