Nzxplorer Mcp

io.github.mambaventuresPublished by GitHub account mambaventuresv1.36.1Updated Oct 25, 2026

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

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

NZXplorer gives an assistant read-only access to New Zealand stock exchange data: companies, financials, governance scores, directors, announcements and…

What you can do
  • Search and profile NZX-listed companies, including sector, market cap, management team and revenue segments
  • Retrieve financial statements, ratios, earnings, dividends, credit ratings and stock price history
  • Review governance risk scores, AGM resolutions, board composition, ESG data and director profiles
  • Search and read market announcements, with AI summaries, sentiment and risk flags
  • Screen stocks, compare performance, technical signals, takeovers and capital raises
  • Pull a daily market wrap and a unified market intelligence feed
When to use it
Useful when you want an assistant to answer questions about NZX-listed companies, their financials, governance, boards or filings, or to screen and compare New Zealand stocks without leaving the chat.
Requirements
Either the remote endpoint (no key, 23 read-only tools, rate-limited per IP) or the npm package nzxplorer-mcp run locally with Node.js. The full tool set needs an NZXplorer API key supplied as the NZXPLORER_API_KEY environment variable; an optional NZXPLORER_API_URL overrides the API base URL. Network access to the NZXplorer API is required.
Before you install
The API key is a secret passed in the environment; keep it out of shared configs. The remote endpoint is rate-limited (30 calls/hour, 100 calls/day per IP on the free tier). Queries and results are sent to the third-party NZXplorer service. Tools are read-only, but some listed capabilities (stewardship reports, voting policies, alert subscriptions) are marked Enterprise.

Installation

In SourceWeft

  1. Open Nzxplorer Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.mambaventures%2Fnzxplorer-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "nzxplorer": {
      "type": "http",
      "url": "https://mcp.nzxplorer.co.nz/"
    }
  }
}

README

NZXplorer MCP Server

[Install in Cursor] [Install in VS Code] [Smithery] [npm version]

An MCP (Model Context Protocol) 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.

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, 23 read-only tools, 30 calls/hour and 100 calls/day 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 tool set with an API key (free at nzxplorer.co.nz/developers):

ClientInstall
CursorAdd to Cursor (deeplink)
VS CodeAdd to VS Code (deeplink)
Claude Codeclaude mcp add nzxplorer -- npx -y nzxplorer-mcp
Claude Desktop / Windsurf / Goosenpx -y @smithery/cli@latest install @mambaventures/nzxplorer-mcp --client claude (replace claude with windsurf / goose)
Any client (Smithery)Install via Smithery

After install, set NZXPLORER_API_KEY from your NZXplorer Settings → API & Developer page.

Quick Install (npm)

bash
npx nzxplorer-mcp

Or install globally:

bash
npm install -g nzxplorer-mcp

Available Tools (58)

ToolDescription
get_companiesList NZX companies with search and sector filters
get_companyCompany detail by ticker — optionally include directors, financials, governance score, latest price
get_directorsSearch directors by name or filter by company
get_directorDirector profile with biography, appointments, insider trades, board fees, and executive compensation
get_stock_pricesDaily OHLCV price data with date range and lookback filters
get_governance_scoresGovernance Risk Scores (0-100) for all 130 NZX companies across 6 components
search_announcementsFull-text search across 64,000+ NZX announcements (2017-2026)
get_insider_tradesDirector share transactions — buys, sells, exercises. Filter by ticker, director, date, type
get_financialsNormalized financial statements — income, balance sheet, cash flow, ratios. FY2010-2025
get_earningsStructured earnings results — revenue, profit, EPS, guidance. Extracted from NZX PDFs
get_dividendsDividend history — DPS, imputation, DRP, payment dates. Plus dividend safety metrics
get_technical_signalsTechnical indicators — SMA-50/100/200, RSI-14, golden/death cross, volume ratios
screen_stocksScreen stocks using 87+ metrics, 12 smart presets, and custom filters (e.g. PE<15, RSI<30)
get_performanceStock performance — returns (1D-5Y), alpha vs NZX50, volatility, beta, 52-week range
get_director_due_diligenceComprehensive director due diligence report — 8 tables, 11 sections
get_market_signalsMarket Intelligence Feed — 10 signal types, unified event stream across all NZX companies
get_anomaliesAnomaly detection — 12 types across 5 categories (insider, governance, financial, market, AGM)
get_proxy_reportProxy advisory voting recommendations — FOR/AGAINST/REFER per AGM resolution with 34 rules, 8 policy presets
get_takeoversM&A and takeover activity — 313 deals, 51 issuers, 11 deal types (2017-2026)
get_board_changesBoard changes — appointments, resignations, retirements. 1,242 changes across 105 issuers
get_board_composition_reportBoard composition analytics — independence, diversity, tenure, skills, succession risk, peer comparison
get_accounting_qualityAccounting quality scores — Beneish M-score, Piotroski F-score, Altman Z-score, interest coverage, current ratio, overall rating
get_credit_ratingsCredit ratings from S&P, Moody's, Fitch, AM Best — rating, outlook, action, history
get_risk_languageRisk language scoring — 8 categories (going concern, covenant, litigation, etc.) across 64K+ announcements
search_keyword_trendsKeyword frequency trends across NZX announcements — like Google Trends for corporate filings
list_stewardship_reportsList FMA-compliant stewardship/voting-record reports (Enterprise)
get_stewardship_reportFull stewardship report detail with per-company resolution analysis (Enterprise)
list_voting_policiesList custom voting policies for the proxy advisory engine (Enterprise/Institutional)
get_revenue_segmentsRevenue segment breakdown — IFRS 8 operating, geographic, product segments
list_alert_subscriptionsList alert subscriptions — 11 signal types, 6 anomaly categories, HMAC-SHA256 webhooks (Enterprise)
get_capital_raisesCapital raise history — 11,088 events across 130 issuers (placements, rights, SPPs, buybacks, DRPs)
get_semantic_searchAI semantic search across 64K+ announcements — hybrid keyword+vector+reranking
get_iod_designationsIoD designated directors — CFInstD, CMInstD, CDir, MInstD credentials on NZX boards
get_board_skills_matrixBoard skills matrix — 12 IoD NZ/ASX categories, gap analysis, diversity score
get_research_briefingInvestment research briefing — 15+ data sources, AI narrative, 4 templates (general/thesis/DD/board)
get_fund_votesFund manager voting records — Harbour, Devon, Mint, Fisher, NZ Super Fund. FOR/AGAINST/ABSTAIN per resolution
get_deal_advisersDeal advisers — law firms, investment banks, valuers who advised on capital raises and takeovers
get_company_directorshipsFull directorship history from NZ Companies Register — NZX + private companies, status, failure rate
get_director_workloadWorkload analysis — NZX board seats, Companies Office roles, overboarding risk, attendance, tenure
get_director_networkCross-directorship and board interlock analysis — company, director, or NZX-wide mode
get_board_pipelineDirectors who recently freed up capacity — resignations, retirements, available talent for recruitment
get_financials_xbrlMachine-readable iXBRL income/balance/cash-flow with IFRS taxonomy tags. 116 companies, FY2010-2025
get_esg_xbrlMachine-readable NZ CS 1-3 tagged ESG/climate disclosure — Scope 1/2/3 emissions, diversity, safety, GRI/TCFD/SBTi/SDG
get_announcement_sentimentAI-scored sentiment (-1 to +1) for NZX announcements with confidence, hedging, buried risks, guidance direction
get_ir_qualityIR disclosure quality score (0-100) — 5 dimensions: Timeliness, Completeness, Readability, Frequency, Governance Transparency
get_peer_mentionsCross-company references extracted from 62,000+ NZX announcements — who mentions whom, with context snippets
get_political_connectionsMP interests, political donors, and party donations linked to an NZX company or its directors
get_management_teamCurrent C-suite (CEO/CFO/COO/CTO/etc.) with roles, tenure, biographies. 127 issuers, 508 executives
get_beneficial_ownershipSee through custodian nominees to fund managers behind NZX shareholdings. 56 fund managers, KiwiSaver/ETF/sovereign
get_substantial_holder_noticesClassified SPH notices with extracted holders, %, direction (increase/decrease/initial/ceased). 9,700+ notices
get_corporate_givingCorporate donations, sponsorships, community investment — recipients, amounts, types, charity cross-links
get_property_portfolioREIT/property-company portfolios — addresses, book values, cap rate, WALE, occupancy, tenants, dev pipeline
get_fair_valueEstimated fair value per share via DCF + Dividend Discount + EV/EBITDA models. Estimate, not a target price
get_governance_scorecardPer-company governance scorecard — 15 NZSA/NZX-aligned policy areas with RAG ratings and overall 0-100 score
check_insolvency_statusMBIE Insolvency Register lookup — bankruptcy, no-asset procedures, summary instalment orders by person slug
get_officer_historyFull historical officer timeline for a company — every director + executive who ever held a role, with start/end dates, tenure, committees, status
get_compensation_benchmarkP10/P25/P50/P75/P90 compensation percentiles for a role (CEO/CFO/COO/Chair/Director/etc.) across NZX, with sector + market-cap-tier breakdowns
get_daily_market_wrapDaily NZX market wrap — price moves, breadth (gainers/decliners), announcements, insider trades, upcoming dividends, board changes + AI narrative summary

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

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

Using local install:

json
{  "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):

json
{  "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

VariableRequiredDescription
NZXPLORER_API_KEYYesYour API key from nzxplorer.co.nz/developers
NZXPLORER_API_URLNoOverride API base URL (default: https://nzxplorer.co.nz)

Data Coverage

DataRecordsCoverage
Companies130All NZX-listed issuers
Directors1,300+Current and historical board members
Stock Prices162,000+Daily OHLCV, updated daily
Governance Scores130GRS v2.0 — 6 components, 0-100 scale
Announcements64,000+Full NZX archive 2017-2026
Insider Trades4,100+Director share transactions
Executive Compensation491CEO/CFO pay packages with STI/LTI
Shareholders2,400+Top 20 + substantial holders
Dividends1,184Per-dividend records with imputation data
Earnings389Structured results from NZX PDFs
Financial Metrics36741 ratios across 116 companies
Technical Signals127SMA, RSI, golden/death cross, updated daily
Screener87+ columns12 presets, custom filters, all companies

Rate Limits

TierRequests/min
Free10
Pro100
Enterprise500

License

MIT

Source: README.md at commit 29ee070

Tools

23

search_companies

Search companies

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

Parameterslimitsearchsector

get_company_detail

Get company detail

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

Parameterstickerrequiredinclude

get_governance_scores

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.

Parameterssortlimitorderratingsectormax_scoremin_score

get_financials

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.

Parametersyearlimittickerrequiredstatement

get_metrics

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.

Parametersmodesortyearlimitordersectorticker

get_dividends

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.

Parameterstypeyearlimittickerrequired

get_earnings

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.

Parametersyearlimitperiodtickerrequired

get_stock_prices

Get stock prices

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

Parameterstodaysfromtickerrequired

search_announcements

Search announcements

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

Parametersqtofromtypelimitticker

read_announcement

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. Returns cached results if previously extracted.

Parametersannouncement_idrequired

get_agm_resolutions

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.

Parametersyeartickerrequired

get_esg_data

Get esg data

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

Parametersyeartickerrequired

get_kiwisaver_holdings

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.

Parametersdatetickerrequired

get_performance

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.

Parameterstickerrequired

get_technical_signals

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.

Parameterstickerrequired

get_credit_ratings

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.

Parametersyearlimitactionagencytickerrequired

get_management_team

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

Parametersroletickerrequired

get_capital_raises

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. Structured events across NZX issuers.

Parameterstypeyearlimittickerrequiredbuybacks

get_revenue_segments

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]".

Parameterstypeyearlimittickerrequired

get_takeovers

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.

Parametersyearlimitstatustickerrequireddeal_type

get_market_signals

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.

Parametersdaystypelimitsectortickersignificance

get_annual_reports

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.

Parameterstypeyeartickerrequired

get_daily_market_wrap

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.

Parametersdays

Version history

2
  1. v1.36.1LatestOct 25, 2026
  2. v1.36.0Sep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.