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 分

    请在仓库或注册中心条目中声明许可证。