Metric definitions

syrto_search_metric_definitions returns full metric definitions including the name, description, calculation formula, unit of measure, direction (better if higher/lower/near target), and dependency links showing the causal chain between metrics.

Use this tool to

Understand what a specific financial metric means, how it’s calculated, and what drives it
Explore causal relationships between metrics and identify dependencies
Resolve a metric name to its slug before calling syrto_get_company_metrics

Arguments

string

required

Keyword (e.g. "profitability", "working capital", "debt") or exact slug (e.g. "ebitda", "roe", "net_working_capital"). Exact slug lookup always returns a single result instantly.

integer

Maximum results for keyword search. Default 5, maximum 20. Ignored for exact slug matches.

string

"en" for English (default) or "it" for Italian.

Returns

A JSON list of metric definitions, each containing:

string

Human-readable metric name.

string

Internal metric identifier (slug). Use as input to syrto_get_company_metrics via the metric_slugs parameter. Use name for display.

string | null

Abbreviated metric name, if available.

string

Plain-language explanation of what the metric measures.

string

Metric type - one of the types List available metrics groups the catalogue by.

string

Unit of measure: "EUR" for an amount, "%" for a percentage, "" (empty) for a dimensionless ratio, index or score, or a measurement unit such as "Day" or "Person". A rate carries its denominator, e.g. "EUR/Person".Values are stored unmultiplied and are not bounded to 0-1: a 120% ROI is stored as 1.2 and a -15% margin as -0.15. A percentage and a dimensionless metric share that form and differ only in how they are displayed.

string

"HIGHER", "LOWER", or "NEAR_TARGET".

float | null

Target value when better_if is "NEAR_TARGET". null for HIGHER or LOWER metrics.

integer

Number of decimal places for displaying the metric value.

string

How the metric is computed, as a LaTeX math expression - for example \frac{\text{Added value}}{\text{GDP}}. Render it as maths where the client can.Present it with the description rather than instead of it: the description says what the metric measures, and the formula is the only place the maths is given. It names the metrics it consumes in words rather than by slug, so it is safe to show in full.Empty string for a metric that is a raw financial-statement line item rather than a calculation - a large share of the catalogue.

object[]

Metrics this one feeds into, one entry per relation. Each entry has:

name - the linked metric’s human-readable name. null only when the catalog holds no metric under that slug, in which case the link is unnamed rather than nameless
syrto_code - internal slug, only useful as input to syrto_get_company_metrics
year_delta - the year offset at which the two metrics are linked

object[]

Metrics that drive this one, same shape as affects.

integer

On each dependency link, the year offset at which the two metrics are related: 0 the same year, -1 the previous year, and so on. The same metric can appear more than once at different offsets - a three-year growth metric consumes its base metric at two different years - so those are distinct relations, not repeated entries. Count a metric once when answering “how many metrics does this affect?”

When a keyword matches no metric, result is an empty list and warning suggests a broader term - not an error. Beside result, the response carries the fields every tool returns. On this tool display_title is always Syrto AI and subtitle is not set.

Example

Look up EBITDA and its dependencies:

{
  "query": "ebitda"
}

Response (abbreviated):

{
  "result": [
    {
      "name": "EBITDA",
      "syrto_code": "ebitda",
      "short_name": "EBITDA",
      "description": "Earnings before interest, taxes, depreciation, and amortisation. Measures operating profitability before non-cash charges.",
      "type": "profitability",
      "uom": "EUR",
      "better_if": "HIGHER",
      "better_if_target": null,
      "fraction_digits": 2,
      "calculation_formula": "\\text{Operating profit} + \\text{Depreciation} + \\text{Amortisation}",
      "affects": [
        { "name": "EBITDA Margin", "syrto_code": "ebitda_margin", "year_delta": 0 },
        { "name": "Debt / EBITDA", "syrto_code": "debt_ebitda_ratio", "year_delta": 0 }
      ],
      "is_affected_by": [
        { "name": "Revenues From Sales And Services", "syrto_code": "revenues_from_sales_and_services", "year_delta": 0 }
      ]
    }
  ],
  "reference_url": "https://app.syrto.ai",
  "display_title": "Syrto AI",
  "allowance": "▕████████████████░░░░▏"
}

Getting started

Tools

Metric definitions

Use this tool to

Arguments

Returns

Example

​Use this tool to

​Arguments

​Returns

​Example

Use this tool to

Arguments

Returns

Example