# io.github.mambaventures/nzxplorer-mcp (npm · nzxplorer-mcp)

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

- Trust score: 68/100 (medium)
- Change this week: −10
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `mcp.nzxplorer.co.nz`: 39/100, [markdown](https://verifymcp.io/servers/mambaventures-nzxplorer-mcp/mcp.md), [page](https://verifymcp.io/servers/mambaventures-nzxplorer-mcp/mcp)
- npm · `nzxplorer-mcp`: 68/100 (this document), [markdown](https://verifymcp.io/servers/mambaventures-nzxplorer-mcp/nzxplorer-mcp.md), [page](https://verifymcp.io/servers/mambaventures-nzxplorer-mcp/nzxplorer-mcp)

## Channel facts

- Registry: `npm`
- Package: `nzxplorer-mcp`
- Version: `1.36.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 87/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 51 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 71/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 9254 tokens (~159/item across 58 items; 58 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 23/100
  - Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add mambaventures-nzxplorer-mcp -- npx -y nzxplorer-mcp
```

### Codex

```bash
codex mcp add mambaventures-nzxplorer-mcp -- npx -y nzxplorer-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mambaventures-nzxplorer-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "nzxplorer-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add mambaventures-nzxplorer-mcp --command npx --arg -y --arg nzxplorer-mcp
```

### Hermes

```yaml
mcp_servers:
  mambaventures-nzxplorer-mcp:
    command: "npx"
    args: ["-y", "nzxplorer-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "mambaventures-nzxplorer-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "nzxplorer-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 68, +4)

- [functional improvement] Stability: unverified → 0.23

### 2026-08-02 (score 64, +30)

- [security regression] Provenance: unverified → fail
- [security improvement] Install scripts: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Malware scan: unverified → pass
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] License: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional] Licence: MIT

### 2026-07-31 (score 34, −5)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 39, −39)

- [security regression] Malware scan: pass → unverified
- [security regression] Provenance: fail → unverified
- [security regression] Install scripts: pass → unverified
- [security regression] Known CVEs: partial → unverified
- [functional regression] License: pass → unverified
- [functional regression] Dependency health: partial → unverified
- [functional regression] Maintenance: pass → unverified
- [functional] Licence: MIT

### 2026-07-27 (score 78, +50)

- [security regression] Provenance: unverified → fail
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Install scripts: unverified → pass
- [functional regression] Security disclosure: unverified → fail
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] License: unverified → pass
- [functional improvement] Maintenance: unverified → pass
- [functional] First check of Schema quality: fail
- [functional] First check of Schema quality: excellent
- [functional] First check of Tool coverage: 100
- [functional] First check of Schema quality: fail
- [functional] Licence: MIT

### 2026-07-26 (score 28)

First indexed and scored.

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

## MCP tools (58)

### `get_companies` (~89 tokens)

List NZX-listed companies. Returns ticker, name, sector, market cap for 130 companies on the New Zealand Stock Exchange.

Input parameters:

- `limit` (number): Number of results (default 50, max 100)
- `search` (string): Search by company name or ticker symbol
- `sector` (string): Filter by sector (e.g. 'Energy', 'Healthcare', 'Property')

### `get_company` (~96 tokens)

Get detailed information about a specific NZX company by ticker symbol. Optionally include directors, financials, governance score, and latest stock price.

Input parameters:

- `include` (string): Comma-separated additional data to include: directors, financials, governance, price, or 'all' for everything
- `ticker` (string, required): NZX ticker symbol (e.g. 'AIR', 'SPK', 'FPH', 'RYM')

### `get_directors` (~98 tokens)

List directors of NZX-listed companies. Search by name or filter by company ticker. Returns name, roles, appointment dates.

Input parameters:

- `company` (string): Filter by company ticker (e.g. 'AIR' to get Air New Zealand directors)
- `current` (boolean): If true, only return currently-serving directors
- `limit` (number): Number of results (default 50)
- `search` (string): Search by director name

### `get_director` (~104 tokens)

Get a detailed profile of a specific NZX director by their URL slug. Includes biography, board appointments, and optionally insider trades and remuneration history.

Input parameters:

- `include` (string): Comma-separated additional data: trades (insider share transactions), remuneration (board fees), exec_comp (executive pay packages with STI/LTI), or 'all'
- `slug` (string, required): Director URL slug (e.g. 'john-smith'). Find slugs via get_directors.

### `get_stock_prices` (~127 tokens)

Get historical daily stock prices for an NZX company. Returns OHLCV data (open, high, low, close, volume) in NZD.

Input parameters:

- `days` (number): Number of trailing days of data (default 365)
- `from` (string): Start date in YYYY-MM-DD format
- `limit` (number): Maximum data points to return (default 365, max 2000)
- `ticker` (string, required): NZX ticker symbol (e.g. 'AIR', 'FPH')
- `to` (string): End date in YYYY-MM-DD format

### `get_governance_scores` (~175 tokens)

Get Governance Risk Scores (GRS v2.0) for NZX companies. Each company scored 0-100 across 6 components: Executive Remuneration, Board Structure, Shareholder Rights, Board Effectiveness, Audit & Risk, and Remuneration Disclosure. Ratings: Excellent (80+), Very Good (70-79), Good (60-69), Adequate (50-59), Poor (40-49), Very Poor (<40). Covers all 130 NZX-listed companies.

Input parameters:

- `limit` (number): Number of results (default 50)
- `max_score` (number): Maximum total GRS score
- `min_score` (number): Minimum total GRS score
- `rating` (string): Filter by rating tier
- `sector` (string): Filter by sector

### `search_announcements` (~207 tokens)

Search 64,000+ NZX company announcements from 2017-2026. Full-text search across announcement titles. Types include: SHINTR (insider trades), GENERAL, MKTUPDTE (market updates), SECISSUE (security issues), MEETING, DIVCASH (dividends), and 50+ more.

Input parameters:

- `from` (string): Start date in YYYY-MM-DD format
- `limit` (number): Number of results (default 20, max 100)
- `search` (string): Full-text search query (e.g. 'dividend', 'CEO appointment', 'capital raise')
- `ticker` (string): Filter by company ticker (e.g. 'AIR')
- `to` (string): End date in YYYY-MM-DD format
- `type` (string): Filter by announcement type (e.g. 'SHINTR', 'GENERAL', 'MEETING', 'DIVCASH', 'MKTUPDTE')

### `get_insider_trades` (~176 tokens)

Get insider (director) share transactions for NZX companies. 4,100+ trades covering buy/sell/exercise transactions. Shows who is buying and selling, how much, and at what price. Filter by company ticker, transaction type, date range, or specific director.

Input parameters:

- `director` (string): Filter by director slug (e.g. 'john-smith')
- `from` (string): Start date in YYYY-MM-DD format
- `limit` (number): Number of results (default 50, max 100)
- `ticker` (string): Filter by company ticker (e.g. 'AIR', 'FPH')
- `to` (string): End date in YYYY-MM-DD format
- `type` (string): Filter by transaction type (e.g. 'Buy', 'Sell', 'Exercise')

### `get_financials` (~197 tokens)

Get normalized financial statements for an NZX company. Returns income statements, balance sheets, cash flow statements, and financial ratios. All monetary values in NZD thousands. 367 records across 116 companies, FY2010-2025.

Input parameters:

- `limit` (number): Number of results per statement (default 50)
- `statement` (string): Which financial statement to return. If omitted, returns all four. income = revenue/profit/EPS/dividends. balance = assets/liabilities/equity. cashflow = operating/investing/financing/free. ratios =…
- `ticker` (string, required): NZX ticker symbol (e.g. 'AIR', 'FPH', 'SPK')
- `year` (string): Filter by year: single year (e.g. '2024') or range (e.g. '2020-2024')

### `get_earnings` (~170 tokens)

Get structured earnings results for an NZX company. Extracted from full-year (FLLYR) and half-year (HALFYR) announcement PDFs. Returns revenue, net profit, EBITDA, EBIT, EPS, dividends per share, guidance, and prior period comparisons. All monetary values in NZD thousands.

Input parameters:

- `limit` (number): Number of results (default 50)
- `period` (string): Filter by period type: 'annual' for full-year, 'interim' for half-year
- `ticker` (string, required): NZX ticker symbol (e.g. 'AIR', 'FPH', 'SPK')
- `year` (string): Filter by year: single year (e.g. '2024') or range (e.g. '2020-2024')

### `get_dividends` (~159 tokens)

Get dividend history for an NZX company. Returns ex-date, record date, payment date, DPS (cents), imputation %, supplementary dividends, DRP availability, and dividend safety metrics. 1,184 records across 102 companies.

Input parameters:

- `limit` (number): Number of results (default 50)
- `ticker` (string, required): NZX ticker symbol (e.g. 'AIR', 'FPH', 'SPK')
- `type` (string): Filter by dividend type: 'final', 'interim', or 'special'. Comma-separated for multiple.
- `year` (string): Filter by year: single year (e.g. '2024') or range (e.g. '2020-2024')

### `get_technical_signals` (~91 tokens)

Get technical analysis indicators for an NZX company. Returns SMA-50/100/200 moving averages, RSI-14 momentum, golden/death cross signals, distance from 52-week high/low, and volume ratios. Updated daily. 127/130 companies covered.

Input parameters:

- `ticker` (string, required): NZX ticker symbol (e.g. 'AIR', 'FPH', 'MEL')

### `screen_stocks` (~388 tokens)

Screen NZX stocks using 87+ financial, governance, and technical metrics. Supports 12 smart presets (value, growth, quality, dividend_at_risk, insider_buying, capital_raise_likely, ceo_pay_for_failure, governance_laggards, oversold, overbought, golden_cross, below_200ma) and custom metric filters. Returns matching companies with selected columns, sorted by any metric. Use this to find stocks matching specific criteria like 'PE under 15 with dividend yield above 5%' or 'RSI below 30'.

Input parameters:

- `filter` (string): Custom metric filters as comma-separated conditions. Format: metric>value,metric<value. Examples: 'pe_ratio<15,dividend_yield>3', 'rsi_14<30', 'roe>15,debt_to_equity<1'. Operators: >, <, >=, <=, =. A…
- `limit` (number): Number of results (default 50, max 130)
- `order` (string): Sort order (default 'asc')
- `preset` (string): Smart preset filter. Each preset applies specific metric filters and shows relevant columns.
- `q` (string): Search by company name or ticker
- `sector` (string): Filter by sector (e.g. 'Energy', 'Healthcare', 'Property')
- `sort` (string): Sort by any column name (e.g. 'pe_ratio', 'market_cap', 'dividend_yield', 'rsi_14', 'grs_score')

### `get_performance` (~107 tokens)

Get stock performance metrics for an NZX company. Returns price returns (1D, 1W, 1M, 3M, 6M, 1Y, 3Y, 5Y), alpha vs NZX50 benchmark, sector alpha, volatility, beta, 52-week high/low, and market capitalization. Updated daily.

Input parameters:

- `ticker` (string, required): NZX ticker symbol (e.g. 'AIR', 'FPH', 'MEL')

### `get_director_due_diligence` (~123 tokens)

Get a comprehensive due diligence report for any NZX director. Aggregates all board positions (with GRS scores), overboarding assessment, remuneration across all boards with peer percentile, executive compensation, insider trading activity summary, AGM election voting record, governance contribution analysis, stock performance during tenure, and automated risk flags. Designed for executive search firms, law firms, and nominating committees assessing board candidates.

Input parameters:

- `slug` (string, required): Director URL slug (e.g. 'joan-withers', 'mark-cross'). Find slugs via get_directors.

### `get_market_signals` (~250 tokens)

Get the Market Intelligence Feed — a unified stream of all NZX market events: 10 signal types including insider trades, capital raises, dividends, earnings releases, AGM results, director changes, governance score changes, technical signals (golden/death cross, RSI extremes), credit rating changes, and auditor changes. Sorted by date descending. Use for 'what happened on the NZX today/this week?', 'any golden crosses?', 'credit rating changes?', or 'market activity for [company]'.

Input parameters:

- `days` (number): Days to look back (default 180). Use 7 for 'this week', 1 for 'today'.
- `limit` (number): Max results (default 50)
- `sector` (string): Filter by sector (e.g. 'Energy', 'Healthcare')
- `significance` (string): Filter by significance: high, medium, low
- `ticker` (string): Filter by company ticker (e.g. 'AIR', 'MEL')
- `type` (string): Comma-separated signal types: insider_trade, capital_raise, dividend, earnings, agm_result, director_change, grs_change, technical_signal, credit_rating, audit_change

### `get_anomalies` (~208 tokens)

Detect unusual patterns and red flags across NZX companies. Scans 12 anomaly types across 5 categories: insider trading (clusters, exodus, conviction shifts), governance (GRS deterioration, director exodus, audit changes), financial (dividend cut risk, capital raise patterns, earnings concerns), market (technical breakdowns/breakouts), and AGM (shareholder revolts). Returns anomalies sorted by severity. Use for 'any red flags?', 'governance concerns for [company]?', 'insider trading anomalies'.

Input parameters:

- `category` (string): Filter by category: insider, governance, financial, market, agm
- `days` (number): Days to look back (default 180)
- `sector` (string): Filter by sector (e.g. 'Energy', 'Healthcare')
- `severity` (string): Filter by severity: critical, warning, watch
- `ticker` (string): Filter by company ticker (e.g. 'AIR', 'MEL')

### `get_financials_xbrl` (~162 tokens)

Get machine-readable iXBRL (Inline XBRL) financial statements for an NZX company. Returns IFRS taxonomy-tagged income statements, balance sheets, cash flows, and financial ratios. Each data point is tagged with its XBRL concept (e.g. ifrs-full:Revenue), period context, and unit. 116 companies, FY2010-2025. Use when the user wants structured/machine-readable financial data, XBRL output, or data for programmatic consumption.

Input parameters:

- `ticker` (string, required): NZX ticker symbol (e.g. 'AIR', 'FPH', 'MEL')
- `year` (string): Fiscal year (e.g. '2024'). Default: latest available year.

### `get_esg_xbrl` (~170 tokens)

Get machine-readable NZ Climate Standards (NZ CS 1-3) tagged ESG/climate disclosure for an NZX company. Returns XRB Aotearoa taxonomy-tagged emissions (Scope 1/2/3 GHG), diversity metrics (board/SLT/employee gender), workplace safety (LTIFR/TRIFR), and reporting framework compliance (GRI, TCFD, SBTi, SDG). Use when the user wants ESG data, climate disclosures, emissions, diversity stats, or sustainability data in structured format.

Input parameters:

- `ticker` (string, required): NZX ticker symbol (e.g. 'MEL', 'CEN', 'GNE')
- `year` (string): Fiscal year (e.g. '2024'). Default: latest available year.

### `get_proxy_report` (~173 tokens)

Get automated proxy advisory voting recommendations for a company's AGM resolutions. Analyses board composition, remuneration, auditor independence, capital management, constitution changes, related-party transactions, and shareholder proposals against configurable voting policies (8 presets including NZ Super Fund, ISS NZ Benchmark, Russell Investments NZ, Vanguard AU/NZ). Returns FOR/AGAINST/REFER per resolution with severity, reasoning, and data points. Use for 'how should I vote at [company] AGM?', 'proxy report for AIR', 'voting recommendations for MEL'.

Input parameters:

- `meeting_id` (string): Specific meeting ID if known
- `ticker` (string, required): Company ticker (e.g. 'AIR', 'MEL', 'FPH')
- `year` (string): Meeting year to filter resolutions (e.g. '2025'). Default: latest

### `get_takeovers` (~237 tokens)

Get M&A and takeover activity for NZX companies. 313 deals across 51 issuers (2017-2026). 11 deal types: takeover_offer, acquisition, scheme_of_arrangement, merger, asset_acquisition, property_acquisition, compulsory_acquisition, and more. Returns acquirer, target, deal type, offer price, premium, status, acceptance %, key dates, and conditions. Use for 'any takeover activity for [company]?', 'recent M&A deals', 'scheme of arrangement history'.

Input parameters:

- `deal_type` (string): Filter by deal type: takeover_offer, acquisition, scheme_of_arrangement, merger, asset_acquisition, property_acquisition, compulsory_acquisition
- `status` (string): Filter by deal status (e.g. 'completed', 'active', 'lapsed', 'withdrawn')
- `ticker` (string, required): NZX ticker symbol of the target company (e.g. 'THL', 'NZM', 'TRA')
- `year` (string): Filter by year (e.g. '2025') or range (e.g. '2020-2025')

### `get_board_changes` (~207 tokens)

Get board changes (director appointments, resignations, retirements, removals) for an NZX company. 1,242 changes across 105 issuers (2017-2026). Shows director name, action, role, effective date, who they replaced, reason for departure, and linked director profile. Use for 'who joined/left the board?', 'recent director changes at [company]', 'board turnover history'.

Input parameters:

- `action` (string): Filter by action type: appointed, resigned, retired, removed, elected, re-elected. Comma-separated for multiple (e.g. 'resigned,retired').
- `from` (string): Start date in YYYY-MM-DD format
- `limit` (number): Number of results (default 50, max 100)
- `ticker` (string, required): NZX ticker symbol (e.g. 'AIR', 'FPH', 'MEL')
- `to` (string): End date in YYYY-MM-DD format

### `get_board_composition_report` (~158 tokens)

Get a comprehensive board composition analytics report for an NZX company. Analyzes board independence vs NZX Code requirements, gender diversity vs 30% target, tenure distribution with 9-year limit flags, skills matrix with gap identification, meeting attendance, director fee benchmarking, CEO pay ratio, succession risk scoring (low/medium/high/critical), board turnover rates, and peer comparison against sector averages. Returns automated risk flags across 10 categories. Use for 'board composition for [company]', 'governance quality analysis', 'succession risk', 'board diversity metrics', or 'nomination committee report'.

Input parameters:

- `ticker` (string, required): NZX ticker symbol (e.g. 'AIR', 'FPH', 'MEL')

### `get_accounting_quality` (~211 tokens)

Get accounting quality scores for an NZX company. Shows Beneish M-score (earnings manipulation probability, >-1.78 suggests manipulation), Piotroski F-score (financial strength 0-9, higher is better), Altman Z-score (bankruptcy risk: >2.99 safe, 1.81-2.99 grey zone, <1.81 distress), plus interest coverage, current ratio, and overall composite score (0-100). 128 issuers scored. Use for 'is [company] at risk of manipulation?', 'financial health of [company]', 'bankruptcy risk', 'accounting quality'.

Input parameters:

- `limit` (number): Number of results (default 50)
- `ticker` (string, required): NZX ticker symbol (e.g. 'AIR', 'FPH', 'MEL')
- `year` (string): Filter by year: single year (e.g. '2024') or range (e.g. '2020-2024')

### `get_credit_ratings` (~227 tokens)

Get credit rating history for an NZX company. Shows S&P, Moody's, Fitch, AM Best, Equifax ratings with upgrades, downgrades, outlook changes, and rating actions. ~80 ratings across ~20 NZX issuers (mainly banks, utilities, large caps). Use for 'credit rating for [company]', 'has [company] been downgraded?', 'investment grade NZX companies'.

Input parameters:

- `action` (string): Filter by action: affirmed, upgraded, downgraded, assigned, withdrawn, revised
- `agency` (string): Filter by rating agency: 'S&P', 'Moodys', 'Fitch', 'AM Best', 'Equifax'
- `limit` (number): Number of results (default 50)
- `ticker` (string, required): NZX ticker symbol (e.g. 'ANZ', 'WBC', 'MEL', 'SPK')
- `year` (string): Filter by year: single year (e.g. '2024') or range (e.g. '2020-2024')

### `get_risk_language` (~128 tokens)

Get pre-computed risk language scores for an NZX company. Scans 64,000+ announcements for 8 risk categories: going_concern, covenant, impairment, litigation, restructuring, liquidity, regulatory, force_majeure. Returns total mentions, 12-month trend, category breakdown, critical flags, first-time detections, and yearly trend. Use when asked about risk factors, going concern warnings, covenant issues, litigation exposure, or regulatory risk.

Input parameters:

- `ticker` (string, required): NZX ticker symbol (e.g. 'FBU', 'AIR', 'MEL')

### `search_keyword_trends` (~116 tokens)

Search any keyword or phrase across 64,000+ NZX company announcements and see how often it appears over time. Returns frequency by year, sector, and top companies. Like Google Trends for corporate filings. Use for 'when did companies start talking about AI?', 'which sector mentions climate risk most?', 'how often does restructuring appear in filings?'.

Input parameters:

- `keyword` (string, required): Keyword or phrase to search (e.g. 'artificial intelligence', 'restructuring', 'net zero', 'covenant breach')

### `list_stewardship_reports` (~45 tokens)

List FMA-compliant stewardship/voting-record reports for the authenticated user. Returns report summaries with vote counts, compliance rates, and period dates. Enterprise tier required.

### `get_stewardship_report` (~52 tokens)

Get full detail for a specific stewardship report by ID, including per-company resolution analysis, vote recommendations, and the policy used. Enterprise tier required.

Input parameters:

- `id` (number, required): Stewardship report ID

### `list_voting_policies` (~52 tokens)

List all custom voting policies for the authenticated user. Each policy defines threshold overrides for the proxy advisory engine (board independence, remuneration caps, tenure limits, gender diversity, etc.). Enterprise or Institutional tier required.

### `get_revenue_segments` (~209 tokens)

Get revenue segment breakdown for an NZX company. Returns IFRS 8 operating, geographic, or product segment data including segment revenue, operating profit, assets (all in NZD thousands), and revenue percentage. Extracted from annual report PDFs. Use for 'revenue breakdown for [company]', 'business segments', 'divisions', 'product groups', 'geographic revenue split', 'segment analysis'. Multi-segment companies like FPH (Hospital/Homecare), MEL (Wholesale/Retail), FBU (Building Products/Construction/Distribution).

Input parameters:

- `limit` (number): Number of results (default 50)
- `ticker` (string, required): NZX ticker symbol (e.g. 'FPH', 'SKC', 'MEL', 'FBU')
- `type` (string): Segment type filter: operating, geographic, product
- `year` (string): Filter by year (e.g. '2025') or range (e.g. '2020-2025')

### `list_alert_subscriptions` (~105 tokens)

List all alert subscriptions for the authenticated user. Each subscription filters market signals and anomalies by tickers, sectors, signal types (insider_trade, capital_raise, dividend, earnings, agm_result, director_change, grs_change, technical_signal, credit_rating, audit_change, takeover), anomaly categories (insider, governance, financial, market, agm, corporate), and severity levels — then delivers via webhook with HMAC-SHA256 signing. Enterprise tier required.

### `get_capital_raises` (~234 tokens)

Get capital raise history for an NZX company. 11,088 events across 130 issuers. Includes placements, rights issues, SPPs, IPOs, bonds, buybacks, DRPs, options exercises, employee schemes, and conversions. Returns shares issued, price, total amount (NZD), discount %, dilution %, purpose. Use for 'capital raises for [company]', 'how much has [company] raised?', 'buyback history', 'dilution risk'.

Input parameters:

- `buybacks` (string): Set to 'true' to only show buybacks
- `limit` (number): Number of results (default 50)
- `ticker` (string, required): 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): Filter by year (e.g. '2025') or range (e.g. '2020-2025')

### `get_semantic_search` (~187 tokens)

Search 64,000+ NZX announcements using AI semantic search. Uses text-embedding-3-small vectors with hybrid keyword+semantic+reranking for best results. Finds conceptual matches that keyword search misses (e.g. 'climate risk' finds 'environmental exposure'). Returns relevance-ranked results with similarity scores and text snippets.

Input parameters:

- `from` (string): Start date in YYYY-MM-DD format
- `limit` (number): Number of results (default 10)
- `q` (string, required): Search query (e.g. 'climate risk disclosure', 'CEO succession planning', 'covenant breach')
- `ticker` (string): Filter by company ticker (e.g. 'AIR')
- `to` (string): End date in YYYY-MM-DD format
- `type` (string): Filter by announcement type (e.g. 'GENERAL', 'FLLYR')

### `get_iod_designations` (~191 tokens)

Get Institute of Directors (IoD) designated directors serving on NZX boards. Shows CFInstD (Chartered Fellow — highest designation), CMInstD (Chartered Member), CDir (Chartered Director), and MInstD (Member). Returns current board seats, chair status, gender, and summary statistics. Use for 'IoD directors at [company]', 'chartered directors', 'governance credentials', 'CFInstD directors', 'professional director qualifications'.

Input parameters:

- `designation` (string): Filter by IoD designation: 'CFInstD', 'CMInstD', 'CDir', 'MInstD'
- `limit` (number): Number of results (default 50)
- `name` (string): Search by director name
- `ticker` (string): Filter by NZX ticker to see IoD directors at a specific company (e.g. 'FPH')

### `get_board_skills_matrix` (~132 tokens)

Get the board skills matrix for an NZX company. Shows per-director skills across 12 IoD NZ/ASX CGC categories (finance, legal, technology, industry, governance, risk, strategy, HR, sustainability, digital, international, marketing), board-level gap analysis (critical/single_point/depth_gap/adequate), and diversity score. Use for 'board skills at [company]', 'skills matrix', 'board gaps', 'director competencies', 'governance capability'.

Input parameters:

- `ticker` (string, required): NZX ticker symbol (e.g. 'FPH', 'AIR')

### `get_research_briefing` (~182 tokens)

Get a comprehensive investment research briefing for an NZX company. Assembles data from 15+ sources (governance, financials, insider activity, dividends, board, earnings, credit, performance, capital raises, announcements) with AI narrative synthesis. Supports 4 templates: 'general' (default), 'investment_thesis', 'due_diligence', 'board_meeting'. Use for 'research report on [company]', 'investment thesis for [ticker]', 'due diligence on [company]', 'company research briefing'.

Input parameters:

- `focus` (string): Comma-separated focus areas (e.g. 'dividends,governance,insider activity')
- `template` (string): Research template (default: 'general')
- `ticker` (string, required): NZX ticker symbol (e.g. 'FPH', 'AIR')

### `get_fund_votes` (~193 tokens)

Get actual voting records from NZ fund managers (Harbour, Devon, Mint, Fisher, NZ Super Fund) for an NZX company. Shows how institutional investors voted on AGM resolutions — FOR, AGAINST, or ABSTAIN. Includes ISS recommendations and management recommendations. Use for 'how did funds vote on [company]', 'fund voting records', 'institutional votes', 'AGM voting', 'proxy votes'.

Input parameters:

- `fund_manager` (string): Filter by fund manager name (e.g. 'Harbour', 'Devon', 'NZ Super')
- `ticker` (string, required): NZX ticker symbol (e.g. 'AIR', 'FPH')
- `vote` (string): Filter by vote cast (FOR, AGAINST, ABSTAIN)
- `year` (string): Filter by year (e.g. '2024') or range (e.g. '2023-2025')

### `get_announcement_sentiment` (~207 tokens)

Get AI-scored sentiment analysis of NZX company announcements. Returns per-announcement sentiment scores (-1 to +1), confidence levels, hedging analysis, buried risks, key topics, and guidance direction. Includes company-level summary with average score, sentiment breakdown, and overall rating. Use for 'sentiment on [company] announcements', 'what is the tone of [ticker] filings', 'buried risks in [company] announcements', 'announcement sentiment', 'hedging language'.

Input parameters:

- `from` (string): Start date (YYYY-MM-DD)
- `hedging` (string): Filter by hedging level: none, low, moderate, heavy
- `limit` (number): Max results (default 20)
- `sentiment` (string): Filter by sentiment: positive, negative, neutral, mixed
- `ticker` (string, required): NZX ticker symbol (e.g. 'AIR', 'FPH')
- `to` (string): End date (YYYY-MM-DD)

### `get_ir_quality` (~168 tokens)

Get the IR (Investor Relations) disclosure quality score for an NZX company. Scores 5 dimensions: Timeliness (OECD/NZX Rule 10.4.1), Completeness (CFA DQI/S&P T&D), Readability (Loughran-McDonald proxy), Frequency (NIRI Standards), Governance Transparency (S&P T&D/GRS v2). Composite score 0-100, rating A+ to D, trajectory improving/stable/declining. 131 issuers scored. Use for 'how good is [company] at disclosure?', 'IR quality for [company]', 'disclosure quality', 'transparency score'.

Input parameters:

- `ticker` (string, required): NZX ticker symbol (e.g. 'AIR', 'FPH', 'MEL')

### `get_peer_mentions` (~133 tokens)

Get peer mentions for an NZX company — cross-company references extracted from 62,000+ NZX announcements. Shows which companies mention this ticker and which companies it references, with context snippets and network summary. Use for 'who mentions [company]?', 'business relationships for [company]', 'competitive peers', 'peer network'.

Input parameters:

- `direction` (string): Filter: 'mentions' (who this company references), 'mentioned_by' (who references it), or 'both' (default)
- `ticker` (string, required): NZX ticker symbol (e.g. 'AIR', 'FPH', 'SPK')

### `get_political_connections` (~127 tokens)

Get political connections for an NZX company. Returns MP interests (gifts, hospitality, shareholdings, travel mentioning this company from the NZ Parliamentary Register of Interests), political donors linked to the company or its directors, and party donation records from the Electoral Commission (2019-2024). Use for 'political connections for [company]', 'which MPs are connected to [company]?', 'do any directors donate to political parties?', 'political exposure'.

Input parameters:

- `ticker` (string, required): NZX ticker symbol (e.g. 'SKC', 'AIR', 'SAN')

### `get_management_team` (~183 tokens)

Get the management team (C-suite executives) for an NZX company. Returns current CEO, CFO, COO, CTO, and other senior executives with roles, tenure, biographies, and profile links. 127 issuers covered, 508 current executives across 15 normalized roles (CEO, CFO, COO, CTO, CIO, CLO, CPO, CMO, CRO, CDO, CS, GM, VP, MD, Other). Use for 'who is the CEO of [company]?', 'management team for [ticker]', 'C-suite at [company]', 'executive leadership'.

Input parameters:

- `role` (string): Filter by normalized role (e.g. 'CEO', 'CFO', 'COO', 'CTO')
- `ticker` (string, required): NZX ticker symbol (e.g. 'FPH', 'AIR', 'SPK')

### `get_beneficial_ownership` (~150 tokens)

Get beneficial ownership intelligence for an NZX company. Sees through custodian nominees (HSBC, BNP Paribas, Citibank) to identify actual fund managers behind NZX shareholdings. Returns fund manager positions, custodian mappings, and fund holdings from factsheet data. 56 fund managers tracked, covering ETF providers, KiwiSaver managers, sovereign wealth funds, and international institutional investors. Use for 'who owns [company]?', 'beneficial ownership', 'which fund managers hold [ticker]?', 'institutional ownership', 'custodian nominees'.

Input parameters:

- `ticker` (string, required): NZX ticker symbol (e.g. 'FPH', 'AIR', 'SPK')

### `get_substantial_holder_notices` (~158 tokens)

Get classified substantial holder notices (SPH) for an NZX company. Returns all substantial product holder notices with extracted holder names, percentage holdings, direction (increase/decrease/initial/ceased), and fund manager matching. 9,700+ notices classified from NZX SHINTR announcements. Use for 'substantial holders of [ticker]', 'SPH notices', 'who increased holdings in [company]?', 'recent ownership changes', 'substantial product holder movements'.

Input parameters:

- `direction` (string): Filter by direction of holding change
- `limit` (number): Max results (default 50)
- `ticker` (string, required): NZX ticker symbol (e.g. 'FPH', 'AIR', 'SPK')

### `get_corporate_giving` (~122 tokens)

Get corporate donations, sponsorships, and community investment for an NZX company. Shows recipients, amounts, donation types (cash/sponsorship/community_investment/grant/in-kind), foundation name, and total community investment. Cross-linked to registered charities where possible. Use for 'what charities does [company] support?', 'corporate giving', 'community investment', 'sponsorship', 'donations by [ticker]'.

Input parameters:

- `ticker` (string, required): NZX ticker symbol (e.g. 'SPK', 'AIR', 'GMT')

### `get_property_portfolio` (~172 tokens)

Get property portfolio data for an NZX-listed REIT or property company. Returns individual properties with addresses, book values, cap rates, WALE, occupancy, major tenants, geocoded locations, plus summary stats (total value, avg cap rate, avg WALE, avg occupancy), type/regional breakdowns, top tenants, and development pipeline. Covers ~10 property companies (KPG, ARG, PFI, VHP, IPL, SPG, CDI, GMT, PCT, APL). Use for 'property portfolio', 'REIT assets', 'commercial property', 'cap rate', 'WALE', 'occupancy', 'tenant exposure'.

Input parameters:

- `ticker` (string, required): NZX ticker symbol (e.g. 'KPG', 'GMT', 'PFI', 'ARG')

### `get_fair_value` (~163 tokens)

Get estimated fair value for an NZX company using 3 valuation models: DCF (discounted cash flow), Dividend Discount Model (Gordon Growth), and EV/EBITDA relative valuation. Returns composite fair value per share, price-to-fair-value ratio, individual model outputs, confidence level, assumptions used, and methodology notes. NOTE: This is an automated estimate using standard financial models, NOT a target price or investment recommendation.

Input parameters:

- `discount_rate` (number): Discount rate / WACC (default 0.10 = 10%)
- `terminal_growth` (number): Terminal growth rate (default 0.025 = 2.5%)
- `ticker` (string, required): NZX ticker symbol (e.g. 'FPH', 'AIR')

### `get_deal_advisers` (~165 tokens)

Get professional advisers (law firms, investment banks, valuers) who advised on capital raises and takeovers for an NZX company. Shows which firms acted as legal counsel, underwriter, lead manager, independent adviser, or valuer on each deal. Includes deal details (amount, type, date) and adviser roles. Use for deal intelligence, adviser league tables, or capital markets analysis.

Input parameters:

- `deal_type` (string): Filter: 'capital_raise' or 'takeover'
- `role` (string): Filter by adviser role: legal_issuer, underwriter, lead_manager, financial_adviser, independent_adviser, valuer, etc.
- `ticker` (string, required): NZX ticker symbol (e.g. 'CEN', 'FPH')

### `get_company_directorships` (~109 tokens)

Get full directorship history for any person from the NZ Companies Register. Shows all company roles (NZX-listed + private companies), current and historical, with company status (active/struck off/liquidating) and failure rate analysis. Use when asked about a person's full board network, private company roles, directorship workload, or company failure history.

Input parameters:

- `slug` (string, required): Person slug from shared.people (e.g. 'rob-campbell', 'joan-withers')

### `get_director_workload` (~96 tokens)

Get workload analysis for a director — current NZX board seats, active Companies Office directorships, overboarding risk level (low/average/elevated/high), board meeting attendance rate, tenure at each board, and chair/committee roles. Use for overboarding checks, governance due diligence, or board capacity assessment.

Input parameters:

- `slug` (string, required): Person slug from shared.people (e.g. 'rob-campbell')

### `get_director_network` (~148 tokens)

Cross-directorship and board interlock analysis with 3 modes: (1) company mode (?ticker=AIR) — shows all directors' external boards and shared entities, (2) director mode (?director=joan-withers) — person-centric 1-hop network, (3) network mode (no params) — NZX-wide cross-directorship map. Returns nodes, edges, and interlock metrics.

Input parameters:

- `director` (string): Director slug for person mode (e.g. 'joan-withers')
- `include_historical` (boolean): Include historical positions (default false)
- `ticker` (string): NZX ticker for company mode (e.g. 'AIR')

### `get_board_pipeline` (~122 tokens)

Directors who have recently freed up board capacity — resignations, retirements, and reduced workloads in the last 12 months. Returns departed directors with their remaining board count, skills, qualifications, and departure details. Use for board recruitment, candidate identification, or talent pipeline analysis.

Input parameters:

- `limit` (number): Max results (default 20, max 200)
- `sector` (string): Filter by sector (e.g. 'Energy', 'Healthcare')
- `skill` (string): Filter by skill category (e.g. 'governance', 'financial')

### `get_governance_scorecard` (~197 tokens)

Get a per-company governance scorecard with RAG (red/amber/green) ratings across 15 policy areas aligned with NZSA governance policies and the NZX Corporate Governance Code v1.7. Covers: remuneration disclosure, CEO rem structure, board independence, audit independence (non-audit >25% flag), director tenure (9yr threshold), board diversity (30% target), shareholder voting dissent (<75% threshold), ESG profile, capital management, takeover vulnerability, management credibility, succession readiness, audit firm tenure, director share ownership, whistleblowing. Returns overall score 0-100, individual policy assessments with scores and data. Use for 'governance scorecard for [company]', 'governance assessment', 'board governance quality', 'NZSA-aligned governance report'.

Input parameters:

- `ticker` (string, required): NZX ticker symbol (e.g. 'FPH', 'AIR', 'SPK')

### `check_insolvency_status` (~115 tokens)

Check insolvency/bankruptcy history for any person in the NZXplorer database. Queries the MBIE Insolvency Register for bankruptcy, no-asset procedures, and summary instalment orders. Returns TTL-filtered records per MBIE Agreement cl 4.5-4.6. Use when asked about a person's insolvency history, bankruptcy status, financial fitness to serve as director, or due diligence screening.

Input parameters:

- `slug` (string, required): Person slug from NZXplorer (e.g. 'john-smith')

### `get_officer_history` (~250 tokens)

Get the full historical officer timeline for an NZX company — every director and executive who has ever held a role, with start/end dates, tenure, status, and committees. Includes both board members (from director_appointments) and C-suite executives (from management_team). Each officer carries a stable permanent_id (NZX-P-NNNNNN) for cross-referencing across NZXplorer. Use for questions about past leadership, board turnover, executive churn, board refreshment, or who used to run a company.

Input parameters:

- `from` (string): Only appointments effective on/after this date (YYYY-MM-DD)
- `role` (string): Filter by role keyword (comma-separated): 'chair,ceo,cfo,director'
- `status` (string): Filter by status (comma-separated): 'current,resigned,retired'
- `ticker` (string, required): NZX ticker symbol (e.g. 'FPH', 'AIR', 'SPK')
- `to` (string): Only appointments effective on/before this date (YYYY-MM-DD)
- `type` (string): Filter by officer type: 'board', 'executive', or 'all' (default 'all')

### `get_compensation_benchmark` (~216 tokens)

Get compensation percentile benchmarking for a specific executive or board role across all NZX companies. Returns P10/P25/P50/P75/P90 percentiles, mean, min, max, plus breakdowns by sector and market-cap tier (micro/small/mid/large). Use for questions about market pay rates, peer-comparison benchmarks, whether a company overpays or underpays for a role, or due-diligence on remuneration committee decisions.

Input parameters:

- `market_cap` (string): Filter by market-cap tier: 'micro', 'small', 'mid', or 'large'
- `role` (string, required): Role to benchmark — one of: 'ceo', 'cfo', 'coo', 'chair', 'director', 'cto', 'cio', 'cro', 'general-counsel', 'company-secretary'
- `sector` (string): Filter by sector (e.g. 'Healthcare', 'Energy')
- `year` (number): Financial year filter (default: latest available per company)

### `get_daily_market_wrap` (~117 tokens)

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 an AI-generated narrative summary. Use for questions about today's NZX market, overall market conditions, what happened across the NZX, or weekly market summary.

Input parameters:

- `days` (number): Lookback window in days (1-7, default 7). Use 1 for last trading day.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/mambaventures-nzxplorer-mcp/nzxplorer-mcp#diagnostics

## Score history

- 2026-08-03: 68
- 2026-08-02: 64
- 2026-08-01: 34
- 2026-07-31: 34
- 2026-07-30: 39
- 2026-07-28: 78
- 2026-07-27: 78
- 2026-07-26: 28

## Links

- npm package: https://www.npmjs.com/package/nzxplorer-mcp
- Socket report: https://socket.dev/npm/package/nzxplorer-mcp
- Repository: https://github.com/mambaventures/nzxplorer-mcp-server
- Website: https://nzxplorer.co.nz/for-agents
- Changelog RSS feed: https://verifymcp.io/servers/mambaventures-nzxplorer-mcp/nzxplorer-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/mambaventures-nzxplorer-mcp/nzxplorer-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/mambaventures-nzxplorer-mcp/nzxplorer-mcp