{
  "markdown": "# NZXplorer MCP Server\n\n[![Install in Cursor](https://img.shields.io/badge/Install_in-Cursor-blue?style=flat&logo=cursor)](cursor://anysphere.cursor-deeplink/mcp/install?name=nzxplorer&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm56eHBsb3Jlci1tY3AiXSwiZW52Ijp7Ik5aWFBMT1JFUl9BUElfS0VZIjoiWU9VUl9BUElfS0VZIn19)\n[![Install in VS Code](https://img.shields.io/badge/Install_in-VS_Code-007ACC?style=flat&logo=visualstudiocode)](vscode:mcp/install?%7B%22name%22%3A%22nzxplorer%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22nzxplorer-mcp%22%5D%2C%22env%22%3A%7B%22NZXPLORER_API_KEY%22%3A%22YOUR_API_KEY%22%7D%7D)\n[![Smithery](https://smithery.ai/badge/@mambaventures/nzxplorer-mcp)](https://smithery.ai/server/@mambaventures/nzxplorer-mcp)\n[![npm version](https://img.shields.io/npm/v/nzxplorer-mcp.svg)](https://www.npmjs.com/package/nzxplorer-mcp)\n\nAn [MCP (Model Context Protocol)](https://modelcontextprotocol.io) 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](https://nzxplorer.co.nz/developers).\n\nQuery 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.\n\n## One-click install\n\n**Zero signup (easiest):** point any MCP client at the remote endpoint — no API key, 30 read-only tools, 30 calls/hour per IP:\n\n```json\n{ \"mcpServers\": { \"nzxplorer\": { \"url\": \"https://mcp.nzxplorer.co.nz\" } } }\n```\n\nIn **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`.\n\nFor the full 55-tool set with an API key (free at [nzxplorer.co.nz/developers](https://nzxplorer.co.nz/developers)):\n\n| Client | Install |\n|--------|---------|\n| **Cursor** | [Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=nzxplorer&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm56eHBsb3Jlci1tY3AiXSwiZW52Ijp7Ik5aWFBMT1JFUl9BUElfS0VZIjoiWU9VUl9BUElfS0VZIn19) (deeplink) |\n| **VS Code** | [Add to VS Code](vscode:mcp/install?%7B%22name%22%3A%22nzxplorer%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22nzxplorer-mcp%22%5D%2C%22env%22%3A%7B%22NZXPLORER_API_KEY%22%3A%22YOUR_API_KEY%22%7D%7D) (deeplink) |\n| **Claude Code** | `claude mcp add nzxplorer -- npx -y nzxplorer-mcp` |\n| **Claude Desktop / Windsurf / Goose** | `npx -y @smithery/cli@latest install @mambaventures/nzxplorer-mcp --client claude` (replace `claude` with `windsurf` / `goose`) |\n| **Any client (Smithery)** | [Install via Smithery](https://smithery.ai/server/@mambaventures/nzxplorer-mcp) |\n\nAfter install, set `NZXPLORER_API_KEY` from your [NZXplorer Settings → API & Developer](https://nzxplorer.co.nz/settings?section=api) page.\n\n## Quick Install (npm)\n\n```bash\nnpx nzxplorer-mcp\n```\n\nOr install globally:\n\n```bash\nnpm install -g nzxplorer-mcp\n```\n\n## Available Tools (58)\n\n| Tool | Description |\n|------|-------------|\n| `get_companies` | List NZX companies with search and sector filters |\n| `get_company` | Company detail by ticker — optionally include directors, financials, governance score, latest price |\n| `get_directors` | Search directors by name or filter by company |\n| `get_director` | Director profile with biography, appointments, insider trades, board fees, and executive compensation |\n| `get_stock_prices` | Daily OHLCV price data with date range and lookback filters |\n| `get_governance_scores` | Governance Risk Scores (0-100) for all 130 NZX companies across 6 components |\n| `search_announcements` | Full-text search across 64,000+ NZX announcements (2017-2026) |\n| `get_insider_trades` | Director share transactions — buys, sells, exercises. Filter by ticker, director, date, type |\n| `get_financials` | Normalized financial statements — income, balance sheet, cash flow, ratios. FY2010-2025 |\n| `get_earnings` | Structured earnings results — revenue, profit, EPS, guidance. Extracted from NZX PDFs |\n| `get_dividends` | Dividend history — DPS, imputation, DRP, payment dates. Plus dividend safety metrics |\n| `get_technical_signals` | Technical indicators — SMA-50/100/200, RSI-14, golden/death cross, volume ratios |\n| `screen_stocks` | Screen stocks using 87+ metrics, 12 smart presets, and custom filters (e.g. PE<15, RSI<30) |\n| `get_performance` | Stock performance — returns (1D-5Y), alpha vs NZX50, volatility, beta, 52-week range |\n| `get_director_due_diligence` | Comprehensive director due diligence report — 8 tables, 11 sections |\n| `get_market_signals` | Market Intelligence Feed — 10 signal types, unified event stream across all NZX companies |\n| `get_anomalies` | Anomaly detection — 12 types across 5 categories (insider, governance, financial, market, AGM) |\n| `get_proxy_report` | Proxy advisory voting recommendations — FOR/AGAINST/REFER per AGM resolution with 34 rules, 8 policy presets |\n| `get_takeovers` | M&A and takeover activity — 313 deals, 51 issuers, 11 deal types (2017-2026) |\n| `get_board_changes` | Board changes — appointments, resignations, retirements. 1,242 changes across 105 issuers |\n| `get_board_composition_report` | Board composition analytics — independence, diversity, tenure, skills, succession risk, peer comparison |\n| `get_accounting_quality` | Accounting quality scores — Beneish M-score, Piotroski F-score, Altman Z-score, interest coverage, current ratio, overall rating |\n| `get_credit_ratings` | Credit ratings from S&P, Moody's, Fitch, AM Best — rating, outlook, action, history |\n| `get_risk_language` | Risk language scoring — 8 categories (going concern, covenant, litigation, etc.) across 64K+ announcements |\n| `search_keyword_trends` | Keyword frequency trends across NZX announcements — like Google Trends for corporate filings |\n| `list_stewardship_reports` | List FMA-compliant stewardship/voting-record reports (Enterprise) |\n| `get_stewardship_report` | Full stewardship report detail with per-company resolution analysis (Enterprise) |\n| `list_voting_policies` | List custom voting policies for the proxy advisory engine (Enterprise/Institutional) |\n| `get_revenue_segments` | Revenue segment breakdown — IFRS 8 operating, geographic, product segments |\n| `list_alert_subscriptions` | List alert subscriptions — 11 signal types, 6 anomaly categories, HMAC-SHA256 webhooks (Enterprise) |\n| `get_capital_raises` | Capital raise history — 11,088 events across 130 issuers (placements, rights, SPPs, buybacks, DRPs) |\n| `get_semantic_search` | AI semantic search across 64K+ announcements — hybrid keyword+vector+reranking |\n| `get_iod_designations` | IoD designated directors — CFInstD, CMInstD, CDir, MInstD credentials on NZX boards |\n| `get_board_skills_matrix` | Board skills matrix — 12 IoD NZ/ASX categories, gap analysis, diversity score |\n| `get_research_briefing` | Investment research briefing — 15+ data sources, AI narrative, 4 templates (general/thesis/DD/board) |\n| `get_fund_votes` | Fund manager voting records — Harbour, Devon, Mint, Fisher, NZ Super Fund. FOR/AGAINST/ABSTAIN per resolution |\n| `get_deal_advisers` | Deal advisers — law firms, investment banks, valuers who advised on capital raises and takeovers |\n| `get_company_directorships` | Full directorship history from NZ Companies Register — NZX + private companies, status, failure rate |\n| `get_director_workload` | Workload analysis — NZX board seats, Companies Office roles, overboarding risk, attendance, tenure |\n| `get_director_network` | Cross-directorship and board interlock analysis — company, director, or NZX-wide mode |\n| `get_board_pipeline` | Directors who recently freed up capacity — resignations, retirements, available talent for recruitment |\n| `get_financials_xbrl` | Machine-readable iXBRL income/balance/cash-flow with IFRS taxonomy tags. 116 companies, FY2010-2025 |\n| `get_esg_xbrl` | Machine-readable NZ CS 1-3 tagged ESG/climate disclosure — Scope 1/2/3 emissions, diversity, safety, GRI/TCFD/SBTi/SDG |\n| `get_announcement_sentiment` | AI-scored sentiment (-1 to +1) for NZX announcements with confidence, hedging, buried risks, guidance direction |\n| `get_ir_quality` | IR disclosure quality score (0-100) — 5 dimensions: Timeliness, Completeness, Readability, Frequency, Governance Transparency |\n| `get_peer_mentions` | Cross-company references extracted from 62,000+ NZX announcements — who mentions whom, with context snippets |\n| `get_political_connections` | MP interests, political donors, and party donations linked to an NZX company or its directors |\n| `get_management_team` | Current C-suite (CEO/CFO/COO/CTO/etc.) with roles, tenure, biographies. 127 issuers, 508 executives |\n| `get_beneficial_ownership` | See through custodian nominees to fund managers behind NZX shareholdings. 56 fund managers, KiwiSaver/ETF/sovereign |\n| `get_substantial_holder_notices` | Classified SPH notices with extracted holders, %, direction (increase/decrease/initial/ceased). 9,700+ notices |\n| `get_corporate_giving` | Corporate donations, sponsorships, community investment — recipients, amounts, types, charity cross-links |\n| `get_property_portfolio` | REIT/property-company portfolios — addresses, book values, cap rate, WALE, occupancy, tenants, dev pipeline |\n| `get_fair_value` | Estimated fair value per share via DCF + Dividend Discount + EV/EBITDA models. Estimate, not a target price |\n| `get_governance_scorecard` | Per-company governance scorecard — 15 NZSA/NZX-aligned policy areas with RAG ratings and overall 0-100 score |\n| `check_insolvency_status` | MBIE Insolvency Register lookup — bankruptcy, no-asset procedures, summary instalment orders by person slug |\n| `get_officer_history` | Full historical officer timeline for a company — every director + executive who ever held a role, with start/end dates, tenure, committees, status |\n| `get_compensation_benchmark` | P10/P25/P50/P75/P90 compensation percentiles for a role (CEO/CFO/COO/Chair/Director/etc.) across NZX, with sector + market-cap-tier breakdowns |\n| `get_daily_market_wrap` | Daily NZX market wrap — price moves, breadth (gainers/decliners), announcements, insider trades, upcoming dividends, board changes + AI narrative summary |\n\n## Setup\n\n### 1. Get an API Key\n\nGet your free API key at [nzxplorer.co.nz/developers](https://nzxplorer.co.nz/developers).\n\n### 2. Configure Claude Desktop\n\nAdd to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):\n\n**Using npx (recommended):**\n\n```json\n{\n  \"mcpServers\": {\n    \"nzxplorer\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"nzxplorer-mcp\"],\n      \"env\": {\n        \"NZXPLORER_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n**Using local install:**\n\n```json\n{\n  \"mcpServers\": {\n    \"nzxplorer\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/nzxplorer-mcp-server/build/index.js\"],\n      \"env\": {\n        \"NZXPLORER_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n### 2b. Or Configure Cursor\n\nAdd to Cursor's MCP settings (`.cursor/mcp.json` in your project or global config):\n\n```json\n{\n  \"mcpServers\": {\n    \"nzxplorer\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"nzxplorer-mcp\"],\n      \"env\": {\n        \"NZXPLORER_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n## Example Prompts\n\nOnce connected, you can ask Claude things like:\n\n- \"What are the top governance-rated companies on the NZX?\"\n- \"Show me Air New Zealand's board of directors and their backgrounds\"\n- \"Get Fisher & Paykel Healthcare's stock price for the last 30 days\"\n- \"Search for dividend announcements from Spark in 2025\"\n- \"Which NZX companies have a governance score below 50?\"\n- \"Show me the biggest insider trades on the NZX this month\"\n- \"Who is buying shares in Ryman Healthcare?\"\n- \"What is the CEO of FPH paid? Show their executive compensation\"\n- \"Screen for undervalued stocks: PE under 15 with dividend yield above 4%\"\n- \"Find oversold NZX stocks with RSI below 30\"\n- \"Which stocks have a golden cross signal right now?\"\n- \"Show me Air New Zealand's financial performance over the last 5 years\"\n- \"Are there any red flags or anomalies on the NZX right now?\"\n- \"What market events happened this week?\"\n- \"Any insider trading clusters or governance concerns for Fletcher Building?\"\n- \"How should I vote at the Air New Zealand AGM?\"\n- \"Get the proxy advisory report for Mercury NZ\"\n- \"What are the voting recommendations for Spark's resolutions?\"\n- \"Analyze the board composition of Fisher & Paykel Healthcare\"\n- \"What is the succession risk for Air New Zealand's board?\"\n- \"Who recently joined or left the board at Fletcher Building?\"\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `NZXPLORER_API_KEY` | Yes | Your API key from nzxplorer.co.nz/developers |\n| `NZXPLORER_API_URL` | No | Override API base URL (default: `https://nzxplorer.co.nz`) |\n\n## Data Coverage\n\n| Data | Records | Coverage |\n|------|---------|----------|\n| Companies | 130 | All NZX-listed issuers |\n| Directors | 1,300+ | Current and historical board members |\n| Stock Prices | 162,000+ | Daily OHLCV, updated daily |\n| Governance Scores | 130 | GRS v2.0 — 6 components, 0-100 scale |\n| Announcements | 64,000+ | Full NZX archive 2017-2026 |\n| Insider Trades | 4,100+ | Director share transactions |\n| Executive Compensation | 491 | CEO/CFO pay packages with STI/LTI |\n| Shareholders | 2,400+ | Top 20 + substantial holders |\n| Dividends | 1,184 | Per-dividend records with imputation data |\n| Earnings | 389 | Structured results from NZX PDFs |\n| Financial Metrics | 367 | 41 ratios across 116 companies |\n| Technical Signals | 127 | SMA, RSI, golden/death cross, updated daily |\n| Screener | 87+ columns | 12 presets, custom filters, all companies |\n\n## Rate Limits\n\n| Tier | Requests/min |\n|------|-------------|\n| Free | 10 |\n| Pro | 100 |\n| Enterprise | 500 |\n\n## License\n\nMIT\n",
  "bytes": 14139,
  "sha": "183626d3f151c8e3b7a514e8be06e0bb3a66eef85ff69dc47eba1af655f6233b",
  "repo_slug": "mambaventures/nzxplorer-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_mambaventures_nzxplorer_mcp_4420dfce/readme"
}