get_peer_mentions
Get peer mentions for an NZX company — which other companies reference it in their announcements, and which companies it references. Extracted from NZX announcements. Shows network of business relationships, competitive dynamics, and sector interconnections. Includes context snippets. Each mention includes a relation_type (supplier, customer, partner, competitor, joint_venture, acquirer, subsidiary, licensee, advisor, shareholder, none) and relation_confidence (high, medium, low). Summary includes counts by relation type. Filter by relation type with the relation parameter.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"ticker": "<ticker>"
},
"name": "get_peer_mentions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ticker | Yes | NZX ticker symbol (e.g. "FPH", "AIR", "SPK") | |
| relation | No | Filter by relation type(s), comma-separated (e.g. "supplier,customer") | |
| direction | No | Filter direction: "mentions" (companies this ticker references), "mentioned_by" (companies referencing this ticker), or "both" (default) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | 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 | Yes | ||
| tool | Yes | Tool that produced this result. | |
| schema_version | Yes | Envelope contract version. Bumps only on a breaking shape change. |