Nzxplorer MCP Server

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, 30 read-only tools, 30 calls/hour 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 55-tool set with an API key (free at nzxplorer.co.nz/developers):

After install, set NZXPLORER_API_KEY from your NZXplorer Settings → API & Developer page.

Quick Install (npm)

npx nzxplorer-mcp

Or install globally:

npm install -g nzxplorer-mcp

Available Tools (58)

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

Data Coverage

Rate Limits

License

MIT