nzxplorer-mcp
NZX (New Zealand stock exchange) data: governance scores, financials, insider trades, boards
使うべきか
品質と安全性
A
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
~12,511トークン数（ツール定義）
~5.6 KB一般的なレスポンスサイズ
注意への影響は大きい（128k コンテキストの 9.77%）
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"nzxplorer-mcp": {
"command": "npx",
"args": [
"nzxplorer-mcp"
]
}
}
}実行可能なパッケージ
npmnzxplorer-mcp
1.36.0stdioリモートエンドポイント
https://mcp.nzxplorer.co.nzstreamable-httpできること
ツール一覧
ツール（23）
🟢 読み取り専用🟡 書き込み🔴 削除⚪ 不明
🟢search_companies(search, sector, limit)
Search NZX-listed companies by name or ticker. Returns company list with sector, market cap. Use this to find a company ticker before calling other tools. ROUTING: a lookup step, not an answer. After resolving the ticker, CALL THE TOOL THAT ANSWERS THE QUESTION — e.g. get_credit_ratings for ratings, get_executive_compensation for pay. Do not stop after searching.
入力スキーマ
{
"type": "object",
"properties": {
"search": {
"type": "string",
"description": "Company name or ticker to search for (e.g. \"air new zealand\" or \"AIR\")"
},
"sector": {
"type": "string",
"description": "Filter by sector (e.g. \"Energy\", \"Healthcare\")"
},
"limit": {
"type": "integer",
"description": "Max results (default 10)",
"minimum": 1
}
},
"required": [],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"description": "Envelope contract version. Bumps only on a breaking shape change."
},
"tool": {
"type": "string",
"description": "Tool that produced this result."
},
"data": {
"description": "The tool payload. Null when the call did not produce one — read meta.availability_status to find out why, and do not treat null as zero, empty or \"none found\"."
},
"meta": {
"type": "object",
"additionalProperties": true,
"required": [
"retrieved_at",
"availability_status",
"provenance"
],
"properties": {
"retrieved_at": {
"type": "string",
"format": "date-time",
"description": "When this platform produced the answer — NOT the as-at date of the data."
},
"availability_status": {
"type": "string",
"enum": [
"ok",
"truncated",
"parse_failed",
"error"
],
"description": "ok: complete payload. truncated: payload exceeded the transport cap and was cut. parse_failed: payload is text this server could not parse as JSON. error: the tool raised."
},
"provenance": {
"type": "string",
"enum": [
"direct",
"label",
"reachable",
"none",
"undeclared"
],
"description": "Whether the figures can cite a source document. \"undeclared\" means no claim has been made for this endpoint yet — it is not a claim that the data is unsourced."
},
"encoding": {
"type": "string",
"enum": [
"json",
"toon"
],
"description": "toon = pipe-delimited tabular encoding; header row names the columns."
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"required": [
"schema_version",
"tool",
"data",
"meta"
],
"additionalProperties": false
}🟢get_company_detail(ticker, include)
Get detailed info for a specific NZX company by ticker. Can include directors, financials, governance score, and latest stock price.
入力スキーマ
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "NZX ticker symbol (e.g. \"AIR\", \"FPH\", \"MEL\")"
},
"include": {
"type": "string",
"description": "Comma-separated includes: directors, financials, governance, price, all (e.g. \"governance,price\")"
}
},
"required": [
"ticker"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"description": "Envelope contract version. Bumps only on a breaking shape change."
},
"tool": {
"type": "string",
"description": "Tool that produced this result."
},
"data": {
"description": "The tool payload. Null when the call did not produce one — read meta.availability_status to find out why, and do not treat null as zero, empty or \"none found\"."
},
"meta": {
"type": "object",
"additionalProperties": true,
"required": [
"retrieved_at",
"availability_status",
"provenance"
],
"properties": {
"retrieved_at": {
"type": "string",
"format": "date-time",
"description": "When this platform produced the answer — NOT the as-at date of the data."
},
"availability_status": {
"type": "string",
"enum": [
"ok",
"truncated",
"parse_failed",
"error"
],
"description": "ok: complete payload. truncated: payload exceeded the transport cap and was cut. parse_failed: payload is text this server could not parse as JSON. error: the tool raised."
},
"provenance": {
"type": "string",
"enum": [
"direct",
"label",
"reachable",
"none",
"undeclared"
],
"description": "Whether the figures can cite a source document. \"undeclared\" means no claim has been made for this endpoint yet — it is not a claim that the data is unsourced."
},
"encoding": {
"type": "string",
"enum": [
"json",
"toon"
],
"description": "toon = pipe-delimited tabular encoding; header row names the columns."
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"required": [
"schema_version",
"tool",
"data",
"meta"
],
"additionalProperties": false
}🟢get_governance_scores(sector, min_score, max_score, rating, sort, ...)
Get Governance Risk Scores (GRS) for NZX companies. 0-100 scale across 6 components: exec remuneration, board structure, shareholder rights, board effectiveness, audit & risk, remuneration disclosure. Can filter by sector, rating, or score range.
入力スキーマ
{
"type": "object",
"properties": {
"sector": {
"type": "string",
"description": "Filter by sector"
},
"min_score": {
"type": "number",
"description": "Minimum GRS score (0-100)"
},
"max_score": {
"type": "number",
"description": "Maximum GRS score (0-100)"
},
"rating": {
"type": "string",
"description": "Filter by rating: Excellent, Very Good, Good, Adequate, Poor, Very Poor"
},
"sort": {
"type": "string",
"description": "Sort field (e.g. \"total_score\")"
},
"order": {
"type": "string",
"description": "\"asc\" or \"desc\""
},
"limit": {
"type": "integer",
"description": "Max results (default 50)",
"minimum": 1
}
},
"required": [],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"description": "Envelope contract version. Bumps only on a breaking shape change."
},
"tool": {
"type": "string",
"description": "Tool that produced this result."
},
"data": {
"description": "The tool payload. Null when the call did not produce one — read meta.availability_status to find out why, and do not treat null as zero, empty or \"none found\"."
},
"meta": {
"type": "object",
"additionalProperties": true,
"required": [
"retrieved_at",
"availability_status",
"provenance"
],
"properties": {
"retrieved_at": {
"type": "string",
"format": "date-time",
"description": "When this platform produced the answer — NOT the as-at date of the data."
},
"availability_status": {
"type": "string",
"enum": [
"ok",
"truncated",
"parse_failed",
"error"
],
"description": "ok: complete payload. truncated: payload exceeded the transport cap and was cut. parse_failed: payload is text this server could not parse as JSON. error: the tool raised."
},
"provenance": {
"type": "string",
"enum": [
"direct",
"label",
"reachable",
"none",
"undeclared"
],
"description": "Whether the figures can cite a source document. \"undeclared\" means no claim has been made for this endpoint yet — it is not a claim that the data is unsourced."
},
"encoding": {
"type": "string",
"enum": [
"json",
"toon"
],
"description": "toon = pipe-delimited tabular encoding; header row names the columns."
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"required": [
"schema_version",
"tool",
"data",
"meta"
],
"additionalProperties": false
}🟢get_financials(ticker, statement, year, limit)
Get financial statements for an NZX company. Includes income statement, balance sheet, cash flow, and financial ratios. Filter by statement type and year range.
入力スキーマ
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "NZX ticker symbol"
},
"statement": {
"type": "string",
"description": "Statement type: income, balance, cashflow, ratios, or comma-separated (default: all)"
},
"year": {
"type": "string",
"description": "Year or range (e.g. \"2024\" or \"2020-2024\")"
},
"limit": {
"type": "integer",
"description": "Max results per statement type",
"minimum": 1
}
},
"required": [
"ticker"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"description": "Envelope contract version. Bumps only on a breaking shape change."
},
"tool": {
"type": "string",
"description": "Tool that produced this result."
},
"data": {
"description": "The tool payload. Null when the call did not produce one — read meta.availability_status to find out why, and do not treat null as zero, empty or \"none found\"."
},
"meta": {
"type": "object",
"additionalProperties": true,
"required": [
"retrieved_at",
"availability_status",
"provenance"
],
"properties": {
"retrieved_at": {
"type": "string",
"format": "date-time",
"description": "When this platform produced the answer — NOT the as-at date of the data."
},
"availability_status": {
"type": "string",
"enum": [
"ok",
"truncated",
"parse_failed",
"error"
],
"description": "ok: complete payload. truncated: payload exceeded the transport cap and was cut. parse_failed: payload is text this server could not parse as JSON. error: the tool raised."
},
"provenance": {
"type": "string",
"enum": [
"direct",
"label",
"reachable",
"none",
"undeclared"
],
"description": "Whether the figures can cite a source document. \"undeclared\" means no claim has been made for this endpoint yet — it is not a claim that the data is unsourced."
},
"encoding": {
"type": "string",
"enum": [
"json",
"toon"
],
"description": "toon = pipe-delimited tabular encoding; header row names the columns."
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"required": [
"schema_version",
"tool",
"data",
"meta"
],
"additionalProperties": false
}🟢get_metrics(ticker, sector, sort, order, mode, ...)
Get financial metrics/ratios for NZX companies. 46 ratios: profitability (incl. comprehensive_roe, oci_divergence), leverage (incl. paid_in_capital_ratio), cash flow, dividends, growth (incl. share_capital_growth), valuation, composite. Use for screening or comparison.
入力スキーマ
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "Specific ticker for detailed metrics with live valuation. Omit for list of all companies."
},
"sector": {
"type": "string",
"description": "Filter by sector (list mode only)"
},
"sort": {
"type": "string",
"description": "Sort by metric (e.g. \"pe_ratio\", \"roe\", \"dividend_yield\")"
},
"order": {
"type": "string",
"description": "\"asc\" or \"desc\""
},
"mode": {
"type": "string",
"description": "For single ticker: \"snapshot\" (default) or \"historical\""
},
"year": {
"type": "string",
"description": "Year or range filter"
},
"limit": {
"type": "integer",
"description": "Max results",
"minimum": 1
}
},
"required": [],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"description": "Envelope contract version. Bumps only on a breaking shape change."
},
"tool": {
"type": "string",
"description": "Tool that produced this result."
},
"data": {
"description": "The tool payload. Null when the call did not produce one — read meta.availability_status to find out why, and do not treat null as zero, empty or \"none found\"."
},
"meta": {
"type": "object",
"additionalProperties": true,
"required": [
"retrieved_at",
"availability_status",
"provenance"
],
"properties": {
"retrieved_at": {
"type": "string",
"format": "date-time",
"description": "When this platform produced the answer — NOT the as-at date of the data."
},
"availability_status": {
"type": "string",
"enum": [
"ok",
"truncated",
"parse_failed",
"error"
],
"description": "ok: complete payload. truncated: payload exceeded the transport cap and was cut. parse_failed: payload is text this server could not parse as JSON. error: the tool raised."
},
"provenance": {
"type": "string",
"enum": [
"direct",
"label",
"reachable",
"none",
"undeclared"
],
"description": "Whether the figures can cite a source document. \"undeclared\" means no claim has been made for this endpoint yet — it is not a claim that the data is unsourced."
},
"encoding": {
"type": "string",
"enum": [
"json",
"toon"
],
"description": "toon = pipe-delimited tabular encoding; header row names the columns."
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"required": [
"schema_version",
"tool",
"data",
"meta"
],
"additionalProperties": false
}🟢get_dividends(ticker, year, type, limit)
Get dividend history for an NZX company. Includes ex-date, payment date, amount (DPS), imputation %, DRP availability, summary stats. Company pages also show Dividend Safety Score (0-100 with 5 components), Forward Dividend Cut Probability (0-100% with risk factors), and Payout Ratio Trend Charts with sector benchmarks.
入力スキーマ
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "NZX ticker symbol"
},
"year": {
"type": "string",
"description": "Year or range (e.g. \"2024\" or \"2020-2024\")"
},
"type": {
"type": "string",
"description": "Dividend type: final, interim, special"
},
"limit": {
"type": "integer",
"description": "Max results",
"minimum": 1
}
},
"required": [
"ticker"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"description": "Envelope contract version. Bumps only on a breaking shape change."
},
"tool": {
"type": "string",
"description": "Tool that produced this result."
},
"data": {
"description": "The tool payload. Null when the call did not produce one — read meta.availability_status to find out why, and do not treat null as zero, empty or \"none found\"."
},
"meta": {
"type": "object",
"additionalProperties": true,
"required": [
"retrieved_at",
"availability_status",
"provenance"
],
"properties": {
"retrieved_at": {
"type": "string",
"format": "date-time",
"description": "When this platform produced the answer — NOT the as-at date of the data."
},
"availability_status": {
"type": "string",
"enum": [
"ok",
"truncated",
"parse_failed",
"error"
],
"description": "ok: complete payload. truncated: payload exceeded the transport cap and was cut. parse_failed: payload is text this server could not parse as JSON. error: the tool raised."
},
"provenance": {
"type": "string",
"enum": [
"direct",
"label",
"reachable",
"none",
"undeclared"
],
"description": "Whether the figures can cite a source document. \"undeclared\" means no claim has been made for this endpoint yet — it is not a claim that the data is unsourced."
},
"encoding": {
"type": "string",
"enum": [
"json",
"toon"
],
"description": "toon = pipe-delimited tabular encoding; header row names the columns."
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"required": [
"schema_version",
"tool",
"data",
"meta"
],
"additionalProperties": false
}🟢get_earnings(ticker, year, period, limit)
Get earnings results for an NZX company. Extracted from full-year and half-year announcements. Includes revenue, net profit, EBITDA, EPS, DPS, and management guidance.
入力スキーマ
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "NZX ticker symbol"
},
"year": {
"type": "string",
"description": "Year or range"
},
"period": {
"type": "string",
"description": "Period: annual, interim, or all"
},
"limit": {
"type": "integer",
"description": "Max results",
"minimum": 1
}
},
"required": [
"ticker"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"description": "Envelope contract version. Bumps only on a breaking shape change."
},
"tool": {
"type": "string",
"description": "Tool that produced this result."
},
"data": {
"description": "The tool payload. Null when the call did not produce one — read meta.availability_status to find out why, and do not treat null as zero, empty or \"none found\"."
},
"meta": {
"type": "object",
"additionalProperties": true,
"required": [
"retrieved_at",
"availability_status",
"provenance"
],
"properties": {
"retrieved_at": {
"type": "string",
"format": "date-time",
"description": "When this platform produced the answer — NOT the as-at date of the data."
},
"availability_status": {
"type": "string",
"enum": [
"ok",
"truncated",
"parse_failed",
"error"
],
"description": "ok: complete payload. truncated: payload exceeded the transport cap and was cut. parse_failed: payload is text this server could not parse as JSON. error: the tool raised."
},
"provenance": {
"type": "string",
"enum": [
"direct",
"label",
"reachable",
"none",
"undeclared"
],
"description": "Whether the figures can cite a source document. \"undeclared\" means no claim has been made for this endpoint yet — it is not a claim that the data is unsourced."
},
"encoding": {
"type": "string",
"enum": [
"json",
"toon"
],
"description": "toon = pipe-delimited tabular encoding; header row names the columns."
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"required": [
"schema_version",
"tool",
"data",
"meta"
],
"additionalProperties": false
}🟢get_stock_prices(ticker, days, from, to)
Get daily stock price history (OHLCV) for an NZX company. Use for price trends, returns, and technical context.
入力スキーマ
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "NZX ticker symbol"
},
"days": {
"type": "integer",
"description": "Number of recent trading days (default 30)",
"minimum": 1
},
"from": {
"type": "string",
"description": "Start date (YYYY-MM-DD)"
},
"to": {
"type": "string",
"description": "End date (YYYY-MM-DD)"
}
},
"required": [
"ticker"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"description": "Envelope contract version. Bumps only on a breaking shape change."
},
"tool": {
"type": "string",
"description": "Tool that produced this result."
},
"data": {
"description": "The tool payload. Null when the call did not produce one — read meta.availability_status to find out why, and do not treat null as zero, empty or \"none found\"."
},
"meta": {
"type": "object",
"additionalProperties": true,
"required": [
"retrieved_at",
"availability_status",
"provenance"
],
"properties": {
"retrieved_at": {
"type": "string",
"format": "date-time",
"description": "When this platform produced the answer — NOT the as-at date of the data."
},
"availability_status": {
"type": "string",
"enum": [
"ok",
"truncated",
"parse_failed",
"error"
],
"description": "ok: complete payload. truncated: payload exceeded the transport cap and was cut. parse_failed: payload is text this server could not parse as JSON. error: the tool raised."
},
"provenance": {
"type": "string",
"enum": [
"direct",
"label",
"reachable",
"none",
"undeclared"
],
"description": "Whether the figures can cite a source document. \"undeclared\" means no claim has been made for this endpoint yet — it is not a claim that the data is unsourced."
},
"encoding": {
"type": "string",
"enum": [
"json",
"toon"
],
"description": "toon = pipe-delimited tabular encoding; header row names the columns."
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"required": [
"schema_version",
"tool",
"data",
"meta"
],
"additionalProperties": false
}🟢search_announcements(q, ticker, type, from, to, ...)
Full-text search across NZX market announcements (2017-present), most with extracted PDF text. Searches announcement titles AND full document content. Use for finding mentions of specific topics, companies, people, or events across all NZX filings. Results include: ai_category (25-category AI classification like M&A, Dividend, Regulatory, Capital Raise, Guidance, Earnings Results), ai_category_confidence (0.0-1.0), ai_sub_topics (1-3 topic tags). May also include: ai_sentiment (positive/negative/neutral/mixed), ai_sentiment_score (-1.0 to 1.0), ai_topics (array of topic labels), ai_risk_flags (array of risk indicators like profit_warning, dividend_cut), and ai_summary (concise summary).
入力スキーマ
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Search query — searches both titles and full PDF document text"
},
"ticker": {
"type": "string",
"description": "Filter by company ticker"
},
"type": {
"type": "string",
"description": "Announcement type: FLLYR, HALFYR, SHINTR, MEETING, GENERAL, SECISSUE, DVDEND, etc."
},
"from": {
"type": "string",
"description": "Start date (YYYY-MM-DD)"
},
"to": {
"type": "string",
"description": "End date (YYYY-MM-DD)"
},
"limit": {
"type": "integer",
"description": "Max results (default 20)",
"minimum": 1
}
},
"required": [],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"description": "Envelope contract version. Bumps only on a breaking shape change."
},
"tool": {
"type": "string",
"description": "Tool that produced this result."
},
"data": {
"description": "The tool payload. Null when the call did not produce one — read meta.availability_status to find out why, and do not treat null as zero, empty or \"none found\"."
},
"meta": {
"type": "object",
"additionalProperties": true,
"required": [
"retrieved_at",
"availability_status",
"provenance"
],
"properties": {
"retrieved_at": {
"type": "string",
"format": "date-time",
"description": "When this platform produced the answer — NOT the as-at date of the data."
},
"availability_status": {
"type": "string",
"enum": [
"ok",
"truncated",
"parse_failed",
"error"
],
"description": "ok: complete payload. truncated: payload exceeded the transport cap and was cut. parse_failed: payload is text this server could not parse as JSON. error: the tool raised."
},
"provenance": {
"type": "string",
"enum": [
"direct",
"label",
"reachable",
"none",
"undeclared"
],
"description": "Whether the figures can cite a source document. \"undeclared\" means no claim has been made for this endpoint yet — it is not a claim that the data is unsourced."
},
"encoding": {
"type": "string",
"enum": [
"json",
"toon"
],
"description": "toon = pipe-delimited tabular encoding; header row names the columns."
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"required": [
"schema_version",
"tool",
"data",
"meta"
],
"additionalProperties": false
}🟢read_announcement(announcement_id)
Read and analyze a specific NZX announcement. Extracts summary, key figures, sentiment, entities, and risk flags using AI. Provide the announcement_id (e.g. "12345") from search_announcements results. Returns cached results if previously extracted.
入力スキーマ
{
"type": "object",
"properties": {
"announcement_id": {
"type": "string",
"description": "The announcement_id from search_announcements results"
}
},
"required": [
"announcement_id"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"description": "Envelope contract version. Bumps only on a breaking shape change."
},
"tool": {
"type": "string",
"description": "Tool that produced this result."
},
"data": {
"description": "The tool payload. Null when the call did not produce one — read meta.availability_status to find out why, and do not treat null as zero, empty or \"none found\"."
},
"meta": {
"type": "object",
"additionalProperties": true,
"required": [
"retrieved_at",
"availability_status",
"provenance"
],
"properties": {
"retrieved_at": {
"type": "string",
"format": "date-time",
"description": "When this platform produced the answer — NOT the as-at date of the data."
},
"availability_status": {
"type": "string",
"enum": [
"ok",
"truncated",
"parse_failed",
"error"
],
"description": "ok: complete payload. truncated: payload exceeded the transport cap and was cut. parse_failed: payload is text this server could not parse as JSON. error: the tool raised."
},
"provenance": {
"type": "string",
"enum": [
"direct",
"label",
"reachable",
"none",
"undeclared"
],
"description": "Whether the figures can cite a source document. \"undeclared\" means no claim has been made for this endpoint yet — it is not a claim that the data is unsourced."
},
"encoding": {
"type": "string",
"enum": [
"json",
"toon"
],
"description": "toon = pipe-delimited tabular encoding; header row names the columns."
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"required": [
"schema_version",
"tool",
"data",
"meta"
],
"additionalProperties": false
}🟢get_agm_resolutions(ticker, year)
Get AGM resolution voting data for an NZX company. Shows resolutions, votes for/against/abstain, pass/fail status, support percentages. Use for governance and shareholder activism analysis.
入力スキーマ
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "NZX ticker symbol"
},
"year": {
"type": "string",
"description": "Filter by meeting year"
}
},
"required": [
"ticker"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"description": "Envelope contract version. Bumps only on a breaking shape change."
},
"tool": {
"type": "string",
"description": "Tool that produced this result."
},
"data": {
"description": "The tool payload. Null when the call did not produce one — read meta.availability_status to find out why, and do not treat null as zero, empty or \"none found\"."
},
"meta": {
"type": "object",
"additionalProperties": true,
"required": [
"retrieved_at",
"availability_status",
"provenance"
],
"properties": {
"retrieved_at": {
"type": "string",
"format": "date-time",
"description": "When this platform produced the answer — NOT the as-at date of the data."
},
"availability_status": {
"type": "string",
"enum": [
"ok",
"truncated",
"parse_failed",
"error"
],
"description": "ok: complete payload. truncated: payload exceeded the transport cap and was cut. parse_failed: payload is text this server could not parse as JSON. error: the tool raised."
},
"provenance": {
"type": "string",
"enum": [
"direct",
"label",
"reachable",
"none",
"undeclared"
],
"description": "Whether the figures can cite a source document. \"undeclared\" means no claim has been made for this endpoint yet — it is not a claim that the data is unsourced."
},
"encoding": {
"type": "string",
"enum": [
"json",
"toon"
],
"description": "toon = pipe-delimited tabular encoding; header row names the columns."
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"required": [
"schema_version",
"tool",
"data",
"meta"
],
"additionalProperties": false
}🟢get_esg_data(ticker, year)
Get ESG (Environmental, Social, Governance) data for an NZX company. 255 emissions records, 760 diversity records, 270 safety records across NZX issuers. Includes emissions (scope 1/2/3, targets, verification), diversity (board/SLT/employee gender, Māori/Pasifika representation), safety (LTIFR/TRIFR, fatalities, FTE), and reporting standards (GRI/TCFD/SBTi).
入力スキーマ
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "NZX ticker symbol"
},
"year": {
"type": "string",
"description": "Filter by fiscal year"
}
},
"required": [
"ticker"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"description": "Envelope contract version. Bumps only on a breaking shape change."
},
"tool": {
"type": "string",
"description": "Tool that produced this result."
},
"data": {
"description": "The tool payload. Null when the call did not produce one — read meta.availability_status to find out why, and do not treat null as zero, empty or \"none found\"."
},
"meta": {
"type": "object",
"additionalProperties": true,
"required": [
"retrieved_at",
"availability_status",
"provenance"
],
"properties": {
"retrieved_at": {
"type": "string",
"format": "date-time",
"description": "When this platform produced the answer — NOT the as-at date of the data."
},
"availability_status": {
"type": "string",
"enum": [
"ok",
"truncated",
"parse_failed",
"error"
],
"description": "ok: complete payload. truncated: payload exceeded the transport cap and was cut. parse_failed: payload is text this server could not parse as JSON. error: the tool raised."
},
"provenance": {
"type": "string",
"enum": [
"direct",
"label",
"reachable",
"none",
"undeclared"
],
"description": "Whether the figures can cite a source document. \"undeclared\" means no claim has been made for this endpoint yet — it is not a claim that the data is unsourced."
},
"encoding": {
"type": "string",
"enum": [
"json",
"toon"
],
"description": "toon = pipe-delimited tabular encoding; header row names the columns."
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"required": [
"schema_version",
"tool",
"data",
"meta"
],
"additionalProperties": false
}🟢get_kiwisaver_holdings(ticker, date)
Get KiwiSaver fund holdings in an NZX company. Shows which KiwiSaver funds hold shares, their market value, and percentage of fund. Data covers Dec 2018 - Sep 2022.
入力スキーマ
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "NZX ticker symbol"
},
"date": {
"type": "string",
"description": "Specific quarter date (e.g. \"2022-09-30\")"
}
},
"required": [
"ticker"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"description": "Envelope contract version. Bumps only on a breaking shape change."
},
"tool": {
"type": "string",
"description": "Tool that produced this result."
},
"data": {
"description": "The tool payload. Null when the call did not produce one — read meta.availability_status to find out why, and do not treat null as zero, empty or \"none found\"."
},
"meta": {
"type": "object",
"additionalProperties": true,
"required": [
"retrieved_at",
"availability_status",
"provenance"
],
"properties": {
"retrieved_at": {
"type": "string",
"format": "date-time",
"description": "When this platform produced the answer — NOT the as-at date of the data."
},
"availability_status": {
"type": "string",
"enum": [
"ok",
"truncated",
"parse_failed",
"error"
],
"description": "ok: complete payload. truncated: payload exceeded the transport cap and was cut. parse_failed: payload is text this server could not parse as JSON. error: the tool raised."
},
"provenance": {
"type": "string",
"enum": [
"direct",
"label",
"reachable",
"none",
"undeclared"
],
"description": "Whether the figures can cite a source document. \"undeclared\" means no claim has been made for this endpoint yet — it is not a claim that the data is unsourced."
},
"encoding": {
"type": "string",
"enum": [
"json",
"toon"
],
"description": "toon = pipe-delimited tabular encoding; header row names the columns."
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"required": [
"schema_version",
"tool",
"data",
"meta"
],
"additionalProperties": false
}🟢get_performance(ticker)
Get stock performance metrics for an NZX company. Returns (1d to 5y), alpha vs NZX50, volatility, 52-week range, market cap. Use for performance comparison and pay-for-performance analysis.
入力スキーマ
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "NZX ticker symbol"
}
},
"required": [
"ticker"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"description": "Envelope contract version. Bumps only on a breaking shape change."
},
"tool": {
"type": "string",
"description": "Tool that produced this result."
},
"data": {
"description": "The tool payload. Null when the call did not produce one — read meta.availability_status to find out why, and do not treat null as zero, empty or \"none found\"."
},
"meta": {
"type": "object",
"additionalProperties": true,
"required": [
"retrieved_at",
"availability_status",
"provenance"
],
"properties": {
"retrieved_at": {
"type": "string",
"format": "date-time",
"description": "When this platform produced the answer — NOT the as-at date of the data."
},
"availability_status": {
"type": "string",
"enum": [
"ok",
"truncated",
"parse_failed",
"error"
],
"description": "ok: complete payload. truncated: payload exceeded the transport cap and was cut. parse_failed: payload is text this server could not parse as JSON. error: the tool raised."
},
"provenance": {
"type": "string",
"enum": [
"direct",
"label",
"reachable",
"none",
"undeclared"
],
"description": "Whether the figures can cite a source document. \"undeclared\" means no claim has been made for this endpoint yet — it is not a claim that the data is unsourced."
},
"encoding": {
"type": "string",
"enum": [
"json",
"toon"
],
"description": "toon = pipe-delimited tabular encoding; header row names the columns."
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"required": [
"schema_version",
"tool",
"data",
"meta"
],
"additionalProperties": false
}🟢get_technical_signals(ticker)
Get technical analysis indicators for an NZX company. SMA-50/100/200, RSI-14, golden/death cross, distance from 52-week high/low, volume ratios. Use for trading signals, momentum analysis, and technical screening.
入力スキーマ
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "NZX ticker symbol (e.g. \"AIR\", \"FPH\", \"MEL\")"
}
},
"required": [
"ticker"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"description": "Envelope contract version. Bumps only on a breaking shape change."
},
"tool": {
"type": "string",
"description": "Tool that produced this result."
},
"data": {
"description": "The tool payload. Null when the call did not produce one — read meta.availability_status to find out why, and do not treat null as zero, empty or \"none found\"."
},
"meta": {
"type": "object",
"additionalProperties": true,
"required": [
"retrieved_at",
"availability_status",
"provenance"
],
"properties": {
"retrieved_at": {
"type": "string",
"format": "date-time",
"description": "When this platform produced the answer — NOT the as-at date of the data."
},
"availability_status": {
"type": "string",
"enum": [
"ok",
"truncated",
"parse_failed",
"error"
],
"description": "ok: complete payload. truncated: payload exceeded the transport cap and was cut. parse_failed: payload is text this server could not parse as JSON. error: the tool raised."
},
"provenance": {
"type": "string",
"enum": [
"direct",
"label",
"reachable",
"none",
"undeclared"
],
"description": "Whether the figures can cite a source document. \"undeclared\" means no claim has been made for this endpoint yet — it is not a claim that the data is unsourced."
},
"encoding": {
"type": "string",
"enum": [
"json",
"toon"
],
"description": "toon = pipe-delimited tabular encoding; header row names the columns."
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"required": [
"schema_version",
"tool",
"data",
"meta"
],
"additionalProperties": false
}🟢get_credit_ratings(ticker, year, agency, action, limit)
Get credit rating history for an NZX company. Shows S&P, Moody's, Fitch, AM Best ratings with upgrades, downgrades, and outlook changes. ~20 NZX companies have credit ratings.
入力スキーマ
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "NZX ticker symbol (e.g. \"ANZ\", \"MEL\", \"SPK\")"
},
"year": {
"type": "string",
"description": "Year or range (e.g. \"2024\" or \"2020-2024\")"
},
"agency": {
"type": "string",
"description": "Filter by agency: \"S&P\", \"Moody's\", \"Fitch\", \"AM Best\""
},
"action": {
"type": "string",
"description": "Filter by action: affirmed, upgraded, downgraded, assigned, withdrawn"
},
"limit": {
"type": "integer",
"description": "Max results",
"minimum": 1
}
},
"required": [
"ticker"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"description": "Envelope contract version. Bumps only on a breaking shape change."
},
"tool": {
"type": "string",
"description": "Tool that produced this result."
},
"data": {
"description": "The tool payload. Null when the call did not produce one — read meta.availability_status to find out why, and do not treat null as zero, empty or \"none found\"."
},
"meta": {
"type": "object",
"additionalProperties": true,
"required": [
"retrieved_at",
"availability_status",
"provenance"
],
"properties": {
"retrieved_at": {
"type": "string",
"format": "date-time",
"description": "When this platform produced the answer — NOT the as-at date of the data."
},
"availability_status": {
"type": "string",
"enum": [
"ok",
"truncated",
"parse_failed",
"error"
],
"description": "ok: complete payload. truncated: payload exceeded the transport cap and was cut. parse_failed: payload is text this server could not parse as JSON. error: the tool raised."
},
"provenance": {
"type": "string",
"enum": [
"direct",
"label",
"reachable",
"none",
"undeclared"
],
"description": "Whether the figures can cite a source document. \"undeclared\" means no claim has been made for this endpoint yet — it is not a claim that the data is unsourced."
},
"encoding": {
"type": "string",
"enum": [
"json",
"toon"
],
"description": "toon = pipe-delimited tabular encoding; header row names the columns."
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"required": [
"schema_version",
"tool",
"data",
"meta"
],
"additionalProperties": false
}🟢get_management_team(ticker, role)
Get the management team (C-suite executives) for an NZX company. Returns current CEO, CFO, COO, CTO, and other senior executives with their roles, tenure, biographies, education, and profile links. 127 issuers covered, 508 current executives across 15 normalized roles. Filter by role (e.g. CEO, CFO). Includes profile data where linked to shared.people.
入力スキーマ
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "NZX ticker symbol (e.g. \"FPH\", \"AIR\", \"SPK\")"
},
"role": {
"type": "string",
"description": "Filter by normalized role: CEO, CFO, COO, CTO, CIO, CLO, CPO, CMO, CRO, CDO, CS, GM, VP, MD, Other"
}
},
"required": [
"ticker"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"description": "Envelope contract version. Bumps only on a breaking shape change."
},
"tool": {
"type": "string",
"description": "Tool that produced this result."
},
"data": {
"description": "The tool payload. Null when the call did not produce one — read meta.availability_status to find out why, and do not treat null as zero, empty or \"none found\"."
},
"meta": {
"type": "object",
"additionalProperties": true,
"required": [
"retrieved_at",
"availability_status",
"provenance"
],
"properties": {
"retrieved_at": {
"type": "string",
"format": "date-time",
"description": "When this platform produced the answer — NOT the as-at date of the data."
},
"availability_status": {
"type": "string",
"enum": [
"ok",
"truncated",
"parse_failed",
"error"
],
"description": "ok: complete payload. truncated: payload exceeded the transport cap and was cut. parse_failed: payload is text this server could not parse as JSON. error: the tool raised."
},
"provenance": {
"type": "string",
"enum": [
"direct",
"label",
"reachable",
"none",
"undeclared"
],
"description": "Whether the figures can cite a source document. \"undeclared\" means no claim has been made for this endpoint yet — it is not a claim that the data is unsourced."
},
"encoding": {
"type": "string",
"enum": [
"json",
"toon"
],
"description": "toon = pipe-delimited tabular encoding; header row names the columns."
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"required": [
"schema_version",
"tool",
"data",
"meta"
],
"additionalProperties": false
}🟢get_capital_raises(ticker, year, type, buybacks, limit)
Get capital raise history for an NZX company. Includes placements, rights issues, SPPs, IPOs, bonds, buybacks, DRPs with amounts, pricing, and dilution. ~11,700 structured events across 131 issuers.
入力スキーマ
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "NZX ticker symbol (e.g. \"AIR\", \"FBU\", \"RYM\")"
},
"year": {
"type": "string",
"description": "Year or range (e.g. \"2024\" or \"2020-2024\")"
},
"type": {
"type": "string",
"description": "Comma-separated raise types: placement, rights_issue, spp, ipo, bond, buyback, drp, options_exercise, employee_scheme, conversion"
},
"buybacks": {
"type": "string",
"description": "Set to \"true\" to only show buybacks"
},
"limit": {
"type": "integer",
"description": "Max results",
"minimum": 1
}
},
"required": [
"ticker"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"description": "Envelope contract version. Bumps only on a breaking shape change."
},
"tool": {
"type": "string",
"description": "Tool that produced this result."
},
"data": {
"description": "The tool payload. Null when the call did not produce one — read meta.availability_status to find out why, and do not treat null as zero, empty or \"none found\"."
},
"meta": {
"type": "object",
"additionalProperties": true,
"required": [
"retrieved_at",
"availability_status",
"provenance"
],
"properties": {
"retrieved_at": {
"type": "string",
"format": "date-time",
"description": "When this platform produced the answer — NOT the as-at date of the data."
},
"availability_status": {
"type": "string",
"enum": [
"ok",
"truncated",
"parse_failed",
"error"
],
"description": "ok: complete payload. truncated: payload exceeded the transport cap and was cut. parse_failed: payload is text this server could not parse as JSON. error: the tool raised."
},
"provenance": {
"type": "string",
"enum": [
"direct",
"label",
"reachable",
"none",
"undeclared"
],
"description": "Whether the figures can cite a source document. \"undeclared\" means no claim has been made for this endpoint yet — it is not a claim that the data is unsourced."
},
"encoding": {
"type": "string",
"enum": [
"json",
"toon"
],
"description": "toon = pipe-delimited tabular encoding; header row names the columns."
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"required": [
"schema_version",
"tool",
"data",
"meta"
],
"additionalProperties": false
}🟢get_revenue_segments(ticker, year, type, limit)
Get revenue segment breakdown for an NZX company. Returns operating, geographic, or product segment data including segment revenue, operating profit, and assets (all in NZD thousands). Use when asked about "revenue breakdown", "business segments", "divisions", "product groups", "geographic revenue", "segment analysis", or "what are the divisions of [company]".
入力スキーマ
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "NZX ticker symbol (e.g. \"FPH\", \"SKC\", \"AIR\", \"FBU\")"
},
"year": {
"type": "string",
"description": "Year or range (e.g. \"2025\" or \"2020-2025\")"
},
"type": {
"type": "string",
"description": "Segment type filter: operating, geographic, product"
},
"limit": {
"type": "integer",
"description": "Max results (default 50)",
"minimum": 1
}
},
"required": [
"ticker"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"description": "Envelope contract version. Bumps only on a breaking shape change."
},
"tool": {
"type": "string",
"description": "Tool that produced this result."
},
"data": {
"description": "The tool payload. Null when the call did not produce one — read meta.availability_status to find out why, and do not treat null as zero, empty or \"none found\"."
},
"meta": {
"type": "object",
"additionalProperties": true,
"required": [
"retrieved_at",
"availability_status",
"provenance"
],
"properties": {
"retrieved_at": {
"type": "string",
"format": "date-time",
"description": "When this platform produced the answer — NOT the as-at date of the data."
},
"availability_status": {
"type": "string",
"enum": [
"ok",
"truncated",
"parse_failed",
"error"
],
"description": "ok: complete payload. truncated: payload exceeded the transport cap and was cut. parse_failed: payload is text this server could not parse as JSON. error: the tool raised."
},
"provenance": {
"type": "string",
"enum": [
"direct",
"label",
"reachable",
"none",
"undeclared"
],
"description": "Whether the figures can cite a source document. \"undeclared\" means no claim has been made for this endpoint yet — it is not a claim that the data is unsourced."
},
"encoding": {
"type": "string",
"enum": [
"json",
"toon"
],
"description": "toon = pipe-delimited tabular encoding; header row names the columns."
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"required": [
"schema_version",
"tool",
"data",
"meta"
],
"additionalProperties": false
}🟢get_takeovers(ticker, status, deal_type, year, limit)
Get M&A and takeover activity for an NZX company. Returns structured deal data: acquirer, target, offer price, total value, premium, acceptance %, status, timeline. Covers takeover offers, mergers, schemes of arrangement, compulsory acquisitions, and asset acquisitions. Use this when asked about "takeovers", "M&A", "acquisitions", "who is buying", "hostile bids", "scheme of arrangement", or deal activity for a company.
入力スキーマ
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "NZX ticker symbol (e.g. \"RBD\", \"RAK\", \"MCK\")"
},
"status": {
"type": "string",
"description": "Comma-separated: announced, conditional, unconditional, completed, withdrawn, failed"
},
"deal_type": {
"type": "string",
"description": "Comma-separated: takeover_offer, merger, scheme_of_arrangement, compulsory_acquisition, acquisition"
},
"year": {
"type": "string",
"description": "Year or range (e.g. \"2025\" or \"2020-2025\")"
},
"limit": {
"type": "integer",
"description": "Max results (default 50)",
"minimum": 1
}
},
"required": [
"ticker"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"description": "Envelope contract version. Bumps only on a breaking shape change."
},
"tool": {
"type": "string",
"description": "Tool that produced this result."
},
"data": {
"description": "The tool payload. Null when the call did not produce one — read meta.availability_status to find out why, and do not treat null as zero, empty or \"none found\"."
},
"meta": {
"type": "object",
"additionalProperties": true,
"required": [
"retrieved_at",
"availability_status",
"provenance"
],
"properties": {
"retrieved_at": {
"type": "string",
"format": "date-time",
"description": "When this platform produced the answer — NOT the as-at date of the data."
},
"availability_status": {
"type": "string",
"enum": [
"ok",
"truncated",
"parse_failed",
"error"
],
"description": "ok: complete payload. truncated: payload exceeded the transport cap and was cut. parse_failed: payload is text this server could not parse as JSON. error: the tool raised."
},
"provenance": {
"type": "string",
"enum": [
"direct",
"label",
"reachable",
"none",
"undeclared"
],
"description": "Whether the figures can cite a source document. \"undeclared\" means no claim has been made for this endpoint yet — it is not a claim that the data is unsourced."
},
"encoding": {
"type": "string",
"enum": [
"json",
"toon"
],
"description": "toon = pipe-delimited tabular encoding; header row names the columns."
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"required": [
"schema_version",
"tool",
"data",
"meta"
],
"additionalProperties": false
}🟢get_market_signals(ticker, type, days, significance, sector, ...)
Get the Market Intelligence Feed — a unified stream of all NZX market events. Returns 13 signal types: insider trades, capital raises, dividends, earnings releases, AGM results, director changes, governance score changes, technical signals (golden/death cross, RSI extremes), credit rating changes, auditor changes, takeover/M&A activity, board events, and composite signals (multi-signal patterns like insider selling + earnings miss, director exodus, governance deterioration). Use this when asked "what happened on the NZX today/this week?", "any recent insider trades?", "golden crosses?", "credit rating changes?", "composite signals?", "market activity for AIR", or any question about recent NZX events. ROUTING: this is the CROSS-MARKET FEED — use it for 'what is happening across the market' or when scanning several signal types at once. For a question about ONE dataset for ONE company, prefer the specific tool: get_capital_raises, get_agm_resolutions, get_vote_history, get_credit_ratings, get_audit_history, get_governance_scores, get_dividends, get_insider_trades. Listing a signal type here does NOT mean this is the best tool for it.
入力スキーマ
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "Filter by company ticker (e.g. \"AIR\", \"MEL\")"
},
"type": {
"type": "string",
"description": "Comma-separated signal types: insider_trade, capital_raise, dividend, earnings, agm_result, director_change, grs_change, technical_signal, credit_rating, audit_change, takeover, board_event, composite_signal"
},
"days": {
"type": "integer",
"description": "Number of days to look back (default 180, use 7 for \"this week\", 1 for \"today\")",
"minimum": 1
},
"significance": {
"type": "string",
"description": "Filter by significance: high, medium, low"
},
"sector": {
"type": "string",
"description": "Filter by sector (e.g. \"Energy\", \"Healthcare\")"
},
"limit": {
"type": "integer",
"description": "Max results (default 50)",
"minimum": 1
}
},
"required": [],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"description": "Envelope contract version. Bumps only on a breaking shape change."
},
"tool": {
"type": "string",
"description": "Tool that produced this result."
},
"data": {
"description": "The tool payload. Null when the call did not produce one — read meta.availability_status to find out why, and do not treat null as zero, empty or \"none found\"."
},
"meta": {
"type": "object",
"additionalProperties": true,
"required": [
"retrieved_at",
"availability_status",
"provenance"
],
"properties": {
"retrieved_at": {
"type": "string",
"format": "date-time",
"description": "When this platform produced the answer — NOT the as-at date of the data."
},
"availability_status": {
"type": "string",
"enum": [
"ok",
"truncated",
"parse_failed",
"error"
],
"description": "ok: complete payload. truncated: payload exceeded the transport cap and was cut. parse_failed: payload is text this server could not parse as JSON. error: the tool raised."
},
"provenance": {
"type": "string",
"enum": [
"direct",
"label",
"reachable",
"none",
"undeclared"
],
"description": "Whether the figures can cite a source document. \"undeclared\" means no claim has been made for this endpoint yet — it is not a claim that the data is unsourced."
},
"encoding": {
"type": "string",
"enum": [
"json",
"toon"
],
"description": "toon = pipe-delimited tabular encoding; header row names the columns."
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"required": [
"schema_version",
"tool",
"data",
"meta"
],
"additionalProperties": false
}🟢get_annual_reports(ticker, year, type)
Get annual and interim report URLs for an NZX company. Shows report URLs, financial year, extraction status. Use this when asked about a company's annual reports, filings, or report history.
入力スキーマ
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "NZX ticker symbol (e.g. \"AIR\", \"FPH\")"
},
"year": {
"type": "string",
"description": "Fiscal year or range (e.g. \"2024\" or \"2020-2024\")"
},
"type": {
"type": "string",
"description": "Filter: \"annual\" or \"interim\""
}
},
"required": [
"ticker"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"description": "Envelope contract version. Bumps only on a breaking shape change."
},
"tool": {
"type": "string",
"description": "Tool that produced this result."
},
"data": {
"description": "The tool payload. Null when the call did not produce one — read meta.availability_status to find out why, and do not treat null as zero, empty or \"none found\"."
},
"meta": {
"type": "object",
"additionalProperties": true,
"required": [
"retrieved_at",
"availability_status",
"provenance"
],
"properties": {
"retrieved_at": {
"type": "string",
"format": "date-time",
"description": "When this platform produced the answer — NOT the as-at date of the data."
},
"availability_status": {
"type": "string",
"enum": [
"ok",
"truncated",
"parse_failed",
"error"
],
"description": "ok: complete payload. truncated: payload exceeded the transport cap and was cut. parse_failed: payload is text this server could not parse as JSON. error: the tool raised."
},
"provenance": {
"type": "string",
"enum": [
"direct",
"label",
"reachable",
"none",
"undeclared"
],
"description": "Whether the figures can cite a source document. \"undeclared\" means no claim has been made for this endpoint yet — it is not a claim that the data is unsourced."
},
"encoding": {
"type": "string",
"enum": [
"json",
"toon"
],
"description": "toon = pipe-delimited tabular encoding; header row names the columns."
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"required": [
"schema_version",
"tool",
"data",
"meta"
],
"additionalProperties": false
}🟢get_daily_market_wrap(days)
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 AI-generated video script and written narrative summary. Use when asked about overall market conditions, today's market, what happened on the NZX, or market summary.
入力スキーマ
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"description": "Lookback days (1-7, default 7). Use 1 for last trading day, 7 for the week.",
"minimum": 1
}
},
"required": [],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"description": "Envelope contract version. Bumps only on a breaking shape change."
},
"tool": {
"type": "string",
"description": "Tool that produced this result."
},
"data": {
"description": "The tool payload. Null when the call did not produce one — read meta.availability_status to find out why, and do not treat null as zero, empty or \"none found\"."
},
"meta": {
"type": "object",
"additionalProperties": true,
"required": [
"retrieved_at",
"availability_status",
"provenance"
],
"properties": {
"retrieved_at": {
"type": "string",
"format": "date-time",
"description": "When this platform produced the answer — NOT the as-at date of the data."
},
"availability_status": {
"type": "string",
"enum": [
"ok",
"truncated",
"parse_failed",
"error"
],
"description": "ok: complete payload. truncated: payload exceeded the transport cap and was cut. parse_failed: payload is text this server could not parse as JSON. error: the tool raised."
},
"provenance": {
"type": "string",
"enum": [
"direct",
"label",
"reachable",
"none",
"undeclared"
],
"description": "Whether the figures can cite a source document. \"undeclared\" means no claim has been made for this endpoint yet — it is not a claim that the data is unsourced."
},
"encoding": {
"type": "string",
"enum": [
"json",
"toon"
],
"description": "toon = pipe-delimited tabular encoding; header row names the columns."
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"required": [
"schema_version",
"tool",
"data",
"meta"
],
"additionalProperties": false
}コミュニティ
エビデンス
最近の観測
検証済みバージョンは記録されていませんツール 23 件