io.github.mambaventures/nzxplorer-mcp

Official29 tools

by mambaventures · JavaScript

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

Access NZX stock data including governance, financials, and insider trading info.

Captured live from the server via tools/list.

search_companies

Search NZX-listed companies by name or ticker. Returns company list with sector, market cap. Use this to find a company ticker before calling other tools.

Parameters (3)

searchstring
Company name or ticker to search for (e.g. "air new zealand" or "AIR")
sectorstring
Filter by sector (e.g. "Energy", "Healthcare")
limitnumber
Max results (default 10)

get_company_detail

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

Parameters (2)

tickerstringrequired
NZX ticker symbol (e.g. "AIR", "FPH", "MEL")
includestring
Comma-separated includes: directors, financials, governance, price, all (e.g. "governance,price")

get_governance_scores

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 (7)

sectorstring
Filter by sector
min_scorenumber
Minimum GRS score (0-100)
max_scorenumber
Maximum GRS score (0-100)
ratingstring
Filter by rating: Excellent, Very Good, Good, Adequate, Poor, Very Poor
sortstring
Sort field (e.g. "total_score")
orderstring
"asc" or "desc"
limitnumber
Max results (default 50)

get_financials

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 (4)

tickerstringrequired
NZX ticker symbol
statementstring
Statement type: income, balance, cashflow, ratios, or comma-separated (default: all)
yearstring
Year or range (e.g. "2024" or "2020-2024")
limitnumber
Max results per statement type

get_metrics

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 (7)

tickerstring
Specific ticker for detailed metrics with live valuation. Omit for list of all companies.
sectorstring
Filter by sector (list mode only)
sortstring
Sort by metric (e.g. "pe_ratio", "roe", "dividend_yield")
orderstring
"asc" or "desc"
modestring
For single ticker: "snapshot" (default) or "historical"
yearstring
Year or range filter
limitnumber
Max results

get_insider_trades

Get director share transactions (insider trades) for NZX companies. Shows who is buying/selling, amounts, and dates.

Parameters (4)

tickerstring
Filter by company ticker
typestring
Transaction type: buy, sell, or all
daysnumber
Recent trades within N days
limitnumber
Max results (default 50)

get_dividends

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 (4)

tickerstringrequired
NZX ticker symbol
yearstring
Year or range (e.g. "2024" or "2020-2024")
typestring
Dividend type: final, interim, special
limitnumber
Max results

get_earnings

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 (4)

tickerstringrequired
NZX ticker symbol
yearstring
Year or range
periodstring
Period: annual, interim, or all
limitnumber
Max results

get_board_changes

Get director appointment, resignation, and retirement events for an NZX company. Shows board composition changes over time with dates and reasons.

Parameters (5)

tickerstringrequired
NZX ticker symbol (e.g., FPH, AIR)
actionstring
Filter by action type: appointed, resigned, retired, removed, elected, re-elected
fromstring
Start date YYYY-MM-DD
tostring
End date YYYY-MM-DD
limitnumber
Max results (default 50)

get_stock_prices

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

Parameters (4)

tickerstringrequired
NZX ticker symbol
daysnumber
Number of recent trading days (default 30)
fromstring
Start date (YYYY-MM-DD)
tostring
End date (YYYY-MM-DD)

search_announcements

Full-text search across 64,000+ NZX market announcements (2017-present), including 62,500+ 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 (6)

qstring
Search query — searches both titles and full PDF document text
tickerstring
Filter by company ticker
typestring
Announcement type: FLLYR, HALFYR, SHINTR, MEETING, GENERAL, SECISSUE, DVDEND, etc.
fromstring
Start date (YYYY-MM-DD)
tostring
End date (YYYY-MM-DD)
limitnumber
Max results (default 20)

read_announcement

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

Parameters (1)

announcement_idstringrequired
The announcement_id from search_announcements results

get_directors

Search NZX company directors. Returns name, bio, board seats. Filter by company or search by name.

Parameters (4)

companystring
Filter by company ticker
searchstring
Search director name
currentboolean
Only current directors (default true)
limitnumber
Max results

get_director_detail

Get detailed profile for a specific director by slug. Includes biography, board seats, compensation, share trades.

Parameters (2)

slugstringrequired
Director slug (e.g. "dame-therese-walsh")
includestring
Comma-separated: trades, remuneration, exec_comp

get_shareholders

Get top 20 shareholders and substantial holders (5%+) for an NZX company. 9,284 top-20 records across 120 issuers with multi-year history (2010-2026) plus ~267 substantial holders from NZX disclosure notices. Shows ownership concentration (HHI index), holder types (nominee/company/individual/trust/fund), year-over-year ownership changes, and substantial holders with voting rights percentages. Use ?year=2025 or ?all=true for historical data.

Parameters (2)

tickerstringrequired
NZX ticker symbol
yearstring
Filter top 20 by fiscal year

get_substantial_holders

Get substantial shareholders (5%+ voting rights) for an NZX company from NZX disclosure notices. ~267 records across ~85 issuers. Shows entity name, entity type (individual/company/trust/fund), voting rights percentage, shares held, whether they are also a director/executive, disclosure dates, and threshold crossing history. Use for block holder analysis, activist investor tracking, M&A signal detection (accumulation patterns), and ownership concentration analysis. Complements get_shareholders (top-20 annual report data) with legally mandated real-time disclosures.

Parameters (2)

tickerstringrequired
NZX ticker symbol
include_ceasedstring
Set to "true" to include former substantial holders who dropped below 5%

get_agm_resolutions

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 (2)

tickerstringrequired
NZX ticker symbol
yearstring
Filter by meeting year

get_esg_data

Get ESG (Environmental, Social, Governance) data for an NZX company. 255 emissions records, 760 diversity records, 270 safety records across NZX issuers. 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 (2)

tickerstringrequired
NZX ticker symbol
yearstring
Filter by fiscal year

get_kiwisaver_holdings

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 (2)

tickerstringrequired
NZX ticker symbol
datestring
Specific quarter date (e.g. "2022-09-30")

get_performance

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 (1)

tickerstringrequired
NZX ticker symbol

get_technical_signals

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 (1)

tickerstringrequired
NZX ticker symbol (e.g. "AIR", "FPH", "MEL")

get_credit_ratings

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 (5)

tickerstringrequired
NZX ticker symbol (e.g. "ANZ", "MEL", "SPK")
yearstring
Year or range (e.g. "2024" or "2020-2024")
agencystring
Filter by agency: "S&P", "Moody's", "Fitch", "AM Best"
actionstring
Filter by action: affirmed, upgraded, downgraded, assigned, withdrawn
limitnumber
Max results

get_management_team

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. 127 issuers covered, 508 current executives across 15 normalized roles. Filter by role (e.g. CEO, CFO). Includes profile data where linked to shared.people.

Parameters (2)

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

get_capital_raises

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

Parameters (5)

tickerstringrequired
NZX ticker symbol (e.g. "AIR", "FBU", "RYM")
yearstring
Year or range (e.g. "2024" or "2020-2024")
typestring
Comma-separated raise types: placement, rights_issue, spp, ipo, bond, buyback, drp, options_exercise, employee_scheme, conversion
buybacksstring
Set to "true" to only show buybacks
limitnumber
Max results

get_revenue_segments

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 (4)

tickerstringrequired
NZX ticker symbol (e.g. "FPH", "SKC", "AIR", "FBU")
yearstring
Year or range (e.g. "2025" or "2020-2025")
typestring
Segment type filter: operating, geographic, product
limitnumber
Max results (default 50)

get_takeovers

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 (5)

tickerstringrequired
NZX ticker symbol (e.g. "RBD", "RAK", "MCK")
statusstring
Comma-separated: announced, conditional, unconditional, completed, withdrawn, failed
deal_typestring
Comma-separated: takeover_offer, merger, scheme_of_arrangement, compulsory_acquisition, acquisition
yearstring
Year or range (e.g. "2025" or "2020-2025")
limitnumber
Max results (default 50)

get_market_signals

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 (6)

tickerstring
Filter by company ticker (e.g. "AIR", "MEL")
typestring
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
daysnumber
Number of days to look back (default 180, use 7 for "this week", 1 for "today")
significancestring
Filter by significance: high, medium, low
sectorstring
Filter by sector (e.g. "Energy", "Healthcare")
limitnumber
Max results (default 50)

get_annual_reports

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 (3)

tickerstringrequired
NZX ticker symbol (e.g. "AIR", "FPH")
yearstring
Fiscal year or range (e.g. "2024" or "2020-2024")
typestring
Filter: "annual" or "interim"

get_daily_market_wrap

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 (1)

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

Install

Configuration

Environment variables

NZXPLORER_API_KEYrequiredsecret

NZXplorer API key — free at https://nzxplorer.co.nz/developers. Unlocks the full 55-tool set; the remote URL above needs no key for 30 read-only tools.

claude_desktop_config.json

{
  "mcpServers": {
    "nzxplorer-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "nzxplorer-mcp@1.36.0"
      ],
      "env": {
        "NZXPLORER_API_KEY": "<YOUR_NZXPLORER_API_KEY>"
      }
    }
  }
}