io. github. mambaventures/ nzxplorer-mcp
by mambaventures · remote · local (npm) · no sign-in to list tools · v1.36.0 · published by GitHub user mambaventures
NZX (New Zealand stock exchange) data: governance scores, financials, insider trades, boards
23 tools: 1 change things and 22 only read.
Scanned Oct 21, 2026
- Deletes or cancels0Claude Code: deny
- Can't be undone0Claude Code: ask
- Changes things1Claude Code: ask: see these tools
- Only reads22Claude Code: allow: see these tools
1 check matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.
claude mcp add --transport http nzxplorer https://mcp.nzxplorer.co.nzFindings
Matches of fixed checks, with the text they matched.
- Warnget_financials
The server marks "get_financials" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "get_financials" says "get": a word for reading.
Tools
Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.
23 tools
Changes things 1Claude Code: ask
get_financialsGet financial statements for an NZX company.1 finding
Why it is in this group
- The name "get_financials" says "get": a word for reading.
- The input takes a statement or command to run (input.statement), which can change anything it can reach.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Findings
- Warn
The server marks "get_financials" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "get_financials" says "get": a word for reading.
Description, as the server wrote it Get financial statements for an NZX company. Includes income statement, balance sheet, cash flow, and financial ratios. Filter by statement type and year range.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
- title: Get financials
Only reads 22Claude Code: allow
get_agm_resolutionsGet AGM resolution voting data for an NZX company.No findings
Why it is in this group
- The name "get_agm_resolutions" says "get": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
- title: Get agm resolutions
get_annual_reportsGet annual and interim report URLs for an NZX company.No findings
Why it is in this group
- The name "get_annual_reports" says "get": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
- title: Get annual reports
get_capital_raisesGet capital raise history for an NZX company.No findings
Why it is in this group
- The name "get_capital_raises" says "get": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
- title: Get capital raises
get_company_detailGet detailed info for a specific NZX company by ticker.No findings
Why it is in this group
- The name "get_company_detail" says "get": a word for reading.
Description, as the server wrote it Get detailed info for a specific NZX company by ticker. Can include directors, financials, governance score, and latest stock price.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
- title: Get company detail
get_credit_ratingsGet credit rating history for an NZX company.No findings
Why it is in this group
- The name "get_credit_ratings" says "get": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
- title: Get credit ratings
get_daily_market_wrapGet the daily NZX market wrap — a market-wide digest covering all active NZX issuers.No findings
Why it is in this group
- The name "get_daily_market_wrap" says "get": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
- title: Get daily market wrap
get_dividendsGet dividend history for an NZX company.No findings
Why it is in this group
- The name "get_dividends" says "get": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
- title: Get dividends
get_earningsGet earnings results for an NZX company.No findings
Why it is in this group
- The name "get_earnings" says "get": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
- title: Get earnings
get_esg_dataGet ESG (Environmental, Social, Governance) data for an NZX company.No findings
Why it is in this group
- The name "get_esg_data" says "get": a word for reading.
Description, as the server wrote it 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).
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
- title: Get esg data
get_governance_scoresGet Governance Risk Scores (GRS) for NZX companies.No findings
Why it is in this group
- The name "get_governance_scores" says "get": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
- title: Get governance scores
get_kiwisaver_holdingsGet KiwiSaver fund holdings in an NZX company.No findings
Why it is in this group
- The name "get_kiwisaver_holdings" says "get": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
- title: Get kiwisaver holdings
get_management_teamGet the management team (C-suite executives) for an NZX company.No findings
Why it is in this group
- The name "get_management_team" says "get": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
- title: Get management team
get_market_signalsGet the Market Intelligence Feed — a unified stream of all NZX market events.No findings
Why it is in this group
- The name "get_market_signals" says "get": a word for reading.
Description, as the server wrote it 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. ROUTING: this is the CROSS-MARKET FEED — use it for 'what is happening across the market' or when scanning several signal types at once. For a question about ONE dataset for ONE company, prefer the specific tool: get_capital_raises, get_agm_resolutions, get_vote_history, get_credit_ratings, get_audit_history, get_governance_scores, get_dividends, get_insider_trades. Listing a signal type here does NOT mean this is the best tool for it.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
- title: Get market signals
get_metricsGet financial metrics/ratios for NZX companies.No findings
Why it is in this group
- The name "get_metrics" says "get": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
- title: Get metrics
get_performanceGet stock performance metrics for an NZX company.No findings
Why it is in this group
- The name "get_performance" says "get": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
- title: Get performance
get_revenue_segmentsGet revenue segment breakdown for an NZX company.No findings
Why it is in this group
- The name "get_revenue_segments" says "get": a word for reading.
Description, as the server wrote it 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]".
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
- title: Get revenue segments
get_stock_pricesGet daily stock price history (OHLCV) for an NZX company.No findings
Why it is in this group
- The name "get_stock_prices" says "get": a word for reading.
Description, as the server wrote it Get daily stock price history (OHLCV) for an NZX company. Use for price trends, returns, and technical context.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
- title: Get stock prices
get_takeoversGet M&A and takeover activity for an NZX company.No findings
Why it is in this group
- The name "get_takeovers" says "get": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
- title: Get takeovers
get_technical_signalsGet technical analysis indicators for an NZX company.No findings
Why it is in this group
- The name "get_technical_signals" says "get": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
- title: Get technical signals
read_announcementRead and analyze a specific NZX announcement.No findings
Why it is in this group
- The name "read_announcement" says "read": a word for reading.
Description, as the server wrote it Read and analyze a specific NZX announcement. Extracts summary, key figures, sentiment, entities, and risk flags using AI. Provide the announcement_id (e.g. "12345") from search_announcements results. Returns cached results if previously extracted.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
- title: Read announcement
search_announcementsFull-text search across NZX market announcements (2017-present), most with extracted PDF text.No findings
Why it is in this group
- The name "search_announcements" says "search": a word for reading.
Description, as the server wrote it 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).
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
- title: Search announcements
search_companiesSearch NZX-listed companies by name or ticker.No findings
Why it is in this group
- The name "search_companies" says "search": a word for reading.
Description, as the server wrote it Search NZX-listed companies by name or ticker. Returns company list with sector, market cap. Use this to find a company ticker before calling other tools. ROUTING: a lookup step, not an answer. After resolving the ticker, CALL THE TOOL THAT ANSWERS THE QUESTION — e.g. get_credit_ratings for ratings, get_executive_compensation for pay. Do not stop after searching.
Annotations the server declares
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
- title: Search companies
This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.
Install
Pinned to version 1.36.0. Values in angle brackets are yours to fill in.
claude mcp add --transport http nzxplorer https://mcp.nzxplorer.co.nzRun in a terminal.
Claude Code permissions
Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.
{
"permissions": {
"allow": [
"mcp__nzxplorer__search_companies",
"mcp__nzxplorer__get_company_detail",
"mcp__nzxplorer__get_governance_scores",
"mcp__nzxplorer__get_metrics",
"mcp__nzxplorer__get_dividends",
"mcp__nzxplorer__get_earnings",
"mcp__nzxplorer__get_stock_prices",
"mcp__nzxplorer__search_announcements",
"mcp__nzxplorer__read_announcement",
"mcp__nzxplorer__get_agm_resolutions",
"mcp__nzxplorer__get_esg_data",
"mcp__nzxplorer__get_kiwisaver_holdings",
"mcp__nzxplorer__get_performance",
"mcp__nzxplorer__get_technical_signals",
"mcp__nzxplorer__get_credit_ratings",
"mcp__nzxplorer__get_management_team",
"mcp__nzxplorer__get_capital_raises",
"mcp__nzxplorer__get_revenue_segments",
"mcp__nzxplorer__get_takeovers",
"mcp__nzxplorer__get_market_signals",
"mcp__nzxplorer__get_annual_reports",
"mcp__nzxplorer__get_daily_market_wrap"
],
"ask": [
"mcp__nzxplorer__get_financials"
],
"deny": []
}
}Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as nzxplorer. Review it before you use it.
