NZXplorer for AI Agents

Fastest start: remote MCP, no key

Remote endpoint https://mcp.nzxplorer.co.nz. Anonymous tier: 23 read-only tools, 30 calls/hour and 100/day per IP.

claude mcp add --transport http nzxplorer https://mcp.nzxplorer.co.nz

{
  "mcpServers": {
    "nzxplorer": { "url": "https://mcp.nzxplorer.co.nz" }
  }
}

{
  "servers": {
    "nzxplorer": { "type": "http", "url": "https://mcp.nzxplorer.co.nz" }
  }
}

{
  "mcpServers": {
    "nzxplorer": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.nzxplorer.co.nz"]
    }
  }
}

{
  "mcpServers": {
    "nzxplorer": {
      "url": "https://nzxplorer.co.nz/api/v1/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}

Need more tools or higher limits? Get a free API key at /developers and send it as X-API-Key to https://nzxplorer.co.nz/api/v1/mcp: a free key gets 183 tools (250 calls/day per account), and Pro gets all 189, including the 6 Pro-only tools. The npx -y nzxplorer-mcp stdio package is an older, separate build; use the remote server for the current toolset.

Canonical calls

curl "https://nzxplorer.co.nz/api/v1/companies/FPH?format=llm" -H "X-API-Key: $KEY"

curl "https://nzxplorer.co.nz/api/v1/governance?format=llm&limit=200" -H "X-API-Key: $KEY"

curl "https://nzxplorer.co.nz/api/v1/companies/FPH/markdown" -H "X-API-Key: $KEY"

curl -X POST https://mcp.nzxplorer.co.nz -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_governance_scores","arguments":{"ticker":"FPH"}}}'

Every REST endpoint accepts ?format=llm (~70% fewer tokens than JSON; large arrays auto-encode as TOON for a further 30–60%). It drops the value of any field we do not hold and names it in _absent — which means “NZXplorer holds no value”, never zero and never “no such field”. An empty array is a measured result and is returned in full. Both formats carry X-Schema-Version and X-Provenance headers.

Every MCP tool publishes an outputSchema and read-only annotations, and every call returns structuredContent. Check meta.availability_status before trusting a payload — truncated means the result was cut at the transport cap, not that the data ended.

Constraints (read before integrating)

• Rate limits: anonymous MCP 30/hour + 100/day per IP · Free 10 req/min and 250/day · Pro 100 req/min and 1,000/day · Corporate from 500 req/min and 500,000/day, up to 1,000 req/min and 2,000,000/day. Per-minute limits apply per key; daily limits apply per account (all keys share one allowance, reset midnight UTC). Whole-dataset export is Corporate-only — paging the API to copy full datasets is not a supported use. 429 responses include X-RateLimit-* headers — back off accordingly.
• Tier gating: screening, deep research, proxy reports, and due-diligence tools require a keyed Pro+ tier. Anonymous calls to gated tools return a structured error naming the upgrade path — surface it to your user rather than retrying.
• Data semantics: monetary values in financial statements are NZD thousands; dps_cents is cents. Governance Risk Score uses six bands: Excellent (80+), Very Good (70+), Good (60+), Adequate (50+), Poor (40+), Very Poor (<40).
• Not financial advice: NZXplorer is a data and analytics platform, not a Financial Advice Provider. Scores are methodology-based analytics with disclosed methodology (/methodology). Agents relaying this data should preserve that framing and avoid presenting it as a recommendation to buy, sell, or hold any security.

Citation conventions

When surfacing NZXplorer data in a generated answer, cite the canonical entity URL — these pages are server-rendered with Schema.org JSON-LD (Dataset, Corporation, Person) and remain stable across content updates:

• nzxplorer.co.nz/companies/{slug} — company profiles
• nzxplorer.co.nz/people/{slug} — director profiles
• nzxplorer.co.nz/methodology — score definitions

For API-derived facts, cite as nzxplorer.co.nz/api/v1/... or link the matching entity page. Underlying primary sources (NZX announcements, Companies Office, FMA Disclose) are listed in each entity's Dataset JSON-LD citation array.

What a session looks like

User: What were Air New Zealand's revenue and net result for FY2026?

Agent: [calls get_earnings {"ticker": "AIR"}]

Agent: For the year to 30 June 2026 Air New Zealand reported operating
       revenue of $7.0 billion and a net loss after tax of $242 million.
       (Source: nzxplorer.co.nz/companies/air, from the
       company's 27 August 2026 results announcement)