NZXplorer MCP Server
Use this MCP server to query and analyze New Zealand stock market data through natural language, with 58 tools covering companies, governance, financials, trading activity, and market intelligence.
Query NZX companies, directors, management teams, board composition, skills matrices, networks, workload, appointments, and compensation benchmarks.
Retrieve stock prices, performance, technical signals, dividends, earnings, financial statements, XBRL/ESG data, revenue segments, capital raises, takeovers, credit ratings, and accounting quality.
Search 64,000+ announcements with keyword, semantic, sentiment, risk-language, IR-quality, and keyword-trend tools.
Analyze insider trades, substantial holder notices, beneficial ownership, fund voting records, political connections, peer mentions, and corporate giving.
Screen stocks with 87+ metrics and presets; get fair value estimates, governance scores/scorecards, anomalies, proxy voting recommendations, market signals, and daily market wraps.
Run due diligence with director reports, insolvency checks, historical officer timelines, research briefings, stewardship reports, voting policies, and alert subscriptions (some Enterprise-tier).
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@NZXplorer MCP Server What's the latest stock price for FBU?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
NZXplorer MCP Server
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:
{ "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):
Client | Install |
Cursor | Add to Cursor (deeplink) |
VS Code | Add to VS Code (deeplink) |
Claude Code |
|
Claude Desktop / Windsurf / Goose |
|
Any client (Smithery) |
After install, set NZXPLORER_API_KEY from your NZXplorer Settings → API & Developer page.
Related MCP server: AlphaVantage MCP Server
Quick Install (npm)
npx nzxplorer-mcpOr install globally:
npm install -g nzxplorer-mcpAvailable Tools (58)
Tool | Description |
| List NZX companies with search and sector filters |
| Company detail by ticker — optionally include directors, financials, governance score, latest price |
| Search directors by name or filter by company |
| Director profile with biography, appointments, insider trades, board fees, and executive compensation |
| Daily OHLCV price data with date range and lookback filters |
| Governance Risk Scores (0-100) for all 130 NZX companies across 6 components |
| Full-text search across 64,000+ NZX announcements (2017-2026) |
| Director share transactions — buys, sells, exercises. Filter by ticker, director, date, type |
| Normalized financial statements — income, balance sheet, cash flow, ratios. FY2010-2025 |
| Structured earnings results — revenue, profit, EPS, guidance. Extracted from NZX PDFs |
| Dividend history — DPS, imputation, DRP, payment dates. Plus dividend safety metrics |
| Technical indicators — SMA-50/100/200, RSI-14, golden/death cross, volume ratios |
| Screen stocks using 87+ metrics, 12 smart presets, and custom filters (e.g. PE<15, RSI<30) |
| Stock performance — returns (1D-5Y), alpha vs NZX50, volatility, beta, 52-week range |
| Comprehensive director due diligence report — 8 tables, 11 sections |
| Market Intelligence Feed — 10 signal types, unified event stream across all NZX companies |
| Anomaly detection — 12 types across 5 categories (insider, governance, financial, market, AGM) |
| Proxy advisory voting recommendations — FOR/AGAINST/REFER per AGM resolution with 34 rules, 8 policy presets |
| M&A and takeover activity — 313 deals, 51 issuers, 11 deal types (2017-2026) |
| Board changes — appointments, resignations, retirements. 1,242 changes across 105 issuers |
| Board composition analytics — independence, diversity, tenure, skills, succession risk, peer comparison |
| Accounting quality scores — Beneish M-score, Piotroski F-score, Altman Z-score, interest coverage, current ratio, overall rating |
| Credit ratings from S&P, Moody's, Fitch, AM Best — rating, outlook, action, history |
| Risk language scoring — 8 categories (going concern, covenant, litigation, etc.) across 64K+ announcements |
| Keyword frequency trends across NZX announcements — like Google Trends for corporate filings |
| List FMA-compliant stewardship/voting-record reports (Enterprise) |
| Full stewardship report detail with per-company resolution analysis (Enterprise) |
| List custom voting policies for the proxy advisory engine (Enterprise/Institutional) |
| Revenue segment breakdown — IFRS 8 operating, geographic, product segments |
| List alert subscriptions — 11 signal types, 6 anomaly categories, HMAC-SHA256 webhooks (Enterprise) |
| Capital raise history — 11,088 events across 130 issuers (placements, rights, SPPs, buybacks, DRPs) |
| AI semantic search across 64K+ announcements — hybrid keyword+vector+reranking |
| IoD designated directors — CFInstD, CMInstD, CDir, MInstD credentials on NZX boards |
| Board skills matrix — 12 IoD NZ/ASX categories, gap analysis, diversity score |
| Investment research briefing — 15+ data sources, AI narrative, 4 templates (general/thesis/DD/board) |
| Fund manager voting records — Harbour, Devon, Mint, Fisher, NZ Super Fund. FOR/AGAINST/ABSTAIN per resolution |
| Deal advisers — law firms, investment banks, valuers who advised on capital raises and takeovers |
| Full directorship history from NZ Companies Register — NZX + private companies, status, failure rate |
| Workload analysis — NZX board seats, Companies Office roles, overboarding risk, attendance, tenure |
| Cross-directorship and board interlock analysis — company, director, or NZX-wide mode |
| Directors who recently freed up capacity — resignations, retirements, available talent for recruitment |
| Machine-readable iXBRL income/balance/cash-flow with IFRS taxonomy tags. 116 companies, FY2010-2025 |
| Machine-readable NZ CS 1-3 tagged ESG/climate disclosure — Scope 1/2/3 emissions, diversity, safety, GRI/TCFD/SBTi/SDG |
| AI-scored sentiment (-1 to +1) for NZX announcements with confidence, hedging, buried risks, guidance direction |
| IR disclosure quality score (0-100) — 5 dimensions: Timeliness, Completeness, Readability, Frequency, Governance Transparency |
| Cross-company references extracted from 62,000+ NZX announcements — who mentions whom, with context snippets |
| MP interests, political donors, and party donations linked to an NZX company or its directors |
| Current C-suite (CEO/CFO/COO/CTO/etc.) with roles, tenure, biographies. 127 issuers, 508 executives |
| See through custodian nominees to fund managers behind NZX shareholdings. 56 fund managers, KiwiSaver/ETF/sovereign |
| Classified SPH notices with extracted holders, %, direction (increase/decrease/initial/ceased). 9,700+ notices |
| Corporate donations, sponsorships, community investment — recipients, amounts, types, charity cross-links |
| REIT/property-company portfolios — addresses, book values, cap rate, WALE, occupancy, tenants, dev pipeline |
| Estimated fair value per share via DCF + Dividend Discount + EV/EBITDA models. Estimate, not a target price |
| Per-company governance scorecard — 15 NZSA/NZX-aligned policy areas with RAG ratings and overall 0-100 score |
| MBIE Insolvency Register lookup — bankruptcy, no-asset procedures, summary instalment orders by person slug |
| Full historical officer timeline for a company — every director + executive who ever held a role, with start/end dates, tenure, committees, status |
| P10/P25/P50/P75/P90 compensation percentiles for a role (CEO/CFO/COO/Chair/Director/etc.) across NZX, with sector + market-cap-tier breakdowns |
| Daily 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):
{
"mcpServers": {
"nzxplorer": {
"command": "npx",
"args": ["-y", "nzxplorer-mcp"],
"env": {
"NZXPLORER_API_KEY": "your_api_key_here"
}
}
}
}Using local install:
{
"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):
{
"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
Variable | Required | Description |
| Yes | Your API key from nzxplorer.co.nz/developers |
| No | Override API base URL (default: |
Data Coverage
Data | Records | Coverage |
Companies | 130 | All NZX-listed issuers |
Directors | 1,300+ | Current and historical board members |
Stock Prices | 162,000+ | Daily OHLCV, updated daily |
Governance Scores | 130 | GRS v2.0 — 6 components, 0-100 scale |
Announcements | 64,000+ | Full NZX archive 2017-2026 |
Insider Trades | 4,100+ | Director share transactions |
Executive Compensation | 491 | CEO/CFO pay packages with STI/LTI |
Shareholders | 2,400+ | Top 20 + substantial holders |
Dividends | 1,184 | Per-dividend records with imputation data |
Earnings | 389 | Structured results from NZX PDFs |
Financial Metrics | 367 | 41 ratios across 116 companies |
Technical Signals | 127 | SMA, RSI, golden/death cross, updated daily |
Screener | 87+ columns | 12 presets, custom filters, all companies |
Rate Limits
Tier | Requests/min |
Free | 10 |
Pro | 100 |
Enterprise | 500 |
License
MIT
Available Tools
58 toolscheck_insolvency_statusAInspect
Check insolvency/bankruptcy history for any person in the NZXplorer database. Queries the MBIE Insolvency Register for bankruptcy, no-asset procedures, and summary instalment orders. Returns TTL-filtered records per MBIE Agreement cl 4.5-4.6. Use when asked about a person's insolvency history, bankruptcy status, financial fitness to serve as director, or due diligence screening.
Inputs: slug (required).
get_accounting_qualityAInspect
Get accounting quality scores for an NZX company. Shows Beneish M-score (earnings manipulation probability, >-1.78 suggests manipulation), Piotroski F-score (financial strength 0-9, higher is better), Altman Z-score (bankruptcy risk: >2.99 safe, 1.81-2.99 grey zone, <1.81 distress), plus interest coverage, current ratio, and overall composite score (0-100). 128 issuers scored. Use for 'is [company] at risk of manipulation?', 'financial health of [company]', 'bankruptcy risk', 'accounting quality'.
Inputs: ticker (required), year, limit.
get_announcement_sentimentAInspect
Get AI-scored sentiment analysis of NZX company announcements. Returns per-announcement sentiment scores (-1 to +1), confidence levels, hedging analysis, buried risks, key topics, and guidance direction. Includes company-level summary with average score, sentiment breakdown, and overall rating. Use for 'sentiment on [company] announcements', 'what is the tone of [ticker] filings', 'buried risks in [company] announcements', 'announcement sentiment', 'hedging language'.
Inputs: ticker (required), to, from, limit, +2 more.
get_anomaliesAInspect
Detect unusual patterns and red flags across NZX companies. Scans 12 anomaly types across 5 categories: insider trading (clusters, exodus, conviction shifts), governance (GRS deterioration, director exodus, audit changes), financial (dividend cut risk, capital raise patterns, earnings concerns), market (technical breakdowns/breakouts), and AGM (shareholder revolts). Returns anomalies sorted by severity. Use for 'any red flags?', 'governance concerns for [company]?', 'insider trading anomalies'.
Inputs: days, sector, ticker, category, +1 more.
get_beneficial_ownershipAInspect
Get beneficial ownership intelligence for an NZX company. Sees through custodian nominees (HSBC, BNP Paribas, Citibank) to identify actual fund managers behind NZX shareholdings. Returns fund manager positions, custodian mappings, and fund holdings from factsheet data. 56 fund managers tracked, covering ETF providers, KiwiSaver managers, sovereign wealth funds, and international institutional investors. Use for 'who owns [company]?', 'beneficial ownership', 'which fund managers hold [ticker]?', 'institutional ownership', 'custodian nominees'.
Inputs: ticker (required).
get_board_changesAInspect
Get board changes (director appointments, resignations, retirements, removals) for an NZX company. 1,242 changes across 105 issuers (2017-2026). Shows director name, action, role, effective date, who they replaced, reason for departure, and linked director profile. Use for 'who joined/left the board?', 'recent director changes at [company]', 'board turnover history'.
Inputs: ticker (required), to, from, limit, +1 more.
get_board_composition_reportAInspect
Get a comprehensive board composition analytics report for an NZX company. Analyzes board independence vs NZX Code requirements, gender diversity vs 30% target, tenure distribution with 9-year limit flags, skills matrix with gap identification, meeting attendance, director fee benchmarking, CEO pay ratio, succession risk scoring (low/medium/high/critical), board turnover rates, and peer comparison against sector averages. Returns automated risk flags across 10 categories. Use for 'board composition for [company]', 'governance quality analysis', 'succession risk', 'board diversity metrics', or 'nomination committee report'.
Inputs: ticker (required).
get_board_pipelineAInspect
Directors who have recently freed up board capacity — resignations, retirements, and reduced workloads in the last 12 months. Returns departed directors with their remaining board count, skills, qualifications, and departure details. Use for board recruitment, candidate identification, or talent pipeline analysis.
Inputs: limit, skill, sector.
get_board_skills_matrixAInspect
Get the board skills matrix for an NZX company. Shows per-director skills across 12 IoD NZ/ASX CGC categories (finance, legal, technology, industry, governance, risk, strategy, HR, sustainability, digital, international, marketing), board-level gap analysis (critical/single_point/depth_gap/adequate), and diversity score. Use for 'board skills at [company]', 'skills matrix', 'board gaps', 'director competencies', 'governance capability'.
Inputs: ticker (required).
get_capital_raisesAInspect
Get capital raise history for an NZX company. 11,088 events across 130 issuers. Includes placements, rights issues, SPPs, IPOs, bonds, buybacks, DRPs, options exercises, employee schemes, and conversions. Returns shares issued, price, total amount (NZD), discount %, dilution %, purpose. Use for 'capital raises for [company]', 'how much has [company] raised?', 'buyback history', 'dilution risk'.
Inputs: ticker (required), type, year, limit, +1 more.
get_companiesAInspect
List NZX-listed companies. Returns ticker, name, sector, market cap for 130 companies on the New Zealand Stock Exchange.
Inputs: limit, search, sector.
get_companyAInspect
Get detailed information about a specific NZX company by ticker symbol. Optionally include directors, financials, governance score, and latest stock price.
Inputs: ticker (required), include.
get_company_directorshipsAInspect
Get full directorship history for any person from the NZ Companies Register. Shows all company roles (NZX-listed + private companies), current and historical, with company status (active/struck off/liquidating) and failure rate analysis. Use when asked about a person's full board network, private company roles, directorship workload, or company failure history.
Inputs: slug (required).
get_compensation_benchmarkAInspect
Get compensation percentile benchmarking for a specific executive or board role across all NZX companies. Returns P10/P25/P50/P75/P90 percentiles, mean, min, max, plus breakdowns by sector and market-cap tier (micro/small/mid/large). Use for questions about market pay rates, peer-comparison benchmarks, whether a company overpays or underpays for a role, or due-diligence on remuneration committee decisions.
Inputs: role (required), year, sector, market_cap.
get_corporate_givingAInspect
Get corporate donations, sponsorships, and community investment for an NZX company. Shows recipients, amounts, donation types (cash/sponsorship/community_investment/grant/in-kind), foundation name, and total community investment. Cross-linked to registered charities where possible. Use for 'what charities does [company] support?', 'corporate giving', 'community investment', 'sponsorship', 'donations by [ticker]'.
Inputs: ticker (required).
get_credit_ratingsAInspect
Get credit rating history for an NZX company. Shows S&P, Moody's, Fitch, AM Best, Equifax ratings with upgrades, downgrades, outlook changes, and rating actions. ~80 ratings across ~20 NZX issuers (mainly banks, utilities, large caps). Use for 'credit rating for [company]', 'has [company] been downgraded?', 'investment grade NZX companies'.
Inputs: ticker (required), year, limit, action, +1 more.
get_daily_market_wrapAInspect
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 an AI-generated narrative summary. Use for questions about today's NZX market, overall market conditions, what happened across the NZX, or weekly market summary.
Inputs: days.
get_deal_advisersAInspect
Get professional advisers (law firms, investment banks, valuers) who advised on capital raises and takeovers for an NZX company. Shows which firms acted as legal counsel, underwriter, lead manager, independent adviser, or valuer on each deal. Includes deal details (amount, type, date) and adviser roles. Use for deal intelligence, adviser league tables, or capital markets analysis.
Inputs: ticker (required), role, deal_type.
get_directorAInspect
Get a detailed profile of a specific NZX director by their URL slug. Includes biography, board appointments, and optionally insider trades and remuneration history.
Inputs: slug (required), include.
get_director_due_diligenceAInspect
Get a comprehensive due diligence report for any NZX director. Aggregates all board positions (with GRS scores), overboarding assessment, remuneration across all boards with peer percentile, executive compensation, insider trading activity summary, AGM election voting record, governance contribution analysis, stock performance during tenure, and automated risk flags. Designed for executive search firms, law firms, and nominating committees assessing board candidates.
Inputs: slug (required).
get_director_networkAInspect
Cross-directorship and board interlock analysis with 3 modes: (1) company mode (?ticker=AIR) — shows all directors' external boards and shared entities, (2) director mode (?director=joan-withers) — person-centric 1-hop network, (3) network mode (no params) — NZX-wide cross-directorship map. Returns nodes, edges, and interlock metrics.
Inputs: ticker, director, include_historical.
get_directorsBInspect
List directors of NZX-listed companies. Search by name or filter by company ticker. Returns name, roles, appointment dates.
Inputs: limit, search, company, current.
get_director_workloadAInspect
Get workload analysis for a director — current NZX board seats, active Companies Office directorships, overboarding risk level (low/average/elevated/high), board meeting attendance rate, tenure at each board, and chair/committee roles. Use for overboarding checks, governance due diligence, or board capacity assessment.
Inputs: slug (required).
get_dividendsAInspect
Get dividend history for an NZX company. Returns ex-date, record date, payment date, DPS (cents), imputation %, supplementary dividends, DRP availability, and dividend safety metrics. 1,184 records across 102 companies.
Inputs: ticker (required), type, year, limit.
get_earningsAInspect
Get structured earnings results for an NZX company. Extracted from full-year (FLLYR) and half-year (HALFYR) announcement PDFs. Returns revenue, net profit, EBITDA, EBIT, EPS, dividends per share, guidance, and prior period comparisons. All monetary values in NZD thousands.
Inputs: ticker (required), year, limit, period.
get_esg_xbrlAInspect
Get machine-readable NZ Climate Standards (NZ CS 1-3) tagged ESG/climate disclosure for an NZX company. Returns XRB Aotearoa taxonomy-tagged emissions (Scope 1/2/3 GHG), diversity metrics (board/SLT/employee gender), workplace safety (LTIFR/TRIFR), and reporting framework compliance (GRI, TCFD, SBTi, SDG). Use when the user wants ESG data, climate disclosures, emissions, diversity stats, or sustainability data in structured format.
Inputs: ticker (required), year.
get_fair_valueAInspect
Get estimated fair value for an NZX company using 3 valuation models: DCF (discounted cash flow), Dividend Discount Model (Gordon Growth), and EV/EBITDA relative valuation. Returns composite fair value per share, price-to-fair-value ratio, individual model outputs, confidence level, assumptions used, and methodology notes. NOTE: This is an automated estimate using standard financial models, NOT a target price or investment recommendation.
Inputs: ticker (required), discount_rate, terminal_growth.
get_financialsAInspect
Get normalized financial statements for an NZX company. Returns income statements, balance sheets, cash flow statements, and financial ratios. All monetary values in NZD thousands. 367 records across 116 companies, FY2010-2025.
Inputs: ticker (required), year, limit, statement.
get_financials_xbrlAInspect
Get machine-readable iXBRL (Inline XBRL) financial statements for an NZX company. Returns IFRS taxonomy-tagged income statements, balance sheets, cash flows, and financial ratios. Each data point is tagged with its XBRL concept (e.g. ifrs-full:Revenue), period context, and unit. 116 companies, FY2010-2025. Use when the user wants structured/machine-readable financial data, XBRL output, or data for programmatic consumption.
Inputs: ticker (required), year.
get_fund_votesAInspect
Get actual voting records from NZ fund managers (Harbour, Devon, Mint, Fisher, NZ Super Fund) for an NZX company. Shows how institutional investors voted on AGM resolutions — FOR, AGAINST, or ABSTAIN. Includes ISS recommendations and management recommendations. Use for 'how did funds vote on [company]', 'fund voting records', 'institutional votes', 'AGM voting', 'proxy votes'.
Inputs: ticker (required), vote, year, fund_manager.
get_governance_scorecardAInspect
Get a per-company governance scorecard with RAG (red/amber/green) ratings across 15 policy areas aligned with NZSA governance policies and the NZX Corporate Governance Code v1.7. Covers: remuneration disclosure, CEO rem structure, board independence, audit independence (non-audit >25% flag), director tenure (9yr threshold), board diversity (30% target), shareholder voting dissent (<75% threshold), ESG profile, capital management, takeover vulnerability, management credibility, succession readiness, audit firm tenure, director share ownership, whistleblowing. Returns overall score 0-100, individual policy assessments with scores and data. Use for 'governance scorecard for [company]', 'governance assessment', 'board governance quality', 'NZSA-aligned governance report'.
Inputs: ticker (required).
get_governance_scoresBInspect
Get Governance Risk Scores (GRS v2.0) for NZX companies. Each company scored 0-100 across 6 components: Executive Remuneration, Board Structure, Shareholder Rights, Board Effectiveness, Audit & Risk, and Remuneration Disclosure. Ratings: Excellent (80+), Very Good (70-79), Good (60-69), Adequate (50-59), Poor (40-49), Very Poor (<40). Covers all 130 NZX-listed companies.
Inputs: limit, rating, sector, max_score, +1 more.
get_insider_tradesAInspect
Get insider (director) share transactions for NZX companies. 4,100+ trades covering buy/sell/exercise transactions. Shows who is buying and selling, how much, and at what price. Filter by company ticker, transaction type, date range, or specific director.
Inputs: to, from, type, limit, +2 more.
get_iod_designationsAInspect
Get Institute of Directors (IoD) designated directors serving on NZX boards. Shows CFInstD (Chartered Fellow — highest designation), CMInstD (Chartered Member), CDir (Chartered Director), and MInstD (Member). Returns current board seats, chair status, gender, and summary statistics. Use for 'IoD directors at [company]', 'chartered directors', 'governance credentials', 'CFInstD directors', 'professional director qualifications'.
Inputs: name, limit, ticker, designation.
get_ir_qualityAInspect
Get the IR (Investor Relations) disclosure quality score for an NZX company. Scores 5 dimensions: Timeliness (OECD/NZX Rule 10.4.1), Completeness (CFA DQI/S&P T&D), Readability (Loughran-McDonald proxy), Frequency (NIRI Standards), Governance Transparency (S&P T&D/GRS v2). Composite score 0-100, rating A+ to D, trajectory improving/stable/declining. 131 issuers scored. Use for 'how good is [company] at disclosure?', 'IR quality for [company]', 'disclosure quality', 'transparency score'.
Inputs: ticker (required).
get_management_teamAInspect
Get the management team (C-suite executives) for an NZX company. Returns current CEO, CFO, COO, CTO, and other senior executives with roles, tenure, biographies, and profile links. 127 issuers covered, 508 current executives across 15 normalized roles (CEO, CFO, COO, CTO, CIO, CLO, CPO, CMO, CRO, CDO, CS, GM, VP, MD, Other). Use for 'who is the CEO of [company]?', 'management team for [ticker]', 'C-suite at [company]', 'executive leadership'.
Inputs: ticker (required), role.
get_market_signalsAInspect
Get the Market Intelligence Feed — a unified stream of all NZX market events: 10 signal types including insider trades, capital raises, dividends, earnings releases, AGM results, director changes, governance score changes, technical signals (golden/death cross, RSI extremes), credit rating changes, and auditor changes. Sorted by date descending. Use for 'what happened on the NZX today/this week?', 'any golden crosses?', 'credit rating changes?', or 'market activity for [company]'.
Inputs: days, type, limit, sector, +2 more.
get_officer_historyAInspect
Get the full historical officer timeline for an NZX company — every director and executive who has ever held a role, with start/end dates, tenure, status, and committees. Includes both board members (from director_appointments) and C-suite executives (from management_team). Each officer carries a stable permanent_id (NZX-P-NNNNNN) for cross-referencing across NZXplorer. Use for questions about past leadership, board turnover, executive churn, board refreshment, or who used to run a company.
Inputs: ticker (required), to, from, role, +2 more.
get_peer_mentionsAInspect
Get peer mentions for an NZX company — cross-company references extracted from 62,000+ NZX announcements. Shows which companies mention this ticker and which companies it references, with context snippets and network summary. Use for 'who mentions [company]?', 'business relationships for [company]', 'competitive peers', 'peer network'.
Inputs: ticker (required), direction.
get_performanceAInspect
Get stock performance metrics for an NZX company. Returns price returns (1D, 1W, 1M, 3M, 6M, 1Y, 3Y, 5Y), alpha vs NZX50 benchmark, sector alpha, volatility, beta, 52-week high/low, and market capitalization. Updated daily.
Inputs: ticker (required).
get_political_connectionsAInspect
Get political connections for an NZX company. Returns MP interests (gifts, hospitality, shareholdings, travel mentioning this company from the NZ Parliamentary Register of Interests), political donors linked to the company or its directors, and party donation records from the Electoral Commission (2019-2024). Use for 'political connections for [company]', 'which MPs are connected to [company]?', 'do any directors donate to political parties?', 'political exposure'.
Inputs: ticker (required).
get_property_portfolioAInspect
Get property portfolio data for an NZX-listed REIT or property company. Returns individual properties with addresses, book values, cap rates, WALE, occupancy, major tenants, geocoded locations, plus summary stats (total value, avg cap rate, avg WALE, avg occupancy), type/regional breakdowns, top tenants, and development pipeline. Covers ~10 property companies (KPG, ARG, PFI, VHP, IPL, SPG, CDI, GMT, PCT, APL). Use for 'property portfolio', 'REIT assets', 'commercial property', 'cap rate', 'WALE', 'occupancy', 'tenant exposure'.
Inputs: ticker (required).
get_proxy_reportAInspect
Get automated proxy advisory voting recommendations for a company's AGM resolutions. Analyses board composition, remuneration, auditor independence, capital management, constitution changes, related-party transactions, and shareholder proposals against configurable voting policies (8 presets including NZ Super Fund, ISS NZ Benchmark, Russell Investments NZ, Vanguard AU/NZ). Returns FOR/AGAINST/REFER per resolution with severity, reasoning, and data points. Use for 'how should I vote at [company] AGM?', 'proxy report for AIR', 'voting recommendations for MEL'.
Inputs: ticker (required), year, meeting_id.
get_research_briefingAInspect
Get a comprehensive investment research briefing for an NZX company. Assembles data from 15+ sources (governance, financials, insider activity, dividends, board, earnings, credit, performance, capital raises, announcements) with AI narrative synthesis. Supports 4 templates: 'general' (default), 'investment_thesis', 'due_diligence', 'board_meeting'. Use for 'research report on [company]', 'investment thesis for [ticker]', 'due diligence on [company]', 'company research briefing'.
Inputs: ticker (required), focus, template.
get_revenue_segmentsAInspect
Get revenue segment breakdown for an NZX company. Returns IFRS 8 operating, geographic, or product segment data including segment revenue, operating profit, assets (all in NZD thousands), and revenue percentage. Extracted from annual report PDFs. Use for 'revenue breakdown for [company]', 'business segments', 'divisions', 'product groups', 'geographic revenue split', 'segment analysis'. Multi-segment companies like FPH (Hospital/Homecare), MEL (Wholesale/Retail), FBU (Building Products/Construction/Distribution).
Inputs: ticker (required), type, year, limit.
get_risk_languageAInspect
Get pre-computed risk language scores for an NZX company. Scans 64,000+ announcements for 8 risk categories: going_concern, covenant, impairment, litigation, restructuring, liquidity, regulatory, force_majeure. Returns total mentions, 12-month trend, category breakdown, critical flags, first-time detections, and yearly trend. Use when asked about risk factors, going concern warnings, covenant issues, litigation exposure, or regulatory risk.
Inputs: ticker (required).
get_semantic_searchAInspect
Search 64,000+ NZX announcements using AI semantic search. Uses text-embedding-3-small vectors with hybrid keyword+semantic+reranking for best results. Finds conceptual matches that keyword search misses (e.g. 'climate risk' finds 'environmental exposure'). Returns relevance-ranked results with similarity scores and text snippets.
Inputs: q (required), to, from, type, +2 more.
get_stewardship_reportAInspect
Get full detail for a specific stewardship report by ID, including per-company resolution analysis, vote recommendations, and the policy used. Enterprise tier required.
Inputs: id (required).
get_stock_pricesAInspect
Get historical daily stock prices for an NZX company. Returns OHLCV data (open, high, low, close, volume) in NZD.
Inputs: ticker (required), to, days, from, +1 more.
get_substantial_holder_noticesAInspect
Get classified substantial holder notices (SPH) for an NZX company. Returns all substantial product holder notices with extracted holder names, percentage holdings, direction (increase/decrease/initial/ceased), and fund manager matching. 9,700+ notices classified from NZX SHINTR announcements. Use for 'substantial holders of [ticker]', 'SPH notices', 'who increased holdings in [company]?', 'recent ownership changes', 'substantial product holder movements'.
Inputs: ticker (required), limit, direction.
get_takeoversAInspect
Get M&A and takeover activity for NZX companies. 313 deals across 51 issuers (2017-2026). 11 deal types: takeover_offer, acquisition, scheme_of_arrangement, merger, asset_acquisition, property_acquisition, compulsory_acquisition, and more. Returns acquirer, target, deal type, offer price, premium, status, acceptance %, key dates, and conditions. Use for 'any takeover activity for [company]?', 'recent M&A deals', 'scheme of arrangement history'.
Inputs: ticker (required), year, status, deal_type.
get_technical_signalsAInspect
Get technical analysis indicators for an NZX company. Returns SMA-50/100/200 moving averages, RSI-14 momentum, golden/death cross signals, distance from 52-week high/low, and volume ratios. Updated daily. 127/130 companies covered.
Inputs: ticker (required).
list_alert_subscriptionsAInspect
List all alert subscriptions for the authenticated user. Each subscription filters market signals and anomalies by tickers, sectors, signal types (insider_trade, capital_raise, dividend, earnings, agm_result, director_change, grs_change, technical_signal, credit_rating, audit_change, takeover), anomaly categories (insider, governance, financial, market, agm, corporate), and severity levels — then delivers via webhook with HMAC-SHA256 signing. Enterprise tier required.
Inputs: no named parameters.
list_stewardship_reportsAInspect
List FMA-compliant stewardship/voting-record reports for the authenticated user. Returns report summaries with vote counts, compliance rates, and period dates. Enterprise tier required.
Inputs: no named parameters.
list_voting_policiesAInspect
List all custom voting policies for the authenticated user. Each policy defines threshold overrides for the proxy advisory engine (board independence, remuneration caps, tenure limits, gender diversity, etc.). Enterprise or Institutional tier required.
Inputs: no named parameters.
screen_stocksAInspect
Screen NZX stocks using 87+ financial, governance, and technical metrics. Supports 12 smart presets (value, growth, quality, dividend_at_risk, insider_buying, capital_raise_likely, ceo_pay_for_failure, governance_laggards, oversold, overbought, golden_cross, below_200ma) and custom metric filters. Returns matching companies with selected columns, sorted by any metric. Use this to find stocks matching specific criteria like 'PE under 15 with dividend yield above 5%' or 'RSI below 30'.
Inputs: q, sort, limit, order, +3 more.
search_announcementsAInspect
Search 64,000+ NZX company announcements from 2017-2026. Full-text search across announcement titles. Types include: SHINTR (insider trades), GENERAL, MKTUPDTE (market updates), SECISSUE (security issues), MEETING, DIVCASH (dividends), and 50+ more.
Inputs: to, from, type, limit, +2 more.
search_keyword_trendsAInspect
Search any keyword or phrase across 64,000+ NZX company announcements and see how often it appears over time. Returns frequency by year, sector, and top companies. Like Google Trends for corporate filings. Use for 'when did companies start talking about AI?', 'which sector mentions climate risk most?', 'how often does restructuring appear in filings?'.
Inputs: keyword (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 58 tools
Each tool targets a specific resource or analysis dimension (e.g., get_board_changes vs get_board_skills_matrix), and descriptions clearly differentiate overlapping domains like director profiles, network, and workload. No two tools appear to serve the same purpose.
The vast majority of tools follow a 'get_noun' pattern, but there are a few outliers like 'check_insolvency_status', 'screen_stocks', and 'list_*' tools, breaking strict uniformity. The pattern is still predictable and readable.
With 58 tools, the server is extremely heavy for an MCP server. While each tool appears justified for deep NZX analysis, the count far exceeds typical scoping (3-15), placing a high burden on agent selection and user understanding.
The tool surface is remarkably comprehensive, covering company profiles, financials, governance, market data, announcements, sentiment, anomalies, and more. No obvious lifecycle gaps are apparent for the stated domain of NZX company analysis.
Maintenance
Related MCP Connectors
A Model Context Protocol server exposing real-time and historical Colombo Stock Exchange (CSE) data to AI agents and LLM applications. Provides quotes and OHLCV price history, full financial statements (income, balance sheet, cash flow), pre-computed technicals (moving averages, RS ratings, volume signals), macroeconomic indicators, corporate actions, and rule-based screening across CSE stocks and sector indices, everything needed to build CSE-aware trading assistants, research tools, and market-analysis agents. This is the official MCP server of www.ceyloncharts.com
Official Intrinio MCP server. US stock prices, options and fundamentals for AI agents.
Hosted MCP server for live public-data APIs and Skills for AI agents.
Trading MCP server for AI agents, with live market data, account reads and controlled execution.
Related MCP Servers
- AlicenseBqualityDmaintenanceMCP server that provides AI assistants access to stock market data including financial statements, stock prices, and market news through a Model Context Protocol interface.112,329MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that integrates with the AlphaVantage financial data API, providing access to stock market data, technical indicators, and fundamental financial information.MIT
- AlicenseAqualityCmaintenanceProvides structured financial market data (stocks, ETFs, mutual funds, fundamentals, market indicators) to AI systems via MCP, enabling natural language access to financial datasets with both hosted and local deployment options.31277 npm2ISC
- AlicenseAqualityDmaintenanceAn MCP server that gives AI assistants direct, structured access to China A-share market data.3Apache 2.0