io.github.mambaventures/nzxplorer-mcp

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

NZX (New Zealand stock exchange) data: governance scores, financials, insider trades, boards

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "nzxplorer-mcp": {
      "url": "https://mcp.nzxplorer.co.nz",
      "transport": "streamable-http"
    }
  }
}

Measured tools (23)

• search_companies read-only

  Search NZX-listed companies by name or ticker. Returns company list with sector, market cap.

  Parameters:

  • limit — integer — Max results (default 10)
  • search — string — Company name or ticker to search for (e.g. "air new zealand" or "AIR")
  • sector — string — Filter by sector (e.g. "Energy", "Healthcare")

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_company_detail read-only

  Get detailed info for a specific NZX company by ticker. Can include directors, financials, governance score, and latest stock price.

  Parameters:

  • ticker (required) — string — NZX ticker symbol (e.g. "AIR", "FPH", "MEL")
  • include — string — Comma-separated includes: directors, financials, governance, price, all (e.g. "governance,price")

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_governance_scores read-only

  Get Governance Risk Scores (GRS) for NZX companies. 0-100 scale across 6 components: exec remuneration, board structure, shareholder rights, board effectiveness, audit & risk, remuneration disclosure. Can filter by sector, rating, or score range.

  Parameters:

  • sort — string — Sort field (e.g. "total_score")
  • limit — integer — Max results (default 50)
  • order — string — "asc" or "desc"
  • rating — string — Filter by rating: Excellent, Very Good, Good, Adequate, Poor, Very Poor
  • sector — string — Filter by sector
  • max_score — number — Maximum GRS score (0-100)
  • min_score — number — Minimum GRS score (0-100)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_financials read-only

  Get financial statements for an NZX company. Includes income statement, balance sheet, cash flow, and financial ratios. Filter by statement type and year range.

  Parameters:

  • ticker (required) — string — NZX ticker symbol
  • year — string — Year or range (e.g. "2024" or "2020-2024")
  • limit — integer — Max results per statement type
  • statement — string — Statement type: income, balance, cashflow, ratios, or comma-separated (default: all)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_metrics read-only

  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.

  Parameters:

  • 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 — integer — 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.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_dividends read-only

  Get dividend history for an NZX company. Includes ex-date, payment date, amount (DPS), imputation %, DRP availability, summary stats. Company pages also show Dividend Safety Score (0-100 with 5 components), Forward Dividend Cut Probability (0-100% with risk factors), and Payout Ratio Trend Charts with sector benchmarks.

  Parameters:

  • ticker (required) — string — NZX ticker symbol
  • type — string — Dividend type: final, interim, special
  • year — string — Year or range (e.g. "2024" or "2020-2024")
  • limit — integer — Max results

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_earnings read-only

  Get earnings results for an NZX company. Extracted from full-year and half-year announcements. Includes revenue, net profit, EBITDA, EPS, DPS, and management guidance.

  Parameters:

  • ticker (required) — string — NZX ticker symbol
  • year — string — Year or range
  • limit — integer — Max results
  • period — string — Period: annual, interim, or all

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_stock_prices read-only

  Get daily stock price history (OHLCV) for an NZX company. Use for price trends, returns, and technical context.

  Parameters:

  • ticker (required) — string — NZX ticker symbol
  • to — string — End date (YYYY-MM-DD)
  • days — integer — Number of recent trading days (default 30)
  • from — string — Start date (YYYY-MM-DD)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• search_announcements read-only

  Full-text search across NZX market announcements (2017-present), most with extracted PDF text. Searches announcement titles AND full document content. Use for finding mentions of specific topics, companies, people, or events across all NZX filings. Results include: ai_category (25-category AI classification like M&A, Dividend, Regulatory, Capital Raise, Guidance, Earnings Results), ai_category_confidence (0.0-1.0), ai_sub_topics (1-3 topic tags). May also include: ai_sentiment (positive/negative/neutral/mixed), ai_sentiment_score (-1.0 to 1.0), ai_topics (array of topic labels), ai_risk_flags (array of risk indicators like profit_warning, dividend_cut), and ai_summary (concise summary).

  Parameters:

  • q — string — Search query — searches both titles and full PDF document text
  • to — string — End date (YYYY-MM-DD)
  • from — string — Start date (YYYY-MM-DD)
  • type — string — Announcement type: FLLYR, HALFYR, SHINTR, MEETING, GENERAL, SECISSUE, DVDEND, etc.
  • limit — integer — Max results (default 20)
  • ticker — string — Filter by company ticker

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• read_announcement read-only

  Read and analyze a specific NZX announcement. Extracts summary, key figures, sentiment, entities, and risk flags using AI. Provide the announcement_id (e.g. Returns cached results if previously extracted.

  Parameters:

  • announcement_id (required) — string — The announcement_id from announcement search results

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_agm_resolutions read-only

  Get AGM resolution voting data for an NZX company. Shows resolutions, votes for/against/abstain, pass/fail status, support percentages. Use for governance and shareholder activism analysis.

  Parameters:

  • ticker (required) — string — NZX ticker symbol
  • year — string — Filter by meeting year

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_esg_data read-only

  Get ESG (Environmental, Social, Governance) data for an NZX company. Includes emissions (scope 1/2/3, targets, verification), diversity (board/SLT/employee gender, Māori/Pasifika representation), safety (LTIFR/TRIFR, fatalities, FTE), and reporting standards (GRI/TCFD/SBTi).

  Parameters:

  • ticker (required) — string — NZX ticker symbol
  • year — string — Filter by fiscal year

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_kiwisaver_holdings read-only

  Get KiwiSaver fund holdings in an NZX company. Shows which KiwiSaver funds hold shares, their market value, and percentage of fund. Data covers Dec 2018 - Sep 2022.

  Parameters:

  • ticker (required) — string — NZX ticker symbol
  • date — string — Specific quarter date (e.g. "2022-09-30")

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_performance read-only

  Get stock performance metrics for an NZX company. Returns (1d to 5y), alpha vs NZX50, volatility, 52-week range, market cap. Use for performance comparison and pay-for-performance analysis.

  Parameters:

  • ticker (required) — string — NZX ticker symbol

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_technical_signals read-only

  Get technical analysis indicators for an NZX company. SMA-50/100/200, RSI-14, golden/death cross, distance from 52-week high/low, volume ratios. Use for trading signals, momentum analysis, and technical screening.

  Parameters:

  • ticker (required) — string — NZX ticker symbol (e.g. "AIR", "FPH", "MEL")

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_credit_ratings read-only

  Get credit rating history for an NZX company. Shows S&P, Moody's, Fitch, AM Best ratings with upgrades, downgrades, and outlook changes. ~20 NZX companies have credit ratings.

  Parameters:

  • ticker (required) — string — NZX ticker symbol (e.g. "ANZ", "MEL", "SPK")
  • year — string — Year or range (e.g. "2024" or "2020-2024")
  • limit — integer — Max results
  • action — string — Filter by action: affirmed, upgraded, downgraded, assigned, withdrawn
  • agency — string — Filter by agency: "S&P", "Moody's", "Fitch", "AM Best"

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_management_team read-only

  Get the management team (C-suite executives) for an NZX company. Returns current CEO, CFO, COO, CTO, and other senior executives with their roles, tenure, biographies, education, and profile links. 15 normalized roles. Filter by role (e.g. CEO, CFO). Includes profile data where linked to shared.people.

  Parameters:

  • ticker (required) — string — NZX ticker symbol (e.g. "FPH", "AIR", "SPK")
  • role — string — Filter by normalized role: CEO, CFO, COO, CTO, CIO, CLO, CPO, CMO, CRO, CDO, CS, GM, VP, MD, Other

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_capital_raises read-only

  Get capital raise history for an NZX company. Includes placements, rights issues, SPPs, IPOs, bonds, buybacks, DRPs with amounts, pricing, and dilution. Structured events across NZX issuers.

  Parameters:

  • ticker (required) — string — NZX ticker symbol (e.g. "AIR", "FBU", "RYM")
  • type — string — Comma-separated raise types: placement, rights_issue, spp, ipo, bond, buyback, drp, options_exercise, employee_scheme, conversion
  • year — string — Year or range (e.g. "2024" or "2020-2024")
  • limit — integer — Max results
  • buybacks — string — Set to "true" to only show buybacks

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_revenue_segments read-only

  Get revenue segment breakdown for an NZX company. Returns operating, geographic, or product segment data including segment revenue, operating profit, and assets (all in NZD thousands). Use when asked about "revenue breakdown", "business segments", "divisions", "product groups", "geographic revenue", "segment analysis", or "what are the divisions of [company]".

  Parameters:

  • ticker (required) — string — NZX ticker symbol (e.g. "FPH", "SKC", "AIR", "FBU")
  • type — string — Segment type filter: operating, geographic, product
  • year — string — Year or range (e.g. "2025" or "2020-2025")
  • limit — integer — Max results (default 50)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_takeovers read-only

  Get M&A and takeover activity for an NZX company. Returns structured deal data: acquirer, target, offer price, total value, premium, acceptance %, status, timeline. Covers takeover offers, mergers, schemes of arrangement, compulsory acquisitions, and asset acquisitions. Use this when asked about "takeovers", "M&A", "acquisitions", "who is buying", "hostile bids", "scheme of arrangement", or deal activity for a company.

  Parameters:

  • ticker (required) — string — NZX ticker symbol (e.g. "RBD", "RAK", "MCK")
  • year — string — Year or range (e.g. "2025" or "2020-2025")
  • limit — integer — Max results (default 50)
  • status — string — Comma-separated: announced, conditional, unconditional, completed, withdrawn, failed
  • deal_type — string — Comma-separated: takeover_offer, merger, scheme_of_arrangement, compulsory_acquisition, acquisition

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_market_signals read-only

  Get the Market Intelligence Feed — a unified stream of all NZX market events. Returns 13 signal types: insider trades, capital raises, dividends, earnings releases, AGM results, director changes, governance score changes, technical signals (golden/death cross, RSI extremes), credit rating changes, auditor changes, takeover/M&A activity, board events, and composite signals (multi-signal patterns like insider selling + earnings miss, director exodus, governance deterioration). Use this when asked "what happened on the NZX today/this week?", "any recent insider trades?", "golden crosses?", "credit rating changes?", "composite signals?", "market activity for AIR", or any question about recent NZX events.

  Parameters:

  • days — integer — Number of days to look back (default 180, use 7 for "this week", 1 for "today")
  • type — string — Comma-separated signal types: insider_trade, capital_raise, dividend, earnings, agm_result, director_change, grs_change, technical_signal, credit_rating, audit_change, takeover, board_event, composite_signal
  • limit — integer — Max results (default 50)
  • sector — string — Filter by sector (e.g. "Energy", "Healthcare")
  • ticker — string — Filter by company ticker (e.g. "AIR", "MEL")
  • significance — string — Filter by significance: high, medium, low

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_annual_reports read-only

  Get annual and interim report URLs for an NZX company. Shows report URLs, financial year, extraction status. Use this when asked about a company's annual reports, filings, or report history.

  Parameters:

  • ticker (required) — string — NZX ticker symbol (e.g. "AIR", "FPH")
  • type — string — Filter: "annual" or "interim"
  • year — string — Fiscal year or range (e.g. "2024" or "2020-2024")

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_daily_market_wrap read-only

  Get the daily NZX market wrap — a market-wide digest covering all active NZX issuers. Returns price moves, market breadth (gainers/decliners/unchanged), announcements, insider trades, upcoming dividends, board changes, plus AI-generated video script and written narrative summary. Use when asked about overall market conditions, today's market, what happened on the NZX, or market summary.

  Parameters:

  • days — integer — Lookback days (1-7, default 7). Use 1 for last trading day, 7 for the week.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.