Skip to main content
Glama

Mastering Financial Markets

Select MFM companies by parameters

screen_companies
Read-onlyIdempotent

Filter and sort ALL MFM company profiles (about 10,700 listed companies) by the parameters the USER chooses, using the latest twelve months of each profile (the latest fiscal year or, when more recent, the reconstructed trailing twelve months; balance sheet at the end of that period; multi-year growth from the annual history): period_end in each result gives the end of that period, which is not necessarily a fiscal year end. Returns at most 25 companies (default 25) with only the requested summary parameters, the audit level, a link and the exact fetch_id of the complete page; it never returns complete company pages and does not consume the complete-page quota. The order is the one chosen by the user: it is a data selection, not a recommendation, rating or investment advice; say so to the user. Ratios marked [fraction] are decimals (0.15 = 15%) both in filters and in results. Missing values never pass a filter or a sort. Quota per MFM account: at most 100 different companies shown per calendar month (UTC), shared with the website; re-running a filter or showing a company already shown this month costs nothing; complete pages read afterwards with fetch count toward first 30 days: 10 profiles per day and 30 companies per month; then 10 every 5 minutes, 40 per day and 100 companies per month (UTC day and month; shared by website and AI) (for more, contact the Observatory). BOND CALCULATOR: search "bond: etf=TLT" or "bond: settlement=2026-11-04; currency=EUR; price=100; 2027-11-04=105". No quota consumed. Metrics: years_in_profit_5: Profitable years in the last 5; years_owner_earnings_to_debt: Years of owner earnings to repay debt; years_owner_earnings_to_debt_with_commitments: Years of owner earnings to repay debt + commitments; years_earnings_to_debt: Years of earnings to repay debt; years_earnings_to_debt_with_commitments: Years of earnings to repay debt + commitments; shares_change_3y: Change in shares outstanding, 3 years [fraction]; cash_conversion: Cash conversion; interest_coverage: Interest coverage ratio; croe_gross: CROE [fraction]; croe_tangible: Tangible CROE [fraction]; croic_gross: CROIC, gross (adjusted FCF) [fraction]; croic_gross_with_commitments: CROIC, gross (adjusted FCF) + commitments [fraction]; croic_gross_avg_5y: CROIC gross, 5-year average [fraction]; croic_tangible: CROIC, tangible (adjusted FCF) [fraction]; croic_tangible_with_commitments: CROIC, tangible (adjusted FCF) + commitments [fraction]; debt_to_equity: Debt-to-equity ratio, equity excluding OCI; debt_to_equity_with_commitments: Debt-to-equity ratio, equity excluding OCI + commitments; capital_intensity: Capital intensity [fraction]; fcf_margin: Free cash flow margin, MFM adjusted [fraction]; net_margin: Net profit margin, MFM adjusted [fraction]; owner_earnings_to_assets: Owner earnings to total assets [fraction]: Card owner earnings (metrics.owner_earnings) / closing total assets for the same fiscal year (values.total assets), in the same currency and unit. Only with immaterial non-controlling interests: their equity absent with evidence, zero with evidence, or in absolute value below 5% of positive total equity; their income, when available, in absolute value below 5% of net income for the same year (zero net income allowed only with zero minority income). Otherwise null with a reason. Unchanged numerator, including negatives; consolidated owner earnings are not reconstructed. MFM proxy: all capex treated as maintenance, additional working capital not deducted; neither a guaranteed lower bound nor distributable cash.; owner_earnings_to_assets_avg_5y: Owner earnings to total assets, 5-year average [fraction]: Arithmetic mean of the five annual owner_earnings_to_assets ratios for consecutive distinct fiscal years, all available; otherwise null with a reason. Each ratio requires the same currency and unit for numerator and assets within its year; different currencies across years do not prevent averaging. It is not a ratio of cumulative amounts.; owner_earnings_cagr_3y: Owner earnings CAGR, 3 years [fraction]; revenue_cagr_3y: Revenue CAGR, 3 years [fraction]; revenue_cagr_5y: Revenue CAGR, 5 years [fraction]; buffett_roe_gross: Buffett ROE, gross (income / adjusted capital) [fraction]; buffett_roe_gross_with_commitments: Buffett ROE, gross (income / adjusted capital) + commitments [fraction]; buffett_roe_tangible: Buffett ROE, tangible (income / adjusted capital) [fraction]; buffett_roe_tangible_with_commitments: Buffett ROE, tangible (income / adjusted capital) + commitments [fraction]; roe_gross: Return on equity (ROE) [fraction]; roe_tangible: Return on equity (ROE), MFM tangible [fraction]; roi: ROI [fraction]; buffett_roic_gross: Return on invested capital (ROIC), MFM gross [fraction]; buffett_roic_gross_with_commitments: Return on invested capital (ROIC), MFM gross + commitments [fraction]; buffett_roic_gross_avg_5y: Buffett ROIC gross, 5-year average [fraction]; gross_roic_minus_buffett_wacc: Gross ROIC − Buffett WACC [fraction]; gross_roic_minus_buffett_wacc_with_commitments: Gross ROIC − Buffett WACC + commitments [fraction]; buffett_roic_gross_min_5y: Buffett ROIC gross, 5-year minimum [fraction]; textbook_roic: Return on invested capital (ROIC), textbook [fraction]; textbook_roic_minus_wacc: Textbook ROIC − WACC [fraction]; buffett_roic_tangible: Return on invested capital (ROIC), MFM tangible [fraction]; buffett_roic_tangible_with_commitments: Return on invested capital (ROIC), MFM tangible + commitments [fraction]; buffett_roic_tangible_with_commitments_avg_5y: Buffett ROIC tangible + commitments, 5-year average [fraction]; tangible_roic_minus_buffett_wacc: Tangible ROIC − Buffett WACC [fraction]; tangible_roic_minus_buffett_wacc_with_commitments: Tangible ROIC − Buffett WACC + commitments [fraction]; tangible_roic_minus_buffett_wacc_adjusted: Tangible ROIC + commitments − adjusted WACC [fraction]; tangible_roic_minus_wacc_no_premium: Tangible ROIC − WACC, no premium [fraction]; tangible_roic_minus_wacc_no_premium_with_commitments: Tangible ROIC − WACC, no premium + commitments [fraction]; operating_income_cagr_3y: Operating income CAGR, 3 years [fraction]; operating_income_cagr_5y: Operating income CAGR, 5 years [fraction]; owner_earnings_over_assets: Owner earnings / total assets [fraction]; derivatives_change_3y: 3-year derivatives change [fraction]; buffett_wacc: Weighted average cost of capital (WACC), MFM Buffett method [fraction]; buffett_wacc_with_commitments: Weighted average cost of capital (WACC), MFM Buffett method + commitments [fraction]; buffett_wacc_adjusted: Buffett WACC adjusted (derivatives 3y, MFM heuristic scenario) [fraction]; buffett_wacc_no_premium: Buffett WACC, no premium [fraction]; buffett_wacc_no_premium_with_commitments: Buffett WACC, no premium + commitments [fraction]; textbook_wacc: Weighted average cost of capital (WACC), textbook [fraction]

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "screen_companies"
  }
}

Input Schema

NameRequiredDescriptionDefault
limitNoMaximum number of companies returned, 1 to 25 (default 25).
orderNo"desc" puts the highest values first, "asc" the lowest.
sectorNoMFM sector ids, e.g. information-technology, health-care, industrials, financials
columnsNoExtra metric ids to show for each company, besides those used in filters and sort_by (at most 12 metrics in total).
countryNoISO 3166 alpha-2 codes, e.g. US, DE, JP
filtersNoUp to 10 conditions that must all hold. Each has a metric id and a lower bound (min), an upper bound (max) or both; ratios are fractions (0.15 = 15%). Example: [{"metric":"buffett_roic_tangible","min":0.12},{"metric":"debt_to_equity","max":0.8}].
sort_byNoMetric id used to order the result (same ids as filters); default tangible_roic_minus_buffett_wacc.
industryNoMFM industry ids, e.g. semiconductor, drugs-pharmaceutical
name_queryNoWords that the company name must contain, e.g. "bank".
verification_levelNoKeep only companies of these MFM audit levels (1, 2, 3). Levels describe audit programme membership, not completeness.
developed_markets_onlyNotrue keeps only companies of the developed markets covered by MFM (as listed on the Methodology page).

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed11 schema fields changed
    • addedInput schema / properties / columns / description
      Added value: +"Extra metric ids to show for each company, besides those used in filters and sort_by (at most 12 metrics in total)."
    • changedInput schema / properties / columns / items / enum
      Previous value: -[
      -  "anni_in_utile_5",
      -  "anni_oe_debito",
      -  "anni_oe_debito_imp",
      -  "anni_utile_debito",
      -  "anni_utile_debito_imp",
      -  "azioni_var3",
      -  "conversione_utili_cassa",
      -  "copertura_interessi",
      -  "croe_lordo",
      -  "croe_tangibile",
      -  "croic_lordo",
      -  "croic_lordo_imp",
      -  "croic_lordo_media5",
      -  "croic_tangibile",
      -  "croic_tangibile_imp",
      -  "debito_su_patrimonio",
      -  "debito_su_patrimonio_imp",
      -  "intensita_investimenti",
      -  "margine_fcf",
      -  "margine_netto",
      -  "oe_attivo",
      -  "oe_attivo_media5",
      -  "owner_earnings_cagr3",
      -  "ricavi_cagr3",
      -  "ricavi_cagr5",
      -  "roe_buffett_lordo",
      -  "roe_buffett_lordo_imp",
      -  "roe_buffett_tangibile",
      -  "roe_buffett_tangibile_imp",
      -  "roe_normale_lordo",
      -  "roe_normale_tangibile",
      -  "roi",
      -  "roic_lordo",
      -  "roic_lordo_imp",
      -  "roic_lordo_media5",
      -  "roic_lordo_meno_wacc",
      -  "roic_lordo_meno_wacc_imp",
      -  "roic_lordo_min5",
      -  "roic_manuali",
      -  "roic_meno_wacc_manuali",
      -  "roic_tangibile",
      -  "roic_tangibile_imp",
      -  "roic_tangibile_imp_media5",
      -  "roic_tangibile_meno_wacc",
      -  "roic_tangibile_meno_wacc_imp",
      -  "roic_tangibile_meno_wacc_rett",
      -  "roic_tangibile_meno_wacc_sp",
      -  "roic_tangibile_meno_wacc_sp_imp",
      -  "utile_operativo_cagr3",
      -  "utile_operativo_cagr5",
      -  "utili_proprietario_su_attivo",
      -  "variazione_derivati_3a",
      -  "wacc_buffett",
      -  "wacc_buffett_imp",
      -  "wacc_buffett_rett",
      -  "wacc_buffett_sp",
      -  "wacc_buffett_sp_imp",
      -  "wacc_manuali"
      -]New value: +[
      +  "years_in_profit_5",
      +  "years_owner_earnings_to_debt",
      +  "years_owner_earnings_to_debt_with_commitments",
      +  "years_earnings_to_debt",
      +  "years_earnings_to_debt_with_commitments",
      +  "shares_change_3y",
      +  "cash_conversion",
      +  "interest_coverage",
      +  "croe_gross",
      +  "croe_tangible",
      +  "croic_gross",
      +  "croic_gross_with_commitments",
      +  "croic_gross_avg_5y",
      +  "croic_tangible",
      +  "croic_tangible_with_commitments",
      +  "debt_to_equity",
      +  "debt_to_equity_with_commitments",
      +  "capital_intensity",
      +  "fcf_margin",
      +  "net_margin",
      +  "owner_earnings_to_assets",
      +  "owner_earnings_to_assets_avg_5y",
      +  "owner_earnings_cagr_3y",
      +  "revenue_cagr_3y",
      +  "revenue_cagr_5y",
      +  "buffett_roe_gross",
      +  "buffett_roe_gross_with_commitments",
      +  "buffett_roe_tangible",
      +  "buffett_roe_tangible_with_commitments",
      +  "roe_gross",
      +  "roe_tangible",
      +  "roi",
      +  "buffett_roic_gross",
      +  "buffett_roic_gross_with_commitments",
      +  "buffett_roic_gross_avg_5y",
      +  "gross_roic_minus_buffett_wacc",
      +  "gross_roic_minus_buffett_wacc_with_commitments",
      +  "buffett_roic_gross_min_5y",
      +  "textbook_roic",
      +  "textbook_roic_minus_wacc",
      +  "buffett_roic_tangible",
      +  "buffett_roic_tangible_with_commitments",
      +  "buffett_roic_tangible_with_commitments_avg_5y",
      +  "tangible_roic_minus_buffett_wacc",
      +  "tangible_roic_minus_buffett_wacc_with_commitments",
      +  "tangible_roic_minus_buffett_wacc_adjusted",
      +  "tangible_roic_minus_wacc_no_premium",
      +  "tangible_roic_minus_wacc_no_premium_with_commitments",
      +  "operating_income_cagr_3y",
      +  "operating_income_cagr_5y",
      +  "owner_earnings_over_assets",
      +  "derivatives_change_3y",
      +  "buffett_wacc",
      +  "buffett_wacc_with_commitments",
      +  "buffett_wacc_adjusted",
      +  "buffett_wacc_no_premium",
      +  "buffett_wacc_no_premium_with_commitments",
      +  "textbook_wacc"
      +]
    • addedInput schema / properties / developed_markets_only / description
      Added value: +"true keeps only companies of the developed markets covered by MFM (as listed on the Methodology page)."
    • addedInput schema / properties / filters / description
      Added value: +"Up to 10 conditions that must all hold. Each has a metric id and a lower bound (min), an upper bound (max) or both; ratios are fractions (0.15 = 15%). Example: [{\"metric\":\"buffett_roic_tangible\",\"min\":0.12},{\"metric\":\"debt_to_equity\",\"max\":0.8}]."
    • changedInput schema / properties / filters / items / properties / metric / enum
      Previous value: -[
      -  "anni_in_utile_5",
      -  "anni_oe_debito",
      -  "anni_oe_debito_imp",
      -  "anni_utile_debito",
      -  "anni_utile_debito_imp",
      -  "azioni_var3",
      -  "conversione_utili_cassa",
      -  "copertura_interessi",
      -  "croe_lordo",
      -  "croe_tangibile",
      -  "croic_lordo",
      -  "croic_lordo_imp",
      -  "croic_lordo_media5",
      -  "croic_tangibile",
      -  "croic_tangibile_imp",
      -  "debito_su_patrimonio",
      -  "debito_su_patrimonio_imp",
      -  "intensita_investimenti",
      -  "margine_fcf",
      -  "margine_netto",
      -  "oe_attivo",
      -  "oe_attivo_media5",
      -  "owner_earnings_cagr3",
      -  "ricavi_cagr3",
      -  "ricavi_cagr5",
      -  "roe_buffett_lordo",
      -  "roe_buffett_lordo_imp",
      -  "roe_buffett_tangibile",
      -  "roe_buffett_tangibile_imp",
      -  "roe_normale_lordo",
      -  "roe_normale_tangibile",
      -  "roi",
      -  "roic_lordo",
      -  "roic_lordo_imp",
      -  "roic_lordo_media5",
      -  "roic_lordo_meno_wacc",
      -  "roic_lordo_meno_wacc_imp",
      -  "roic_lordo_min5",
      -  "roic_manuali",
      -  "roic_meno_wacc_manuali",
      -  "roic_tangibile",
      -  "roic_tangibile_imp",
      -  "roic_tangibile_imp_media5",
      -  "roic_tangibile_meno_wacc",
      -  "roic_tangibile_meno_wacc_imp",
      -  "roic_tangibile_meno_wacc_rett",
      -  "roic_tangibile_meno_wacc_sp",
      -  "roic_tangibile_meno_wacc_sp_imp",
      -  "utile_operativo_cagr3",
      -  "utile_operativo_cagr5",
      -  "utili_proprietario_su_attivo",
      -  "variazione_derivati_3a",
      -  "wacc_buffett",
      -  "wacc_buffett_imp",
      -  "wacc_buffett_rett",
      -  "wacc_buffett_sp",
      -  "wacc_buffett_sp_imp",
      -  "wacc_manuali"
      -]New value: +[
      +  "years_in_profit_5",
      +  "years_owner_earnings_to_debt",
      +  "years_owner_earnings_to_debt_with_commitments",
      +  "years_earnings_to_debt",
      +  "years_earnings_to_debt_with_commitments",
      +  "shares_change_3y",
      +  "cash_conversion",
      +  "interest_coverage",
      +  "croe_gross",
      +  "croe_tangible",
      +  "croic_gross",
      +  "croic_gross_with_commitments",
      +  "croic_gross_avg_5y",
      +  "croic_tangible",
      +  "croic_tangible_with_commitments",
      +  "debt_to_equity",
      +  "debt_to_equity_with_commitments",
      +  "capital_intensity",
      +  "fcf_margin",
      +  "net_margin",
      +  "owner_earnings_to_assets",
      +  "owner_earnings_to_assets_avg_5y",
      +  "owner_earnings_cagr_3y",
      +  "revenue_cagr_3y",
      +  "revenue_cagr_5y",
      +  "buffett_roe_gross",
      +  "buffett_roe_gross_with_commitments",
      +  "buffett_roe_tangible",
      +  "buffett_roe_tangible_with_commitments",
      +  "roe_gross",
      +  "roe_tangible",
      +  "roi",
      +  "buffett_roic_gross",
      +  "buffett_roic_gross_with_commitments",
      +  "buffett_roic_gross_avg_5y",
      +  "gross_roic_minus_buffett_wacc",
      +  "gross_roic_minus_buffett_wacc_with_commitments",
      +  "buffett_roic_gross_min_5y",
      +  "textbook_roic",
      +  "textbook_roic_minus_wacc",
      +  "buffett_roic_tangible",
      +  "buffett_roic_tangible_with_commitments",
      +  "buffett_roic_tangible_with_commitments_avg_5y",
      +  "tangible_roic_minus_buffett_wacc",
      +  "tangible_roic_minus_buffett_wacc_with_commitments",
      +  "tangible_roic_minus_buffett_wacc_adjusted",
      +  "tangible_roic_minus_wacc_no_premium",
      +  "tangible_roic_minus_wacc_no_premium_with_commitments",
      +  "operating_income_cagr_3y",
      +  "operating_income_cagr_5y",
      +  "owner_earnings_over_assets",
      +  "derivatives_change_3y",
      +  "buffett_wacc",
      +  "buffett_wacc_with_commitments",
      +  "buffett_wacc_adjusted",
      +  "buffett_wacc_no_premium",
      +  "buffett_wacc_no_premium_with_commitments",
      +  "textbook_wacc"
      +]
    • addedInput schema / properties / limit / description
      Added value: +"Maximum number of companies returned, 1 to 25 (default 25)."
    • addedInput schema / properties / name_query / description
      Added value: +"Words that the company name must contain, e.g. \"bank\"."
    • addedInput schema / properties / order / description
      Added value: +"\"desc\" puts the highest values first, \"asc\" the lowest."
    • addedInput schema / properties / sort_by / description
      Added value: +"Metric id used to order the result (same ids as filters); default tangible_roic_minus_buffett_wacc."
    • changedInput schema / properties / sort_by / enum
      Previous value: -[
      -  "anni_in_utile_5",
      -  "anni_oe_debito",
      -  "anni_oe_debito_imp",
      -  "anni_utile_debito",
      -  "anni_utile_debito_imp",
      -  "azioni_var3",
      -  "conversione_utili_cassa",
      -  "copertura_interessi",
      -  "croe_lordo",
      -  "croe_tangibile",
      -  "croic_lordo",
      -  "croic_lordo_imp",
      -  "croic_lordo_media5",
      -  "croic_tangibile",
      -  "croic_tangibile_imp",
      -  "debito_su_patrimonio",
      -  "debito_su_patrimonio_imp",
      -  "intensita_investimenti",
      -  "margine_fcf",
      -  "margine_netto",
      -  "oe_attivo",
      -  "oe_attivo_media5",
      -  "owner_earnings_cagr3",
      -  "ricavi_cagr3",
      -  "ricavi_cagr5",
      -  "roe_buffett_lordo",
      -  "roe_buffett_lordo_imp",
      -  "roe_buffett_tangibile",
      -  "roe_buffett_tangibile_imp",
      -  "roe_normale_lordo",
      -  "roe_normale_tangibile",
      -  "roi",
      -  "roic_lordo",
      -  "roic_lordo_imp",
      -  "roic_lordo_media5",
      -  "roic_lordo_meno_wacc",
      -  "roic_lordo_meno_wacc_imp",
      -  "roic_lordo_min5",
      -  "roic_manuali",
      -  "roic_meno_wacc_manuali",
      -  "roic_tangibile",
      -  "roic_tangibile_imp",
      -  "roic_tangibile_imp_media5",
      -  "roic_tangibile_meno_wacc",
      -  "roic_tangibile_meno_wacc_imp",
      -  "roic_tangibile_meno_wacc_rett",
      -  "roic_tangibile_meno_wacc_sp",
      -  "roic_tangibile_meno_wacc_sp_imp",
      -  "utile_operativo_cagr3",
      -  "utile_operativo_cagr5",
      -  "utili_proprietario_su_attivo",
      -  "variazione_derivati_3a",
      -  "wacc_buffett",
      -  "wacc_buffett_imp",
      -  "wacc_buffett_rett",
      -  "wacc_buffett_sp",
      -  "wacc_buffett_sp_imp",
      -  "wacc_manuali"
      -]New value: +[
      +  "years_in_profit_5",
      +  "years_owner_earnings_to_debt",
      +  "years_owner_earnings_to_debt_with_commitments",
      +  "years_earnings_to_debt",
      +  "years_earnings_to_debt_with_commitments",
      +  "shares_change_3y",
      +  "cash_conversion",
      +  "interest_coverage",
      +  "croe_gross",
      +  "croe_tangible",
      +  "croic_gross",
      +  "croic_gross_with_commitments",
      +  "croic_gross_avg_5y",
      +  "croic_tangible",
      +  "croic_tangible_with_commitments",
      +  "debt_to_equity",
      +  "debt_to_equity_with_commitments",
      +  "capital_intensity",
      +  "fcf_margin",
      +  "net_margin",
      +  "owner_earnings_to_assets",
      +  "owner_earnings_to_assets_avg_5y",
      +  "owner_earnings_cagr_3y",
      +  "revenue_cagr_3y",
      +  "revenue_cagr_5y",
      +  "buffett_roe_gross",
      +  "buffett_roe_gross_with_commitments",
      +  "buffett_roe_tangible",
      +  "buffett_roe_tangible_with_commitments",
      +  "roe_gross",
      +  "roe_tangible",
      +  "roi",
      +  "buffett_roic_gross",
      +  "buffett_roic_gross_with_commitments",
      +  "buffett_roic_gross_avg_5y",
      +  "gross_roic_minus_buffett_wacc",
      +  "gross_roic_minus_buffett_wacc_with_commitments",
      +  "buffett_roic_gross_min_5y",
      +  "textbook_roic",
      +  "textbook_roic_minus_wacc",
      +  "buffett_roic_tangible",
      +  "buffett_roic_tangible_with_commitments",
      +  "buffett_roic_tangible_with_commitments_avg_5y",
      +  "tangible_roic_minus_buffett_wacc",
      +  "tangible_roic_minus_buffett_wacc_with_commitments",
      +  "tangible_roic_minus_buffett_wacc_adjusted",
      +  "tangible_roic_minus_wacc_no_premium",
      +  "tangible_roic_minus_wacc_no_premium_with_commitments",
      +  "operating_income_cagr_3y",
      +  "operating_income_cagr_5y",
      +  "owner_earnings_over_assets",
      +  "derivatives_change_3y",
      +  "buffett_wacc",
      +  "buffett_wacc_with_commitments",
      +  "buffett_wacc_adjusted",
      +  "buffett_wacc_no_premium",
      +  "buffett_wacc_no_premium_with_commitments",
      +  "textbook_wacc"
      +]
    • addedInput schema / properties / verification_level / description
      Added value: +"Keep only companies of these MFM audit levels (1, 2, 3). Levels describe audit programme membership, not completeness."
  2. Changed1 schema field changed
    • changedInput schema / properties / limit / maximum
      Previous value: -10New value: +25
  3. First observed

TDQS

A4.3/5.0
Behavior5/5

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

Annotations already cover readOnly/idempotent/safe, and the description adds substantial behavior beyond them: missing values never pass a filter or sort, result ordering is user-chosen and is not a recommendation or rating, quota is 100 distinct companies per calendar month shared with the website, and period_end may not be a fiscal year end. It also disclaims completeness ('it never returns complete company pages and does not consume the complete-page quota').

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The bulk is a single unbroken paragraph of ~5,000 characters mixing purpose, period semantics, quota rules, a misplaced BOND CALCULATOR snippet unrelated to this tool, and a sprawling metrics glossary. Many glossary entries are tautological or run to multiple sentences on edge cases (owner_earnings_to_assets, owner_earnings_to_assets_avg_5y) while others are three words, so the density is uneven and the key routing facts are buried mid-paragraph.

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 an 11-parameter selection tool with no output schema, it covers what comes back (requested summary parameters, audit level, link, exact fetch_id, period_end), result caps, ordering, and quota limits. Remaining gaps are minor but real: how to discover valid sector/industry/country ids beyond the two or three examples, and what happens when a filter metric is missing for most companies.

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, but the description supplies definitions for the ~57 metric ids that the schema only lists as bare enum strings — real added meaning for filters, sort_by and columns. It also reinforces that [fraction] ratios are decimals in both filters and results, and that columns adds metrics beyond those in filters/sort_by. The gain is partial because several glossary entries are tautological ('roi: ROI [fraction]', 'cash_conversion: Cash conversion') and no guidance is given on which of the near-duplicate variants (gross/tangible/with_commitments) an agent should prefer.

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?

Opens with a precise verb+resource+scope: filter and sort all ~10,700 MFM company profiles by user-chosen parameters, using latest twelve months of each profile. It explicitly contrasts itself with complete company pages ('never returns complete company pages'), which distinguishes it from the fetch sibling.

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

Usage Guidelines4/5

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

Gives concrete operational guidance: at most 25 results, when quota is consumed versus free (re-running a filter, companies already shown this month), and that complete pages must be read afterwards with fetch. However, it never names the 'search' sibling or explains when name_query here is preferable to searching, and the embedded BOND CALCULATOR paragraph gestures at another tool without stating whether to call it instead.

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