Skip to main content
Glama

Read a model you saved

get_graph
Read-onlyIdempotent

Reads one graph you saved earlier, by its graph_id, and returns the whole model in the same shape the run tools accept. Use this when you want to show the user what is in a saved model, edit it before running it again, or run it with run_monte_carlo_simulation, which takes the model inline and not a graph_id. To find a graph_id first, call list_graphs. It returns the graph_id, the name, when it was last updated, and the graph itself: its uncertain inputs with their distributions, the formula nodes, the links between them and the run settings. It reads the model, not any result of running it. It needs a Neumann account: send your key, or your signed-in token, in the Authorization header as a Bearer credential. No Neumann tool takes an api_key argument. Cost: free -- it debits no credits and spends none of your free daily runs -- but it needs an account; an anonymous caller gets authentication_required.

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": {
      "graph_id": "<graph_id>"
    },
    "name": "get_graph"
  }
}

Input Schema

NameRequiredDescriptionDefault
graph_idYesWhich saved graph to read, from save_graph or list_graphs.

Output Schema

NameRequiredDescriptionDefault
nameYesThe name this graph is saved under.
graphYesThe model itself, in the shape the run tools accept. Edit it and pass it back to run_monte_carlo_simulation, or save the edited version with save_graph and this graph_id. Its full schema is run_monte_carlo_simulation's graph parameter.
billingNoWho you are and what this call cost: principal, auth source, credits debited and balance, or the anonymous allowance left today.
graph_idYesThe id of the graph that was read.
updated_atYesWhen this graph was last saved, as an ISO-8601 time.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed10 schema fields changed
    • removedOutput schema / $defs / AggregationRequest
      Removed value: -{
      -  "additionalProperties": false,
      -  "description": "A post-simulation, series-aware metric over one node's full series.\n\nNPV/IRR/payback/CAGR/cumsum are NOT per-period node values: they consume a\ntarget node's complete ``(time_periods x trials)`` matrix AFTER the run and\nreturn one value per trial, summarised into a distribution.\n\nDiscount convention (0-based series index): period ``t=0`` is the present\n(undiscounted) cash flow; period ``t`` is discounted by ``(1+rate)**t``. The\nfirst period is undiscounted.\n\nWarning — two discount conventions coexist; do not mix them. These\naggregations use the **0-based** series index above (first period\nundiscounted). The per-period formula functions ``DISCOUNT(rate,\n{time_period})`` and ``PV(rate, value, {time_period})`` use the **1-based**\n``{time_period}``, so they discount the first period by ``(1+rate)**1``.\n\n\"Investment at period 0\" pattern: model an up-front outlay as a negative\nperiod-0 cash flow in the target node's series; NPV's t=0-undiscounted\nconvention then treats it as the present-value outlay. Do not additionally\ndiscount that first period with ``PV(...,{time_period})`` inside the target\nnode's formula when also requesting an aggregation ``npv`` — combining the\n1-based per-period discount with the 0-based ``npv`` double-shifts the first\nperiod.\n\nPer-period node vs aggregate metric (``prob``): pointing ``prob`` at a\nmulti-period cash-flow NODE via ``target_node_id`` thresholds only that node's\nFINAL-period per-trial value — i.e. ``P(per-period value > x)``, NOT\n``P(NPV > x)``. To get a true ``P(NPV > 0)``, define an ``npv`` aggregation\nfirst, then add a ``prob`` aggregation whose ``target_aggregation_id`` points\nat that ``npv`` id; ``prob`` then thresholds the NPV per-trial vector directly.\nA ``prob`` request targets EITHER a node (``target_node_id``) OR an earlier\naggregation (``target_aggregation_id``) — exactly one, never both.",
      -  "properties": {
      -    "function": {
      -      "description": "One of: npv, irr, payback, discounted_payback, cagr, cumsum, prob, terminal_value, mirr. discounted_payback requires params.rate; npv requires params.rate OR a per-period params.rates curve; prob requires params.op (one of >, >=, <, <=, ==) and params.value; terminal_value requires params.g and params.rate; mirr requires params.finance_rate and params.reinvest_rate.",
      -      "title": "Function",
      -      "type": "string"
      -    },
      -    "id": {
      -      "description": "Result key for this metric (unique within the request).",
      -      "title": "Id",
      -      "type": "string"
      -    },
      -    "params": {
      -      "additionalProperties": true,
      -      "description": "Function params, e.g. {'rate': 0.1} for npv/discounted_payback, {'op': '>', 'value': 0} for prob, {'g': 0.02, 'rate': 0.1} for terminal_value, {'finance_rate': 0.1, 'reinvest_rate': 0.08} for mirr.",
      -      "title": "Params",
      -      "type": "object"
      -    },
      -    "target_aggregation_id": {
      -      "anyOf": [
      -        {
      -          "type": "string"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ],
      -      "default": null,
      -      "description": "For a ``prob`` request only: the id of an aggregation defined EARLIER in this output_request whose per-trial vector (e.g. an ``npv``) is thresholded. Lets ``P(NPV > 0)`` be expressed directly instead of the per-period ``P(value > x)`` you get by targeting a multi-period node. The referenced aggregation must produce a per-trial vector (npv/irr/payback/discounted_payback/cagr/cumsum/terminal_value/mirr).",
      -      "title": "Target Aggregation Id"
      -    },
      -    "target_node_id": {
      -      "anyOf": [
      -        {
      -          "type": "string"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ],
      -      "default": null,
      -      "description": "The node whose full per-period series the metric consumes. Required for every metric except a ``prob`` that targets a prior aggregation via ``target_aggregation_id``. Exactly one of ``target_node_id`` / ``target_aggregation_id`` may be set on a ``prob`` request.",
      -      "title": "Target Node Id"
      -    }
      -  },
      -  "required": [
      -    "id",
      -    "function"
      -  ],
      -  "title": "AggregationRequest",
      -  "type": "object"
      -}
    • removedOutput schema / $defs / CalcNode
      Removed value: -{
      -  "additionalProperties": false,
      -  "description": "A computed node. ``formula`` is OPTIONAL.\n\nA null/empty/whitespace formula is allowed: the node is treated as a\nconstant ``0`` every period/trial (incoming edges are ignored — there is no\nimplicit \"sum of incoming edges\"). ``check_simulation_model`` surfaces this as a\nWARNING, not an error. To sum incoming edges, write the sum explicitly,\ne.g. ``{e1}+{e2}``; for pass-through use ``{e1}``.",
      -  "properties": {
      -    "formula": {
      -      "anyOf": [
      -        {
      -          "type": "string"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ],
      -      "default": null,
      -      "description": "Optional expression over incoming edge ids, e.g. '{e1} * 0.5 + {e2}'. To sum incoming edges write '{e1}+{e2}'; for pass-through use '{e1}'. If omitted/empty the node is treated as a constant 0 (sum-of-incoming is not implied); check_simulation_model reports this as a warning.",
      -      "title": "Formula"
      -    },
      -    "id": {
      -      "description": "Unique node id within the graph.",
      -      "title": "Id",
      -      "type": "string"
      -    },
      -    "name": {
      -      "default": "",
      -      "description": "Human-readable label.",
      -      "title": "Name",
      -      "type": "string"
      -    }
      -  },
      -  "required": [
      -    "id"
      -  ],
      -  "title": "CalcNode",
      -  "type": "object"
      -}
    • removedOutput schema / $defs / Edge
      Removed value: -{
      -  "additionalProperties": false,
      -  "description": "A directed connection carrying a value from source to target.",
      -  "properties": {
      -    "delay": {
      -      "default": 0,
      -      "description": "Periods the value is delayed in transit.",
      -      "minimum": 0,
      -      "title": "Delay",
      -      "type": "integer"
      -    },
      -    "id": {
      -      "description": "Unique edge id within the graph.",
      -      "title": "Id",
      -      "type": "string"
      -    },
      -    "name": {
      -      "anyOf": [
      -        {
      -          "type": "string"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ],
      -      "default": null,
      -      "description": "Optional label.",
      -      "title": "Name"
      -    },
      -    "source": {
      -      "description": "id of the source node.",
      -      "title": "Source",
      -      "type": "string"
      -    },
      -    "target": {
      -      "description": "id of the target node.",
      -      "title": "Target",
      -      "type": "string"
      -    }
      -  },
      -  "required": [
      -    "id",
      -    "source",
      -    "target"
      -  ],
      -  "title": "Edge",
      -  "type": "object"
      -}
    • removedOutput schema / $defs / OutputRequest
      Removed value: -{
      -  "additionalProperties": false,
      -  "description": "Which nodes/edges/periods to include in the result.\n\nEmpty lists mean 'all': all nodes, all edges, all time periods.\n``aggregations`` requests post-simulation series metrics (NPV/IRR/...).",
      -  "properties": {
      -    "aggregations": {
      -      "items": {
      -        "$ref": "#/$defs/AggregationRequest"
      -      },
      -      "title": "Aggregations",
      -      "type": "array"
      -    },
      -    "edges": {
      -      "items": {
      -        "type": "string"
      -      },
      -      "title": "Edges",
      -      "type": "array"
      -    },
      -    "nodes": {
      -      "items": {
      -        "type": "string"
      -      },
      -      "title": "Nodes",
      -      "type": "array"
      -    },
      -    "time_periods": {
      -      "items": {
      -        "type": "integer"
      -      },
      -      "title": "Time Periods",
      -      "type": "array"
      -    }
      -  },
      -  "title": "OutputRequest",
      -  "type": "object"
      -}
    • removedOutput schema / $defs / PublicGraph
      Removed value: -{
      -  "additionalProperties": false,
      -  "description": "A complete, validated simulation request — the agent-facing input.\n\nThis is the canonical public shape. Reference integrity (edges point at real\nnodes, output_request references real ids) is validated here so malformed\ngraphs are rejected before they ever reach the engine.",
      -  "properties": {
      -    "calc_nodes": {
      -      "items": {
      -        "$ref": "#/$defs/CalcNode"
      -      },
      -      "title": "Calc Nodes",
      -      "type": "array"
      -    },
      -    "contract_version": {
      -      "const": "1.0",
      -      "default": "1.0",
      -      "description": "Schema version this graph targets.",
      -      "title": "Contract Version",
      -      "type": "string"
      -    },
      -    "edges": {
      -      "items": {
      -        "$ref": "#/$defs/Edge"
      -      },
      -      "title": "Edges",
      -      "type": "array"
      -    },
      -    "root_nodes": {
      -      "items": {
      -        "$ref": "#/$defs/RootNode"
      -      },
      -      "title": "Root Nodes",
      -      "type": "array"
      -    },
      -    "run_params": {
      -      "$ref": "#/$defs/RunParams"
      -    }
      -  },
      -  "required": [
      -    "run_params"
      -  ],
      -  "title": "PublicGraph",
      -  "type": "object"
      -}
    • removedOutput schema / $defs / RootNode
      Removed value: -{
      -  "additionalProperties": false,
      -  "description": "A source node that samples from a probability distribution each period.\n\n``json_schema_extra`` (neumann#288) attaches a ``oneOf`` discriminated on\n``distribution_type``, so the published schema states each type's own\nrequired ``distribution_params`` keys instead of advertising an opaque\nobject. The RUNTIME annotation stays ``dict[str, object]`` — see\n``contracts.catalog.add_distribution_variants`` for why a real pydantic\ndiscriminated union is not used here.",
      -  "oneOf": [
      -    {
      -      "description": "A constant value that never changes",
      -      "properties": {
      -        "distribution_params": {
      -          "properties": {
      -            "value": {
      -              "description": "The constant value to return",
      -              "type": "number"
      -            }
      -          },
      -          "required": [
      -            "value"
      -          ],
      -          "type": "object"
      -        },
      -        "distribution_type": {
      -          "const": "constant"
      -        }
      -      },
      -      "required": [
      -        "distribution_type",
      -        "distribution_params"
      -      ],
      -      "title": "constant"
      -    },
      -    {
      -      "description": "Normal (Gaussian) distribution",
      -      "properties": {
      -        "distribution_params": {
      -          "properties": {
      -            "mean": {
      -              "description": "The mean (average) of the distribution",
      -              "type": "number"
      -            },
      -            "std": {
      -              "description": "The standard deviation (spread) of the distribution (positive)",
      -              "type": "number"
      -            }
      -          },
      -          "required": [
      -            "mean",
      -            "std"
      -          ],
      -          "type": "object"
      -        },
      -        "distribution_type": {
      -          "const": "normal"
      -        }
      -      },
      -      "required": [
      -        "distribution_type",
      -        "distribution_params"
      -      ],
      -      "title": "normal"
      -    },
      -    {
      -      "description": "Uniform distribution between low and high values",
      -      "properties": {
      -        "distribution_params": {
      -          "properties": {
      -            "high": {
      -              "description": "Upper bound of the distribution",
      -              "type": "number"
      -            },
      -            "low": {
      -              "description": "Lower bound of the distribution",
      -              "type": "number"
      -            }
      -          },
      -          "required": [
      -            "low",
      -            "high"
      -          ],
      -          "type": "object"
      -        },
      -        "distribution_type": {
      -          "const": "uniform"
      -        }
      -      },
      -      "required": [
      -        "distribution_type",
      -        "distribution_params"
      -      ],
      -      "title": "uniform"
      -    },
      -    {
      -      "description": "Beta distribution for modeling probabilities and proportions",
      -      "properties": {
      -        "distribution_params": {
      -          "properties": {
      -            "alpha": {
      -              "description": "The alpha shape parameter (α) (positive)",
      -              "type": "number"
      -            },
      -            "beta": {
      -              "description": "The beta shape parameter (β) (positive)",
      -              "type": "number"
      -            }
      -          },
      -          "required": [
      -            "alpha",
      -            "beta"
      -          ],
      -          "type": "object"
      -        },
      -        "distribution_type": {
      -          "const": "beta"
      -        }
      -      },
      -      "required": [
      -        "distribution_type",
      -        "distribution_params"
      -      ],
      -      "title": "beta"
      -    },
      -    {
      -      "description": "Gamma distribution for modeling waiting times",
      -      "properties": {
      -        "distribution_params": {
      -          "properties": {
      -            "scale": {
      -              "description": "The scale parameter (θ) (positive)",
      -              "type": "number"
      -            },
      -            "shape": {
      -              "description": "The shape parameter (k) (positive)",
      -              "type": "number"
      -            }
      -          },
      -          "required": [
      -            "shape",
      -            "scale"
      -          ],
      -          "type": "object"
      -        },
      -        "distribution_type": {
      -          "const": "gamma"
      -        }
      -      },
      -      "required": [
      -        "distribution_type",
      -        "distribution_params"
      -      ],
      -      "title": "gamma"
      -    },
      -    {
      -      "description": "Exponential distribution with scale parameter",
      -      "properties": {
      -        "distribution_params": {
      -          "properties": {
      -            "scale": {
      -              "description": "Scale parameter (mean) of the distribution (positive)",
      -              "type": "number"
      -            }
      -          },
      -          "required": [
      -            "scale"
      -          ],
      -          "type": "object"
      -        },
      -        "distribution_type": {
      -          "const": "exponential"
      -        }
      -      },
      -      "required": [
      -        "distribution_type",
      -        "distribution_params"
      -      ],
      -      "title": "exponential"
      -    },
      -    {
      -      "description": "Poisson distribution for modeling count data",
      -      "properties": {
      -        "distribution_params": {
      -          "properties": {
      -            "lambda_val": {
      -              "description": "The rate parameter (λ) (positive)",
      -              "type": "number"
      -            }
      -          },
      -          "required": [
      -            "lambda_val"
      -          ],
      -          "type": "object"
      -        },
      -        "distribution_type": {
      -          "const": "poisson"
      -        }
      -      },
      -      "required": [
      -        "distribution_type",
      -        "distribution_params"
      -      ],
      -      "title": "poisson"
      -    },
      -    {
      -      "description": "Bernoulli distribution for binary outcomes",
      -      "properties": {
      -        "distribution_params": {
      -          "properties": {
      -            "p": {
      -              "description": "The probability of success (between 0 and 1)",
      -              "type": "number"
      -            }
      -          },
      -          "required": [
      -            "p"
      -          ],
      -          "type": "object"
      -        },
      -        "distribution_type": {
      -          "const": "bernoulli"
      -        }
      -      },
      -      "required": [
      -        "distribution_type",
      -        "distribution_params"
      -      ],
      -      "title": "bernoulli"
      -    },
      -    {
      -      "description": "Triangle distribution with minimum, maximum, and mode parameters",
      -      "properties": {
      -        "distribution_params": {
      -          "properties": {
      -            "max_val": {
      -              "description": "The maximum value of the distribution",
      -              "type": "number"
      -            },
      -            "min_val": {
      -              "description": "The minimum value of the distribution",
      -              "type": "number"
      -            },
      -            "mode_val": {
      -              "description": "The mode (peak) of the distribution",
      -              "type": "number"
      -            }
      -          },
      -          "required": [
      -            "min_val",
      -            "max_val",
      -            "mode_val"
      -          ],
      -          "type": "object"
      -        },
      -        "distribution_type": {
      -          "const": "triangle"
      -        }
      -      },
      -      "required": [
      -        "distribution_type",
      -        "distribution_params"
      -      ],
      -      "title": "triangle"
      -    },
      -    {
      -      "description": "Log-normal distribution for modeling skewed, positive-valued data",
      -      "properties": {
      -        "distribution_params": {
      -          "properties": {
      -            "mu": {
      -              "description": "Mean of the underlying normal distribution (log-scale)",
      -              "type": "number"
      -            },
      -            "sigma": {
      -              "description": "Standard deviation of the underlying normal distribution (log-scale) (positive)",
      -              "type": "number"
      -            }
      -          },
      -          "required": [
      -            "mu",
      -            "sigma"
      -          ],
      -          "type": "object"
      -        },
      -        "distribution_type": {
      -          "const": "log_normal"
      -        }
      -      },
      -      "required": [
      -        "distribution_type",
      -        "distribution_params"
      -      ],
      -      "title": "log_normal"
      -    },
      -    {
      -      "description": "Discrete log-normal: sample log-normal then round to nearest integer (zero allowed)",
      -      "properties": {
      -        "distribution_params": {
      -          "properties": {
      -            "mu": {
      -              "description": "Mean of the underlying normal distribution (log-scale)",
      -              "type": "number"
      -            },
      -            "sigma": {
      -              "description": "Standard deviation of the underlying normal distribution (log-scale) (positive)",
      -              "type": "number"
      -            }
      -          },
      -          "required": [
      -            "mu",
      -            "sigma"
      -          ],
      -          "type": "object"
      -        },
      -        "distribution_type": {
      -          "const": "discrete_lognormal"
      -        }
      -      },
      -      "required": [
      -        "distribution_type",
      -        "distribution_params"
      -      ],
      -      "title": "discrete_lognormal"
      -    },
      -    {
      -      "description": "Categorical distribution for discrete outcomes with custom probabilities",
      -      "properties": {
      -        "distribution_params": {
      -          "properties": {
      -            "probabilities": {
      -              "description": "List of probabilities for each value (must sum to 1) (sum to 1)",
      -              "items": {
      -                "type": "number"
      -              },
      -              "type": "array"
      -            },
      -            "values": {
      -              "description": "List of possible values to sample from",
      -              "items": {
      -                "type": "number"
      -              },
      -              "type": "array"
      -            }
      -          },
      -          "required": [
      -            "values",
      -            "probabilities"
      -          ],
      -          "type": "object"
      -        },
      -        "distribution_type": {
      -          "const": "categorical"
      -        }
      -      },
      -      "required": [
      -        "distribution_type",
      -        "distribution_params"
      -      ],
      -      "title": "categorical"
      -    },
      -    {
      -      "description": "Discrete gamma: sample gamma then round to nearest integer (zero allowed)",
      -      "properties": {
      -        "distribution_params": {
      -          "properties": {
      -            "scale": {
      -              "description": "The scale parameter (θ) (positive)",
      -              "type": "number"
      -            },
      -            "shape": {
      -              "description": "The shape parameter (k) (positive)",
      -              "type": "number"
      -            }
      -          },
      -          "required": [
      -            "shape",
      -            "scale"
      -          ],
      -          "type": "object"
      -        },
      -        "distribution_type": {
      -          "const": "discrete_gamma"
      -        }
      -      },
      -      "required": [
      -        "distribution_type",
      -        "distribution_params"
      -      ],
      -      "title": "discrete_gamma"
      -    },
      -    {
      -      "description": "Binomial distribution for modeling the number of successes in n independent trials",
      -      "properties": {
      -        "distribution_params": {
      -          "properties": {
      -            "n": {
      -              "description": "Number of trials (positive integer)",
      -              "type": "integer"
      -            },
      -            "p": {
      -              "description": "Probability of success in each trial (between 0 and 1)",
      -              "type": "number"
      -            }
      -          },
      -          "required": [
      -            "n",
      -            "p"
      -          ],
      -          "type": "object"
      -        },
      -        "distribution_type": {
      -          "const": "binomial"
      -        }
      -      },
      -      "required": [
      -        "distribution_type",
      -        "distribution_params"
      -      ],
      -      "title": "binomial"
      -    },
      -    {
      -      "description": "Dirichlet distribution for modeling correlated probabilities that sum to 1",
      -      "properties": {
      -        "distribution_params": {
      -          "properties": {
      -            "alpha": {
      -              "description": "Concentration parameters for each category (all positive)",
      -              "items": {
      -                "type": "number"
      -              },
      -              "type": "array"
      -            }
      -          },
      -          "required": [
      -            "alpha"
      -          ],
      -          "type": "object"
      -        },
      -        "distribution_type": {
      -          "const": "dirichlet"
      -        }
      -      },
      -      "required": [
      -        "distribution_type",
      -        "distribution_params"
      -      ],
      -      "title": "dirichlet"
      -    },
      -    {
      -      "description": "Constant array distribution for deterministic array values (used internally for scenarios)",
      -      "properties": {
      -        "distribution_params": {
      -          "properties": {
      -            "values": {
      -              "description": "Array of constant values to return",
      -              "items": {
      -                "type": "number"
      -              },
      -              "type": "array"
      -            }
      -          },
      -          "required": [
      -            "values"
      -          ],
      -          "type": "object"
      -        },
      -        "distribution_type": {
      -          "const": "constant_array"
      -        }
      -      },
      -      "required": [
      -        "distribution_type",
      -        "distribution_params"
      -      ],
      -      "title": "constant_array"
      -    },
      -    {
      -      "description": "Discrete normal distribution for integer-valued data with normal characteristics",
      -      "properties": {
      -        "distribution_params": {
      -          "properties": {
      -            "mean": {
      -              "description": "The mean (average) of the distribution",
      -              "type": "number"
      -            },
      -            "std": {
      -              "description": "The standard deviation (spread) of the distribution (positive)",
      -              "type": "number"
      -            }
      -          },
      -          "required": [
      -            "mean",
      -            "std"
      -          ],
      -          "type": "object"
      -        },
      -        "distribution_type": {
      -          "const": "discrete_normal"
      -        }
      -      },
      -      "required": [
      -        "distribution_type",
      -        "distribution_params"
      -      ],
      -      "title": "discrete_normal"
      -    },
      -    {
      -      "description": "Multivariate normal (correlated inputs): draws a vector of correlated values per trial from a mean vector + correlation matrix + per-component standard deviations. Array-valued — feed multiple downstream calc nodes by INDEXing component k (1-based): INDEX({edge}, k).",
      -      "properties": {
      -        "distribution_params": {
      -          "properties": {
      -            "correlation": {
      -              "description": "Square correlation matrix (NxN for N components); diagonal 1.0, symmetric, entries in [-1, 1]",
      -              "items": {
      -                "items": {
      -                  "type": "number"
      -                },
      -                "type": "array"
      -              },
      -              "type": "array"
      -            },
      -            "mean": {
      -              "description": "Mean vector (one entry per correlated component)",
      -              "items": {
      -                "type": "number"
      -              },
      -              "type": "array"
      -            },
      -            "stds": {
      -              "description": "Per-component standard deviations (same length as mean) (all positive)",
      -              "items": {
      -                "type": "number"
      -              },
      -              "type": "array"
      -            }
      -          },
      -          "required": [
      -            "mean",
      -            "stds",
      -            "correlation"
      -          ],
      -          "type": "object"
      -        },
      -        "distribution_type": {
      -          "const": "multivariate_normal"
      -        }
      -      },
      -      "required": [
      -        "distribution_type",
      -        "distribution_params"
      -      ],
      -      "title": "multivariate_normal"
      -    }
      -  ],
      -  "properties": {
      -    "delay": {
      -      "default": 0,
      -      "description": "Periods to wait before the first sample.",
      -      "minimum": 0,
      -      "title": "Delay",
      -      "type": "integer"
      -    },
      -    "distribution_params": {
      -      "additionalProperties": true,
      -      "description": "Params for the chosen distribution. Which keys are required depends on distribution_type -- see this schema's oneOf, or the `neumann://catalog` resource. Common types: normal{mean,std} log_normal{mu,sigma} uniform{low,high} triangle{min_val,max_val,mode_val} beta{alpha,beta} poisson{lambda_val} bernoulli{p}.",
      -      "title": "Distribution Params",
      -      "type": "object"
      -    },
      -    "distribution_type": {
      -      "description": "One of the catalog distributions. Read the catalog from the `neumann://catalog` resource (or the service's contract endpoint); this schema's oneOf also lists every type and its required params.",
      -      "title": "Distribution Type",
      -      "type": "string"
      -    },
      -    "id": {
      -      "description": "Unique node id within the graph.",
      -      "title": "Id",
      -      "type": "string"
      -    },
      -    "interval": {
      -      "default": 1,
      -      "description": "Sample every N periods (1 = every period).",
      -      "minimum": 0,
      -      "title": "Interval",
      -      "type": "integer"
      -    },
      -    "name": {
      -      "default": "",
      -      "description": "Human-readable label.",
      -      "title": "Name",
      -      "type": "string"
      -    },
      -    "sampling_frequency": {
      -      "default": "per_period",
      -      "description": "'once' draws a single value reused across periods.",
      -      "enum": [
      -        "per_period",
      -        "once"
      -      ],
      -      "title": "Sampling Frequency",
      -      "type": "string"
      -    }
      -  },
      -  "required": [
      -    "id",
      -    "distribution_type",
      -    "distribution_params"
      -  ],
      -  "title": "RootNode",
      -  "type": "object"
      -}
    • removedOutput schema / $defs / RunParams
      Removed value: -{
      -  "additionalProperties": false,
      -  "description": "Top-level run configuration.",
      -  "properties": {
      -    "output_request": {
      -      "$ref": "#/$defs/OutputRequest"
      -    },
      -    "time_periods": {
      -      "description": "Number of time periods to simulate.",
      -      "exclusiveMinimum": 0,
      -      "title": "Time Periods",
      -      "type": "integer"
      -    },
      -    "trials": {
      -      "description": "Number of Monte Carlo trials.",
      -      "exclusiveMinimum": 0,
      -      "title": "Trials",
      -      "type": "integer"
      -    }
      -  },
      -  "required": [
      -    "trials",
      -    "time_periods"
      -  ],
      -  "title": "RunParams",
      -  "type": "object"
      -}
    • removedOutput schema / properties / graph / $ref
      Removed value: -"#/$defs/PublicGraph"
    • changedOutput schema / properties / graph / description
      Previous value: -"The model itself, in the shape the run tools accept. Edit it and pass it back to run_monte_carlo_simulation, or save the edited version with save_graph and this graph_id."New value: +"The model itself, in the shape the run tools accept. Edit it and pass it back to run_monte_carlo_simulation, or save the edited version with save_graph and this graph_id. Its full schema is run_monte_carlo_simulation's graph parameter."
    • addedOutput schema / properties / graph / type
      Added value: +"object"
  2. Added

TDQS

A4.6/5.0
Behavior5/5

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

Goes well beyond the readOnly/idempotent/non-destructive annotations by disclosing the auth contract (Bearer key or signed-in token, no api_key argument, anonymous callers get authentication_required) and the cost profile (free, debits no credits, consumes no daily runs). It also enumerates what the payload contains and what it does not contain (run results).

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?

Front-loaded with what it does, then when to use it, then the identifier source, then return contents, then auth and cost. Slightly dense across several sentences, but every sentence conveys operational information an agent needs.

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?

An output schema exists, yet the description still sketches the returned model contents (uncertain inputs with distributions, formula nodes, links, run settings). Combined with auth, cost, and identifier sourcing, nothing needed 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.

Parameters3/5

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

Schema coverage is 100% and the graph_id property already carries an example and its provenance ('from save_graph or list_graphs'), so the description largely restates that. The one added nuance, that run_monte_carlo_simulation takes an inline model rather than a graph_id, is usage guidance rather than parameter semantics, so the baseline 3 applies.

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?

States a specific verb and resource ('Reads one graph you saved earlier, by its graph_id') and scopes the return ('the whole model in the same shape the run tools accept'). This plainly separates it from list_graphs and the run/result tools in the sibling set.

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?

Gives concrete when-to-use cases: show the user a saved model, edit before re-running, or feed run_monte_carlo_simulation, which explicitly does not accept a graph_id. It also names the prerequisite path to an identifier ('To find a graph_id first, call list_graphs') and an explicit exclusion ('It reads the model, not any result of running it').

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