NZXplorer MCP Server

An MCP (Model Context Protocol) server that gives AI assistants like Claude Desktop and Cursor direct access to New Zealand stock market data via the NZXplorer API.

Query 130 NZX-listed companies, 1,300+ directors, 162,000+ daily stock prices, governance risk scores, 4,100+ insider trades, 64,000+ company announcements, board composition analytics, anomaly detection, market signals, proxy advisory voting recommendations, and a powerful stock screener with 87+ metrics — all from natural language.

Quick Install (npm)

npx nzxplorer-mcp

Or install globally:

npm install -g nzxplorer-mcp

Available Tools (55)

| Tool | Description | |------|-------------| | get_companies | List NZX companies with search and sector filters | | get_company | Company detail by ticker — optionally include directors, financials, governance score, latest price | | get_directors | Search directors by name or filter by company | | get_director | Director profile with biography, appointments, insider trades, board fees, and executive compensation | | get_stock_prices | Daily OHLCV price data with date range and lookback filters | | get_governance_scores | Governance Risk Scores (0-100) for all 130 NZX companies across 6 components | | search_announcements | Full-text search across 64,000+ NZX announcements (2017-2026) | | get_insider_trades | Director share transactions — buys, sells, exercises. Filter by ticker, director, date, type | | get_financials | Normalized financial statements — income, balance sheet, cash flow, ratios. FY2010-2025 | | get_earnings | Structured earnings results — revenue, profit, EPS, guidance. Extracted from NZX PDFs | | get_dividends | Dividend history — DPS, imputation, DRP, payment dates. Plus dividend safety metrics | | get_technical_signals | Technical indicators — SMA-50/100/200, RSI-14, golden/death cross, volume ratios | | screen_stocks | Screen stocks using 87+ metrics, 12 smart presets, and custom filters (e.g. PE<15, RSI<30) | | get_performance | Stock performance — returns (1D-5Y), alpha vs NZX50, volatility, beta, 52-week range | | get_director_due_diligence | Comprehensive director due diligence report — 8 tables, 11 sections | | get_market_signals | Market Intelligence Feed — 10 signal types, unified event stream across all NZX companies | | get_anomalies | Anomaly detection — 12 types across 5 categories (insider, governance, financial, market, AGM) | | get_proxy_report | Proxy advisory voting recommendations — FOR/AGAINST/REFER per AGM resolution with 34 rules, 8 policy presets | | get_takeovers | M&A and takeover activity — 313 deals, 51 issuers, 11 deal types (2017-2026) | | get_board_changes | Board changes — appointments, resignations, retirements. 1,242 changes across 105 issuers | | get_board_composition_report | Board composition analytics — independence, diversity, tenure, skills, succession risk, peer comparison | | get_accounting_quality | Accounting quality scores — Beneish M-score, Piotroski F-score, Altman Z-score, interest coverage, current ratio, overall rating | | get_credit_ratings | Credit ratings from S&P, Moody's, Fitch, AM Best — rating, outlook, action, history | | get_risk_language | Risk language scoring — 8 categories (going concern, covenant, litigation, etc.) across 64K+ announcements | | search_keyword_trends | Keyword frequency trends across NZX announcements — like Google Trends for corporate filings | | list_stewardship_reports | List FMA-compliant stewardship/voting-record reports (Enterprise) | | get_stewardship_report | Full stewardship report detail with per-company resolution analysis (Enterprise) | | list_voting_policies | List custom voting policies for the proxy advisory engine (Enterprise/Institutional) | | get_revenue_segments | Revenue segment breakdown — IFRS 8 operating, geographic, product segments | | list_alert_subscriptions | List alert subscriptions — 11 signal types, 6 anomaly categories, HMAC-SHA256 webhooks (Enterprise) | | get_capital_raises | Capital raise history — 11,088 events across 130 issuers (placements, rights, SPPs, buybacks, DRPs) | | get_semantic_search | AI semantic search across 64K+ announcements — hybrid keyword+vector+reranking | | get_iod_designations | IoD designated directors — CFInstD, CMInstD, CDir, MInstD credentials on NZX boards | | get_board_skills_matrix | Board skills matrix — 12 IoD NZ/ASX categories, gap analysis, diversity score | | get_research_briefing | Investment research briefing — 15+ data sources, AI narrative, 4 templates (general/thesis/DD/board) | | get_fund_votes | Fund manager voting records — Harbour, Devon, Mint, Fisher, NZ Super Fund. FOR/AGAINST/ABSTAIN per resolution | | get_deal_advisers | Deal advisers — law firms, investment banks, valuers who advised on capital raises and takeovers | | get_company_directorships | Full directorship history from NZ Companies Register — NZX + private companies, status, failure rate | | get_director_workload | Workload analysis — NZX board seats, Companies Office roles, overboarding risk, attendance, tenure | | get_director_network | Cross-directorship and board interlock analysis — company, director, or NZX-wide mode | | get_board_pipeline | Directors who recently freed up capacity — resignations, retirements, available talent for recruitment | | get_financials_xbrl | Machine-readable iXBRL income/balance/cash-flow with IFRS taxonomy tags. 116 companies, FY2010-2025 | | get_esg_xbrl | Machine-readable NZ CS 1-3 tagged ESG/climate disclosure — Scope 1/2/3 emissions, diversity, safety, GRI/TCFD/SBTi/SDG | | get_announcement_sentiment | AI-scored sentiment (-1 to +1) for NZX announcements with confidence, hedging, buried risks, guidance direction | | get_ir_quality | IR disclosure quality score (0-100) — 5 dimensions: Timeliness, Completeness, Readability, Frequency, Governance Transparency | | get_peer_mentions | Cross-company references extracted from 62,000+ NZX announcements — who mentions whom, with context snippets | | get_political_connections | MP interests, political donors, and party donations linked to an NZX company or its directors | | get_management_team | Current C-suite (CEO/CFO/COO/CTO/etc.) with roles, tenure, biographies. 127 issuers, 508 executives | | get_beneficial_ownership | See through custodian nominees to fund managers behind NZX shareholdings. 56 fund managers, KiwiSaver/ETF/sovereign | | get_substantial_holder_notices | Classified SPH notices with extracted holders, %, direction (increase/decrease/initial/ceased). 9,700+ notices | | get_corporate_giving | Corporate donations, sponsorships, community investment — recipients, amounts, types, charity cross-links | | get_property_portfolio | REIT/property-company portfolios — addresses, book values, cap rate, WALE, occupancy, tenants, dev pipeline | | get_fair_value | Estimated fair value per share via DCF + Dividend Discount + EV/EBITDA models. Estimate, not a target price | | get_governance_scorecard | Per-company governance scorecard — 15 NZSA/NZX-aligned policy areas with RAG ratings and overall 0-100 score | | check_insolvency_status | MBIE Insolvency Register lookup — bankruptcy, no-asset procedures, summary instalment orders by person slug |

Setup

1. Get an API Key

Get your free API key at nzxplorer.co.nz/developers.

2. Configure Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

Using npx (recommended):

{
  "mcpServers": {
    "nzxplorer": {
      "command": "npx",
      "args": ["-y", "nzxplorer-mcp"],
      "env": {
        "NZXPLORER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Using local install:

{
  "mcpServers": {
    "nzxplorer": {
      "command": "node",
      "args": ["/absolute/path/to/nzxplorer-mcp-server/build/index.js"],
      "env": {
        "NZXPLORER_API_KEY": "your_api_key_here"
      }
    }
  }
}

2b. Or Configure Cursor

Add to Cursor's MCP settings (.cursor/mcp.json in your project or global config):

{
  "mcpServers": {
    "nzxplorer": {
      "command": "npx",
      "args": ["-y", "nzxplorer-mcp"],
      "env": {
        "NZXPLORER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Example Prompts

Once connected, you can ask Claude things like:

• "What are the top governance-rated companies on the NZX?"
• "Show me Air New Zealand's board of directors and their backgrounds"
• "Get Fisher & Paykel Healthcare's stock price for the last 30 days"
• "Search for dividend announcements from Spark in 2025"
• "Which NZX companies have a governance score below 50?"
• "Show me the biggest insider trades on the NZX this month"
• "Who is buying shares in Ryman Healthcare?"
• "What is the CEO of FPH paid? Show their executive compensation"
• "Screen for undervalued stocks: PE under 15 with dividend yield above 4%"
• "Find oversold NZX stocks with RSI below 30"
• "Which stocks have a golden cross signal right now?"
• "Show me Air New Zealand's financial performance over the last 5 years"
• "Are there any red flags or anomalies on the NZX right now?"
• "What market events happened this week?"
• "Any insider trading clusters or governance concerns for Fletcher Building?"
• "How should I vote at the Air New Zealand AGM?"
• "Get the proxy advisory report for Mercury NZ"
• "What are the voting recommendations for Spark's resolutions?"
• "Analyze the board composition of Fisher & Paykel Healthcare"
• "What is the succession risk for Air New Zealand's board?"
• "Who recently joined or left the board at Fletcher Building?"

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | NZXPLORER_API_KEY | Yes | Your API key from nzxplorer.co.nz/developers | | NZXPLORER_API_URL | No | Override API base URL (default: https://nzxplorer.co.nz) |

Data Coverage

| Data | Records | Coverage | |------|---------|----------| | Companies | 130 | All NZX-listed issuers | | Directors | 1,300+ | Current and historical board members | | Stock Prices | 162,000+ | Daily OHLCV, updated daily | | Governance Scores | 130 | GRS v2.0 — 6 components, 0-100 scale | | Announcements | 64,000+ | Full NZX archive 2017-2026 | | Insider Trades | 4,100+ | Director share transactions | | Executive Compensation | 491 | CEO/CFO pay packages with STI/LTI | | Shareholders | 2,400+ | Top 20 + substantial holders | | Dividends | 1,184 | Per-dividend records with imputation data | | Earnings | 389 | Structured results from NZX PDFs | | Financial Metrics | 367 | 41 ratios across 116 companies | | Technical Signals | 127 | SMA, RSI, golden/death cross, updated daily | | Screener | 87+ columns | 12 presets, custom filters, all companies |

Rate Limits

| Tier | Requests/min | |------|-------------| | Free | 10 | | Pro | 100 | | Enterprise | 500 |

License

MIT