Skip to main content
Glama

Mastering Financial Markets

Search MFM public records

search
Read-onlyIdempotent

Search MFM public companies, pages and published datasets by keyword, company name or ticker. An empty result means no MFM record matched those words: say that MFM does not publish it under those words and never attribute figures from other sources to MFM. Results contain document identifiers and public URLs; private portfolios and accounts are excluded. SELECTION BY PARAMETERS (for clients that only expose search and fetch): start the query with "screen:" followed by conditions separated by spaces, e.g. "screen: buffett_roe_gross>0.15 buffett_roic_tangible>=12% debt_to_equity<0.8 country=US,DE level=1,2 sort=buffett_roic_tangible order=desc limit=10". Ratios are fractions (0.15 = 15%; "15%" is accepted); options: country=, sector=, industry=, level=1,2,3, developed=true, name=, sort=metric, order=asc|desc, limit=1-25 (default 25), columns=a,b. Each result is one company with the requested metrics in the title and text and the fetch id of its complete page. The order is the one chosen by the user: a data selection, never a recommendation. 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. PORTFOLIO CALCULATOR (same clients): start the query with "portfolio:" followed by settings and lines separated by ";", e.g. "portfolio: residence=IT; currency=EUR; tax=26%; S&P 500 30000/25000; Apple 5000/1000; US:MSFT 4000/3500 USD; MSCI World 20000/18000 hedged" (each line: security current_value/book_cost in the reference currency; company id, COUNTRY:TICKER, ISIN, company name, or the index an equity ETF tracks). One result with the whole calculator summary in its text, the same as the portfolio_calculator tool; nothing is stored. 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

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": {
      "query": "<query>"
    },
    "name": "search"
  }
}

Input Schema

NameRequiredDescriptionDefault
queryYesShort keywords, a company name or a ticker (e.g. "Apple" or "US:MSFT"). Clients that only expose search and fetch can start the query with "screen:" (selection by parameters) or "portfolio:" (portfolio calculator), with the syntax in the tool description; "quota" returns the remaining account allowances. "market: US" reads one whole market of the open data in one request; "plan: market=US; amount=100; from=2022-01; to=2026-08" runs the accumulation plan simulator (past data).

Output Schema

NameRequiredDescriptionDefault
resultsYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / query / description
      Previous value: -"Short keywords, a company name or a ticker (e.g. \"Apple\" or \"US:MSFT\"). Clients that only expose search and fetch can start the query with \"screen:\" (selection by parameters) or \"portfolio:\" (portfolio calculator), with the syntax in the tool description; \"quota\" returns the remaining account allowances."New value: +"Short keywords, a company name or a ticker (e.g. \"Apple\" or \"US:MSFT\"). Clients that only expose search and fetch can start the query with \"screen:\" (selection by parameters) or \"portfolio:\" (portfolio calculator), with the syntax in the tool description; \"quota\" returns the remaining account allowances. \"market: US\" reads one whole market of the open data in one request; \"plan: market=US; amount=100; from=2022-01; to=2026-08\" runs the accumulation plan simulator (past data)."
  2. Changed1 schema field changed
    • addedInput schema / properties / query / description
      Added value: +"Short keywords, a company name or a ticker (e.g. \"Apple\" or \"US:MSFT\"). Clients that only expose search and fetch can start the query with \"screen:\" (selection by parameters) or \"portfolio:\" (portfolio calculator), with the syntax in the tool description; \"quota\" returns the remaining account allowances."
  3. First observed

TDQS

A4/5.0
Behavior5/5

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

Annotations already declare read-only, idempotent, non-destructive and closed-world behavior, but the description adds substantial context beyond them: empty-result handling and a source-attribution warning, exclusion of private portfolios/accounts, monthly quota of 100 different companies with free re-runs, and the fact that portfolio mode stores nothing and bond mode consumes no quota. These are concrete behavioral constraints an agent would not get from annotations alone.

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 core search purpose is front-loaded, but the description is dominated by a long metric glossary and multiple calculator syntaxes, making it very large for a one-parameter tool. Many metric definitions, such as the multi-sentence owner_earnings_to_assets explanation, are not necessary for selecting or invoking search and would be better placed in a reference document.

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?

It covers search semantics, special query modes, quota behavior and result characteristics, and since an output schema exists it need not explain return values in detail. It is broadly complete for advanced use, though it leaves some routing context implicit by not explicitly directing full-toolset agents to the dedicated sibling tools for screening, portfolios or bonds.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

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

The single query parameter is heavily elaborated beyond the schema: the description documents screen: filter grammar, portfolio: syntax and examples, bond: examples, sort/order/limit/columns options, ratio formatting, and the metric keys accepted by the screen mode. With schema coverage at 100% the baseline would be 3, but this description adds significant operational meaning for the query string.

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 opens with a specific verb and resource: search MFM public companies, pages and published datasets by keyword, company name or ticker. It also clarifies that results contain document identifiers and fetch ids, which helps distinguish it from fetch, but it does not explicitly contrast search with siblings such as screen_companies or bond_calculator.

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?

It gives conditional guidance for clients that only expose search and fetch, explaining the screen:, portfolio: and bond: prefixes, and notes that portfolio output matches portfolio_calculator. However, it does not clearly tell an agent with the full toolset when to use search instead of screen_companies, bond_calculator, market_series or accumulation_plan, so the routing guidance is partial and tangled.

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