Graph Neighbors (typed weighted-signal edges — the traversal primitive) [beta]
graph_neighborsThe traversal primitive — a node's linked entities via typed edges, each with a signals dict carrying that edge's NATURAL weight (no unified edge weight; you pick). Returns edges:[{edge_type, direction, target_node_id, target_type, target_name, signals, as_of, source}]. Second-hop = call again on a returned target_node_id (an insider's OTHER board seats, a fund's co-investors, an institution's alumni). Filters: edge_types (discover valid ones + their signals via graph_schema), order_by a signal DESC, since+as_of (date RANGE — windowed/PIT walks), min_signal+signal_key floor, include_rumored (default false → acquired is definitive-only), limit. Edge set is catalog-driven (mars.graph_edge_catalog) — new edges are usable with no code change; consumer-contract filters (integrity, is_definitive) are baked in per the catalog.
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": {
"node_id": "<node_id>"
},
"name": "graph_neighbors"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| as_of | No | Upper date bound (YYYY-MM-DD) — edges dated on/before (PIT). | |
| limit | No | Max neighbors per edge type (default 50, max 500). | |
| since | No | Lower date bound (YYYY-MM-DD) — edges dated on/after. Pair with as_of for a window. | |
| node_id | Yes | Canonical node UUID (from graph_resolve). | |
| order_by | No | A signal key to sort neighbors by, DESC nulls-last (e.g. 'value_usd', 'deal_value_usd_converted'). Default: pit_column DESC. | |
| node_type | No | Optional — skips the probe. | |
| edge_types | No | Restrict to these edge types (use graph_schema to discover valid ones). Default: all edges this node touches. | |
| min_signal | No | Numeric floor on a signal (pair with signal_key). | |
| signal_key | No | Which signal min_signal applies to. | |
| expand_family | No | Default true. For family-aware edges (e.g. invested_in), roll the anchor up to its full canonical family before walking (one Invesco member → all members' deals) so graph_neighbors matches mars_investor_portfolio's rollup. Co-investors on one deal collapse to a single edge (no double-count). Set false for a literal single-entity walk. | |
| include_rumored | No | Include rumored deals on edges with a consumer-contract edge_filter (e.g. acquired). Default false. |