Get financial metrics/ratios for NZX companies. 46 ratios: profitability (incl. comprehensive_roe, oci_divergence), leverage (incl. paid_in_capital_ratio), cash flow, dividends, growth (incl. share_capital_growth), valuation, composite. Use for screening or comparison.
AI agents call get_metrics to retrieve information from NZXplorer MCP Server without modifying anything — typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.
| Parameter | Type | Required | Description |
|---|---|---|---|
mode | string | — | For single ticker: "snapshot" (default) or "historical" |
sort | string | — | Sort by metric (e.g. "pe_ratio", "roe", "dividend_yield") |
year | string | — | Year or range filter |
limit | number | — | Max results |
order | string | — | "asc" or "desc" |
sector | string | — | Filter by sector (list mode only) |
ticker | string | — | Specific ticker for detailed metrics with live valuation. Omit for list of all companies. |
Parameters from the server's own tool schema.
This tool retrieves and queries existing financial data (46 ratios across multiple categories) from NZX-listed companies without any capability to modify, delete, execute code, or trigger financial transactions. It is purely a data retrieval and analysis tool, making it a Read category risk with low severity. No side effects or state changes are possible.
From the tool's definition Tool description states 'Get financial metrics/ratios for NZX companies' and explicitly lists use cases as 'screening or comparison'. The verb 'Get' and absence of any modification, deletion, or execution language indicate a read-only retrieval operation.
Attacks that exploit this kind of access
Get financial metrics/ratios for NZX companies. 46 ratios: profitability (incl. comprehensive_roe, oci_divergence), leverage (incl. paid_in_capital_ratio), cash flow, dividends, growth (incl. share_capital_growth), valuation, composite. Use for screening or comparison. It is categorised as a Read tool in the NZXplorer MCP Server MCP Server, which means it retrieves data without modifying state.
get_metrics accepts 7 parameters: mode, sort, year, limit, order, sector, ticker. The full parameter table on this page comes from the server's own tool schema.
Register the NZXplorer MCP Server MCP server in PolicyLayer and add a rule for get_metrics: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches NZXplorer MCP Server. Nothing to install.
get_metrics is a Read tool with low risk. Read-only tools are generally safe to allow by default.
Yes. Add a rate_limit block to the get_metrics rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for get_metrics. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
get_metrics is provided by the NZXplorer MCP Server MCP server (mambaventures/nzxplorer-mcp-server). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
Every MCP server has a record like this.
Type a name, get the same breakdown: verified identity, auth posture, risk grade, capabilities, recommended policy.
Teams ship this data inside their own products. See what a licence covers →