nzxplorer-mcp
Server Details
NZX (New Zealand stock exchange) data: governance scores, financials, insider trades, boards
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2024-11-05
- URL
- Repository
- mambaventures/nzxplorer-mcp-server
- GitHub Stars
- 1
- Server Listing
- NZXplorer MCP Server
- ChatGPT
- –
- Claude
- NZXplorer
TDQS
Scored across 23 tools
Most tools target a distinct data domain, and descriptions provide useful selection cues. Some ambiguity remains between get_daily_market_wrap and get_market_signals for recent market activity, while get_company_detail and the earnings/financials/metrics tools overlap with more specialized endpoints.
All tools use readable snake_case with a consistent verb_noun structure. Retrieval consistently uses get_, discovery uses search_, and read_announcement appropriately denotes opening a specific document.
The 23-tool surface is broad enough to support substantial NZX research, but it is on the heavy side and includes several narrow endpoints. Some consolidation of related financial, market-event, or company-data tools could reduce selection overhead without losing coverage.
The set comprehensively covers a read-only NZX research workflow, from company and announcement discovery through company details, filings, fundamentals, prices, governance, corporate actions, and market-wide events. Search_companies and search_announcements provide entry points into the detailed tools, and write operations are not obviously required for this domain.
Available Tools
23 toolsget_agm_resolutionsARead-onlyIdempotentInspect
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.
Inputs: ticker (required), year. Returns: data, meta, tool, schema_version
get_annual_reportsARead-onlyIdempotentInspect
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.
Inputs: ticker (required), type, year. Returns: data, meta, tool, schema_version
get_capital_raisesARead-onlyIdempotentInspect
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.
Inputs: ticker (required), type, year, limit, +1 more. Returns: data, meta, tool, schema_version
get_company_detailARead-onlyIdempotentInspect
Get detailed info for a specific NZX company by ticker. Can include directors, financials, governance score, and latest stock price.
Inputs: ticker (required), include. Returns: data, meta, tool, schema_version
get_credit_ratingsARead-onlyIdempotentInspect
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.
Inputs: ticker (required), year, limit, action, +1 more. Returns: data, meta, tool, schema_version
get_daily_market_wrapARead-onlyIdempotentInspect
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.
Inputs: days. Returns: data, meta, tool, schema_version
get_dividendsARead-onlyIdempotentInspect
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.
Inputs: ticker (required), type, year, limit. Returns: data, meta, tool, schema_version
get_earningsBRead-onlyIdempotentInspect
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.
Inputs: ticker (required), year, limit, period. Returns: data, meta, tool, schema_version
get_esg_dataBRead-onlyIdempotentInspect
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).
Inputs: ticker (required), year. Returns: data, meta, tool, schema_version
get_financialsARead-onlyIdempotentInspect
Get financial statements for an NZX company. Includes income statement, balance sheet, cash flow, and financial ratios. Filter by statement type and year range.
Inputs: ticker (required), year, limit, statement. Returns: data, meta, tool, schema_version
get_governance_scoresARead-onlyIdempotentInspect
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.
Inputs: sort, limit, order, rating, +3 more. Returns: data, meta, tool, schema_version
get_kiwisaver_holdingsARead-onlyIdempotentInspect
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.
Inputs: ticker (required), date. Returns: data, meta, tool, schema_version
get_management_teamARead-onlyIdempotentInspect
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.
Inputs: ticker (required), role. Returns: data, meta, tool, schema_version
get_market_signalsARead-onlyIdempotentInspect
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.
Inputs: days, type, limit, sector, +2 more. Returns: data, meta, tool, schema_version
get_metricsARead-onlyIdempotentInspect
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.
Inputs: mode, sort, year, limit, +3 more. Returns: data, meta, tool, schema_version
get_performanceARead-onlyIdempotentInspect
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.
Inputs: ticker (required). Returns: data, meta, tool, schema_version
get_revenue_segmentsARead-onlyIdempotentInspect
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]".
Inputs: ticker (required), type, year, limit. Returns: data, meta, tool, schema_version
get_stock_pricesARead-onlyIdempotentInspect
Get daily stock price history (OHLCV) for an NZX company. Use for price trends, returns, and technical context.
Inputs: ticker (required), to, days, from. Returns: data, meta, tool, schema_version
get_takeoversARead-onlyIdempotentInspect
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.
Inputs: ticker (required), year, limit, status, +1 more. Returns: data, meta, tool, schema_version
get_technical_signalsARead-onlyIdempotentInspect
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.
Inputs: ticker (required). Returns: data, meta, tool, schema_version
read_announcementARead-onlyIdempotentInspect
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.
Inputs: announcement_id (required). Returns: data, meta, tool, schema_version
search_announcementsARead-onlyIdempotentInspect
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).
Inputs: q, to, from, type, +2 more. Returns: data, meta, tool, schema_version
search_companiesARead-onlyIdempotentInspect
Search NZX-listed companies by name or ticker. Returns company list with sector, market cap.
Inputs: limit, search, sector. Returns: data, meta, tool, schema_version
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
SEC filings, financial statements, metrics, insider and institutional holdings as structured data
Every ASX announcement since 2018 as structured, source-linked data: raises, guidance, trades, cash.
SEC filings, insider trades, and earnings data
US company financial statements, insider trades, 13F funds and short interest, each with its filing
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceProvides access to NSE India equity research data, including securities, Nifty 50 constituents and prices, historical data, financial results, shareholding patterns, corporate actions, announcements, earnings-call transcripts, bulk/block deals, short-selling disclosures, and XBRL documents.1PolyForm Noncommercial 1.0.0
- AlicenseNot gradedqualityCmaintenanceEnables querying live Australian listed company announcements, share-issue and dilution activity, and company profiles by ticker. Supports filtering by time window, price sensitivity, and derived announcement category, returning headlines, links, and key financial and governance details.287 npmMIT
- AlicenseAqualityBmaintenanceEnables searching New Zealand company records by name, NZBN, company number, type, industry, and AEWV status, and retrieving detailed profiles with addresses, shareholders, directors, charity figures, the A-Z index, and newest companies.6MIT
- AlicenseAqualityAmaintenanceDaily stock screens, RS ratings, market breadth and group rankings for 12 markets. No API keys.9424Apache 2.0
Glama MCP Gateway
Add one secure layer between your agents and this server.