Skip to main content
Glama

Zyberno stock valuation

by com.zyberno
OverviewDiscussionsAdmin

Find US-listed companies by valuation and quality criteria

screen_stocks
Read-onlyIdempotent

Searches Zyberno's database of roughly 10,000 US-listed companies and returns those matching the numeric criteria you supply, ranked by a field you choose. All metrics are computed from SEC filings.

Use when the user wants to find, filter, rank, or count companies by their characteristics rather than asking about one company by name. Omit any filter you do not want applied; omitting all of them ranks the whole covered universe. Do not use it for a single known ticker (use get_stock_valuation), and do not use it to reconstruct the published monthly lists, which apply their own fixed thresholds, sector exclusions and curation (use list_flagged_stocks).

Returns at most 25 companies plus the total number that matched, so a query that is too broad or too narrow reports its own breadth.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
limitNoHow many companies to return, 1 to 25. Defaults to 10. The total number that matched is reported regardless.
sectorNoRestrict to one sector, spelled as Zyberno stores it, for example Technology, Healthcare, Industrials, Energy, Consumer Cyclical, Financial Services, Real Estate, Utilities, Basic Materials, Communication Services, Consumer Defensive.
roe_minNoMinimum return on equity in percent.
sort_byNoField to rank the matches by, largest first. Defaults to market_cap.
exchangeNoRestrict to one listing venue.
roic_minNoMinimum return on invested capital in percent. Pass 15 for 15 percent.
eps_sue_maxNoMaximum standardised earnings surprise (SUE), range -4 to +4.
eps_sue_minNoMinimum standardised earnings surprise (SUE), a winsorized z-score bounded to the range -4 to +4. Positive means the latest reported earnings beat the trend-based expectation. Pass 1 for a one standard deviation beat.
pb_ratio_maxNoMaximum price to book ratio.
pe_ratio_maxNoMaximum trailing price to earnings ratio. Companies with no meaningful P/E, including loss makers, are excluded when this is set.
brina_gap_maxNoMaximum Brina Gap in percentage points. Use a negative value to isolate companies whose price implies more growth than fundamentals support.
brina_gap_minNoMinimum Brina Gap in percentage points. Positive means the growth the business can fund exceeds the growth its price implies; negative means the price implies faster growth than the fundamentals support. Pass 3 for 3 percentage points.
fcf_yield_minNoMinimum free cash flow yield in percent. Pass 5 for 5 percent.
peg_ratio_maxNoMaximum PEG ratio, price to earnings divided by growth.
market_cap_maxNoMaximum market capitalisation in US dollars.
market_cap_minNoMinimum market capitalisation in US dollars, for example 2000000000 for 2 billion.
eps_cagr_3yr_minNoMinimum 3 year diluted EPS compound annual growth rate in percent.
current_ratio_minNoMinimum current ratio. Pass 1.5 for 1.5x.
momentum_12_1_maxNoMaximum 12 minus 1 price momentum in percent. Pass a negative value to isolate fallers.
momentum_12_1_minNoMinimum 12 minus 1 price momentum in percent: total return including dividends over the last 12 months, skipping the most recent month. Pass 20 for 20 percent, or -30 for a 30 percent fall. Values are unbounded above, and the strongest names in the universe can read in the hundreds of percent. Companies listed under 13 months have no window and are excluded whenever any momentum filter is set.
zyberno_score_minNoMinimum Zyberno business-quality score, 0 to 100, from 13 weighted measures of profitability, cash-flow quality, stability and growth. 70 is the cut-off the Zyberno Strategy uses.
debt_to_equity_maxNoMaximum debt to equity ratio, as a ratio not a percent. Pass 1.5 for 1.5x.
earnings_yield_minNoMinimum earnings yield in percent, the inverse of P/E. Pass 8 for 8 percent.
net_margin_ttm_minNoMinimum trailing twelve month net margin in percent.
ev_ebitda_ratio_maxNoMaximum enterprise value to EBITDA ratio.
market_cap_categoryNoRestrict by size band, as an alternative to explicit market cap bounds. Bands are micro under $300M, small $300M to $2B, mid $2B to $10B, large $10B to $200B, mega $200B and above. Note that large excludes mega, so for the very largest companies use mega, and to cover both give market_cap_min instead.
gross_margin_ttm_minNoMinimum trailing twelve month gross margin in percent.
margin_of_safety_maxNoMaximum Margin of Safety in percentage points. Pass 10 for 10 percent.
margin_of_safety_minNoMinimum Margin of Safety in percentage points, where positive means the price sits below the discounted cash flow estimate. Pass 10 for 10 percent, not 0.1. Negative values are allowed.
revenue_cagr_3yr_minNoMinimum 3 year revenue compound annual growth rate in percent.
momentum_12_1_pct_maxNoMaximum cross-sectional momentum percentile, 0 to 100.
momentum_12_1_pct_minNoMinimum cross-sectional momentum percentile, 0 to 100, where 100 is the strongest momentum in the covered universe. Prefer this over the raw percentage when the user asks for strong or weak momentum in relative terms. Percentiles refresh on a monthly recompute, so they can lag the raw figure.
price_to_52w_high_maxNoMaximum ratio of current price to the 52 week high. Pass 0.7 to find stocks at least 30 percent below their high.
price_to_52w_high_minNoMinimum ratio of current price to the 52 week high, where 1.0 means the stock is sitting at its high. Pass 0.95 for within 5 percent of the high.
revenue_yoy_growth_minNoMinimum year over year revenue growth in percent.
operating_margin_ttm_minNoMinimum trailing twelve month operating margin in percent.
owner_earnings_yield_minNoMinimum owner earnings yield in percent. Owner earnings is the cash figure the discounted cash flow behind Margin of Safety is built on.
fundamental_growth_rate_maxNoMaximum fundamentally fundable growth rate in percent.
fundamental_growth_rate_minNoMinimum fundamentally fundable growth rate in percent, defined as ROIC times reinvestment rate. This is the first half of the Brina Gap on its own.
interest_coverage_ratio_minNoMinimum interest coverage ratio, operating income over interest expense.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / zyberno_score_min / description
      Previous value: -"Minimum Zyberno quality score, on a 0 to 100 scale combining profitability, balance sheet strength and earnings consistency."New value: +"Minimum Zyberno business-quality score, 0 to 100, from 13 weighted measures of profitability, cash-flow quality, stability and growth. 70 is the cut-off the Zyberno Strategy uses."
  2. Changed2 schema fields changed
    • changedInput schema / properties / momentum_12_1_max / description
      Previous value: -"Maximum 12 minus 1 price momentum in percent. Use to isolate laggards."New value: +"Maximum 12 minus 1 price momentum in percent. Pass a negative value to isolate fallers."
    • changedInput schema / properties / momentum_12_1_min / description
      Previous value: -"Minimum 12 minus 1 price momentum in percent: total return including dividends over the last 12 months, skipping the most recent month. Pass 20 for 20 percent. Companies listed under 13 months have no window and are excluded whenever any momentum filter is set."New value: +"Minimum 12 minus 1 price momentum in percent: total return including dividends over the last 12 months, skipping the most recent month. Pass 20 for 20 percent, or -30 for a 30 percent fall. Values are unbounded above, and the strongest names in the universe can read in the hundreds of percent. Companies listed under 13 months have no window and are excluded whenever any momentum filter is set."
  3. Added

TDQS

A4.3/5.0
Behavior4/5

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

Annotations already cover the safety profile (readOnly, idempotent, non-destructive, openWorld), but the description adds real behavioral context beyond them: results are capped at 25 with the total match count always reported, and all metrics derive from SEC filings. It does not mention auth requirements or rate limits, so it falls short of a 5.

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?

Three short paragraphs, front-loaded with purpose before guidance and the 25-row cap. Every clause carries information; only the final sentence about query breadth is mildly redundant with the cap statement, keeping it just short of a 5.

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 40-parameter tool with no output schema, the description covers universe size, the result cap and match count, filter-omission semantics, and sibling disambiguation. It does not sketch the shape of a returned company record, which is the main remaining gap given there is no output schema.

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% and the schema itself is unusually thorough (units, defaults, edge cases like loss-makers excluded by pe_ratio_max). The description only restates the ranking concept ('ranked by a field you choose'), adding nothing beyond the structured fields, 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 precise verb and resource ('Searches Zyberno's database of roughly 10,000 US-listed companies and returns those matching the numeric criteria you supply, ranked by a field you choose'). It also names the two siblings it must not be confused with (get_stock_valuation, list_flagged_stocks), so an agent can route without opening the schema.

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 explicit when-to-use ('find, filter, rank, or count companies by their characteristics rather than asking about one company by name') and explicit when-not-to-use with named alternatives for both exclusion cases. It also states the default behavior when all filters are omitted, leaving nothing to inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Zyberno stock valuation toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources