Nzxplorer Mcp

io.github.mambaventures由 GitHub 帳號 mambaventures 發布v1.36.1更新於 Oct 25, 2026

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

已驗證Streamable HTTP可網頁執行金融資料與分析

概覽

AI 產生的概覽

NZXplorer 讓助理以唯讀方式存取紐西蘭證券交易所資料：公司、財務、治理評分、董事、公告與市場訊號。

可以做什麼
  • 搜尋並檢視紐西蘭上市公司概況，包括產業、市值、經營團隊與營收分部
  • 取得財務報表、比率、業績、股利、信用評等與股價歷史
  • 檢視治理風險評分、股東會決議、董事會組成、ESG 資料與董事簡介
  • 檢索並閱讀市場公告，附 AI 摘要、情緒與風險標記
  • 篩選股票，比較表現、技術訊號、併購與募資事件
  • 取得每日市場綜述與統一的市場情報流
適用情境
適合需要助理回答紐西蘭上市公司財務、治理、董事會或公告相關問題，或直接在對話中篩選與比較紐西蘭股票的情境。
執行需求
可使用遠端端點（免金鑰，23 個唯讀工具，依 IP 限流），或在本機以 Node.js 執行 npm 套件 nzxplorer-mcp。完整工具集需要 NZXplorer API 金鑰，透過環境變數 NZXPLORER_API_KEY 提供；可選 NZXPLORER_API_URL 覆寫 API 位址。需要能連線至 NZXplorer API 的網路。
安裝前請注意
API 金鑰屬機密，經環境變數傳入，請勿寫入共用設定。遠端端點有速率限制（免費層每 IP 每小時 30 次、每天 100 次）。查詢與結果會傳送給第三方 NZXplorer 服務。工具為唯讀，但部分能力（盡職治理報告、投票政策、提醒訂閱）標示為企業版。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Nzxplorer Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.mambaventures%2Fnzxplorer-mcp/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

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

來源：README.md，提交 29ee070

工具

23

search_companies

Search companies

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

輸入參數limitsearchsector

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.

輸入參數ticker必填include

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.

輸入參數sortlimitorderratingsectormax_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.

輸入參數yearlimitticker必填statement

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.

輸入參數modesortyearlimitordersectorticker

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.

輸入參數typeyearlimitticker必填

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.

輸入參數yearlimitperiodticker必填

get_stock_prices

Get stock prices

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

輸入參數todaysfromticker必填

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

輸入參數qtofromtypelimitticker

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.

輸入參數announcement_id必填

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.

輸入參數yearticker必填

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

輸入參數yearticker必填

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.

輸入參數dateticker必填

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.

輸入參數ticker必填

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.

輸入參數ticker必填

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.

輸入參數yearlimitactionagencyticker必填

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.

輸入參數roleticker必填

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.

輸入參數typeyearlimitticker必填buybacks

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

輸入參數typeyearlimitticker必填

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.

輸入參數yearlimitstatusticker必填deal_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.

輸入參數daystypelimitsectortickersignificance

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.

輸入參數typeyearticker必填

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.

輸入參數days

版本歷史

2
  1. v1.36.1最新Oct 25, 2026
  2. v1.36.0Sep 16, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。