nzxplorer-mcp-server

# NZXplorer MCP Server

[![Install in Cursor](https://img.shields.io/badge/Install_in-Cursor-blue?style=flat&logo=cursor)](cursor://anysphere.cursor-deeplink/mcp/install?name=nzxplorer&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm56eHBsb3Jlci1tY3AiXSwiZW52Ijp7Ik5aWFBMT1JFUl9BUElfS0VZIjoiWU9VUl9BUElfS0VZIn19)
[![Install in VS Code](https://img.shields.io/badge/Install_in-VS_Code-007ACC?style=flat&logo=visualstudiocode)](vscode:mcp/install?%7B%22name%22%3A%22nzxplorer%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22nzxplorer-mcp%22%5D%2C%22env%22%3A%7B%22NZXPLORER_API_KEY%22%3A%22YOUR_API_KEY%22%7D%7D)
[![Smithery](https://smithery.ai/badge/@mambaventures/nzxplorer-mcp)](https://smithery.ai/server/@mambaventures/nzxplorer-mcp)
[![npm version](https://img.shields.io/npm/v/nzxplorer-mcp.svg)](https://www.npmjs.com/package/nzxplorer-mcp)

An [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that gives AI assistants like Claude Desktop, Cursor, VS Code, and Claude Code direct access to New Zealand stock market data via the [NZXplorer API](https://nzxplorer.co.nz/developers).

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.

## One-click install

**Zero signup (easiest):** point any MCP client at the remote endpoint — no API key, 30 read-only tools, 30 calls/hour per IP:

```json
{ "mcpServers": { "nzxplorer": { "url": "https://mcp.nzxplorer.co.nz" } } }
```

In **Claude Desktop / claude.ai**: Settings → Connectors → *Add custom connector* → paste `https://mcp.nzxplorer.co.nz`. In **Claude Code**: `claude mcp add --transport http nzxplorer https://mcp.nzxplorer.co.nz`.

For the full 55-tool set with an API key (free at [nzxplorer.co.nz/developers](https://nzxplorer.co.nz/developers)):

| Client | Install |
|--------|---------|
| **Cursor** | [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=nzxplorer&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm56eHBsb3Jlci1tY3AiXSwiZW52Ijp7Ik5aWFBMT1JFUl9BUElfS0VZIjoiWU9VUl9BUElfS0VZIn19) (deeplink) |
| **VS Code** | [Add to VS Code](vscode:mcp/install?%7B%22name%22%3A%22nzxplorer%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22nzxplorer-mcp%22%5D%2C%22env%22%3A%7B%22NZXPLORER_API_KEY%22%3A%22YOUR_API_KEY%22%7D%7D) (deeplink) |
| **Claude Code** | `claude mcp add nzxplorer -- npx -y nzxplorer-mcp` |
| **Claude Desktop / Windsurf / Goose** | `npx -y @smithery/cli@latest install @mambaventures/nzxplorer-mcp --client claude` (replace `claude` with `windsurf` / `goose`) |
| **Any client (Smithery)** | [Install via Smithery](https://smithery.ai/server/@mambaventures/nzxplorer-mcp) |

After install, set `NZXPLORER_API_KEY` from your [NZXplorer Settings → API & Developer](https://nzxplorer.co.nz/settings?section=api) page.

## Quick Install (npm)

```bash
npx nzxplorer-mcp
```

Or install globally:

```bash
npm install -g nzxplorer-mcp
```

## Available Tools (58)

| 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 |
| `get_officer_history` | Full historical officer timeline for a company — every director + execut