Log inSubmit server
Nzxplorer MCP logo

Nzxplorer MCP

Query NZX companies, financials, prices, governance, directors, announcements, insider trades, screening metrics, and market signals over MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Nzxplorer MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "nzxplorer-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "nzxplorer-mcp"
      ],
      "env": {
        "NZXPLORER_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

nzxplorer-mcp connects MCP-compatible AI clients to NZXplorer API data for New Zealand-listed companies, directors, markets, and corporate disclosures. Its tools cover company research, normalized financials, prices, dividends, governance, insider activity, announcements, stock screening, board analysis, and risk signals. Use the remote endpoint for a no-signup read-only subset, or run the npm package with an API key for the full tool set. It fits investment research, equity screening, governance due diligence, and analysis of NZX filings.

Use cases

  • Screen NZX stocks by valuation, momentum, risk, or custom financial criteria
  • Investigate directors, board changes, insider trades, and governance scores
  • Search NZX announcements for financial, takeover, risk, or peer-company information
  • Compare company performance, dividends, financial statements, and market signals

Key features

  • NZX company, director, board, and management data
  • Financial statements, earnings, dividends, prices, and performance metrics
  • 87+ metric stock screening with presets and custom filters
  • Announcement search, sentiment, risk-language, and trend analysis
  • Governance, accounting quality, credit, anomaly, and market-signal analysis
  • Director due diligence, proxy reports, and board composition analytics

Tools58

What Nzxplorer MCP lets your agent do. Expand a tool for its parameters.

Self-reported~1.7k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

8/8 checks healthy over the last 41d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 14d ago via OSV.dev · nzxplorer-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
npm downloads84Package downloads in the last 30 days.
Last commitTodayMost recent push to the default branch.
Tools exposed58Callable tools this server registers over MCP.

How Nzxplorer MCP works

What nzxplorer-mcp does

nzxplorer-mcp exposes New Zealand Exchange data through the Model Context Protocol. It covers 130 NZX-listed companies, more than 1,300 directors, daily market prices, company announcements, financial statements, governance scores, board activity, and insider transactions.

The toolset supports both focused lookups and broader research workflows. An agent can retrieve a company by ticker, investigate a director’s appointments and compensation, compare board composition, search announcements, or screen stocks against valuation and technical criteria. Additional analysis includes accounting quality, credit ratings, risk language, takeover activity, capital raises, proxy recommendations, market signals, and anomaly detection.

How it works

The server can be used through a hosted MCP endpoint or launched locally with npm. The hosted endpoint is configured as a streamable HTTP MCP server at https://mcp.nzxplorer.co.nz; it provides 23 read-only tools without an API key, subject to request limits of 30 calls per hour and 100 calls per day per IP address.

The full installation uses the nzxplorer-mcp npm package and the NZXplorer API. An API key is supplied through the NZXPLORER_API_KEY environment variable. Data includes historical financial periods from FY2010-2025, announcements dating from 2017-2026, and historical market and corporate-action records across the supported tools.

Setup and configuration

Run the package directly with:

Terminal
npx nzxplorer-mcp

A global installation is also available:

Terminal
npm install -g nzxplorer-mcp

For a local MCP configuration, set NZXPLORER_API_KEY to a key obtained from the NZXplorer developer settings. The server has installation paths for Cursor, VS Code, Claude Code, Claude Desktop, Windsurf, and Smithery. Claude Desktop and Claude.ai can also connect to the hosted endpoint as a custom connector, while Claude Code can add it with the HTTP transport.

Tools and capabilities

  • Search and inspect NZX companies, directors, directorship histories, management teams, and beneficial ownership.
  • Retrieve OHLCV prices, returns, volatility, beta, 52-week ranges, dividends, earnings, financial statements, revenue segments, and iXBRL data.
  • Screen stocks using more than 87 metrics, preset strategies, and custom filters such as valuation or RSI thresholds.
  • Analyze governance risk, board skills, independence, diversity, tenure, succession risk, director workload, networks, and board changes.
  • Search and analyze announcements using full text, semantic search, keyword trends, sentiment, risk-language scoring, and peer mentions.
  • Review insider trades, takeovers, capital raises, credit ratings, accounting-quality scores, anomalies, market signals, and technical indicators.
  • Generate director due-diligence reports, proxy voting recommendations, research briefings, stewardship reports, and voting-policy data where the applicable account supports those capabilities.

Limitations and notes

The hosted no-key option exposes a read-only subset rather than the complete tool catalog. API-key access is needed for the full package capability, and some features are marked Enterprise or Institutional, including stewardship reports, custom voting policies, and alert-subscription data. Results reflect the NZXplorer API’s coverage and extraction methods, including financial and announcement data derived from published filings and PDFs.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Nzxplorer MCP

nzxplorer-mcp is an MCP server that connects AI clients to the NZXplorer API and New Zealand stock-market data. Its main tools query NZX companies, directors, prices, financials, announcements, governance, insider trades, stock screens, board analytics, market signals, and related corporate disclosures for research and due diligence.

Install it with `npx nzxplorer-mcp`, or use the client-specific Cursor, VS Code, Claude Code, Windsurf, Claude Desktop, or Smithery installation paths. Set `NZXPLORER_API_KEY` for the full tool set; the hosted endpoint can provide a limited read-only subset without a key.

Yes, nzxplorer-mcp works with Cursor through its MCP installation deeplink or a local npm configuration. The API-key configuration sets `NZXPLORER_API_KEY`, allowing Cursor to access the full available tool set.

Yes, the hosted endpoint supports a no-key read-only mode. Connect an MCP client to `https://mcp.nzxplorer.co.nz` for 23 tools, with limits of 30 calls per hour and 100 calls per day per IP address.

Use `screen_stocks` for screening with more than 87 metrics, 12 presets, and custom filters. Related tools include `get_performance`, `get_technical_signals`, `get_financials`, `get_dividends`, `get_earnings`, and `get_governance_scores`.

Related MCP servers

All in Finance & Fintech All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewNzxplorer MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/nzxplorer-mcp?style=directory)](https://allmcps.com/mcp/nzxplorer-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/nzxplorer-mcp"><img src="https://allmcps.com/api/badge/nzxplorer-mcp?style=directory" alt="Nzxplorer MCP on AllMCPs" /></a>