Tools

search_entitiesFree

Fuzzy search the NNN entity registry (organizations, sites, reactor units, reactor designs, programs, policies) by name, alias or id. Use this first to turn a name into a stable entity id.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_entities",
    "arguments": {
      "query": "Sizewell",
      "type": "site"
    }
  }
}

dataset_statusFree

Which version of the NNN data this server is answering from: nnn-site git SHA, load time, row counts per table, and the license terms that apply.

No parameters.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "dataset_status",
    "arguments": {}
  }
}

get_entityFree

Full record for one entity: names and aliases, kind, country, identifiers (Wikidata, LEI, ticker, website), sources, verification date and confidence, plus its public structural links (parent, subsidiaries, operator, vendor, site, design, units) and counts of articles and incidents. Pro accounts also get its ledger relationships (shareholdings, contracts, offtake) inline.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_entity",
    "arguments": {
      "id": "org:nnb-genco"
    }
  }
}

posts_aboutFree

NNN articles whose subject is the entity (about) or that mention it, newest first, with title, summary, date and URL.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "posts_about",
    "arguments": {
      "id": "org:terrapower",
      "role": "about"
    }
  }
}

list_unitsFree

Current state of reactor units: tracker projects (planned → commissioning) and registry units (operating and shut-down fleet NNN covers). Filter by status, country, vendor, design, site, reactor type or SMR flag.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_units",
    "arguments": {
      "status": "under_construction",
      "country": "CN"
    }
  }
}

list_incidentsFree

The NNN drone incident tracker for nuclear and energy infrastructure: date, facility, outcome, attribution, sources. Filter by site or unit id, country, or date.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_incidents",
    "arguments": {
      "site_id": "site:zaporizhzhia"
    }
  }
}

industry_trackersFree

Current state of NNN's industry trackers: fusion energy companies and devices, uranium enrichment and HALEU facilities, nuclear plant restarts, and decommissioning projects. Each record has status, key figures, targets, linked entity ids, sources, confidence and its NNN page. Filter by tracker, status, country, entity id or text.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "industry_trackers",
    "arguments": {
      "vertical": "nuclear-plant-restarts",
      "country": "JP"
    }
  }
}

relationshipsPro

The NNN relationship ledger for an entity: shareholdings (with %), offtake agreements, EPC/supply/fuel contracts (with primary-sourced values), licences and memberships, as subject or object, including ended relationships and their dated event history.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "relationships",
    "arguments": {
      "id": "org:westinghouse",
      "direction": "incoming"
    }
  }
}

ownershipPro

Cap table for a company or project: current shareholders with percentages and their sum, former shareholders, stake-change events, and — in the other direction — the entity's own holdings.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "ownership",
    "arguments": {
      "id": "org:sizewell-c-ltd"
    }
  }
}

entity_graphPro

Multi-hop neighbourhood of an entity in the NNN knowledge graph (registry structure, tracker vendor/owner/EPC links, Prometheus participation and the relationship ledger). Returns nodes and typed edges up to the requested depth.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "entity_graph",
    "arguments": {
      "id": "org:cnnc",
      "depth": 2
    }
  }
}

unit_historyPro

Append-only history of a reactor unit: every dated tracker milestone (first concrete, fuel load, grid connection, delays) and registry status change (shutdown, restart), each with its source.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "unit_history",
    "arguments": {
      "id": "unit:akkuyu-1"
    }
  }
}

industry_tracker_historyPro

Append-only milestone history of one industry-tracker record (a fusion device, an enrichment facility, a plant restart or a decommissioning project): every dated event with its source.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "industry_tracker_history",
    "arguments": {
      "vertical": "nuclear-plant-restarts",
      "slug": "takahama-1"
    }
  }
}

changes_sincePro

Everything that changed in the NNN data on or after a date: unit milestones and status changes, relationship events, new relationships, policy-tracker events, Prometheus events, incidents, industry-tracker milestones and re-verified entities.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "changes_since",
    "arguments": {
      "since": "2026-09-01"
    }
  }
}

searchFree

Search NNN entities and articles. Returns result ids to pass to fetch. Implements the search tool contract ChatGPT uses for connectors and deep research.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search",
    "arguments": {
      "query": "who owns Hinkley Point C"
    }
  }
}

fetchFree

Fetch one document returned by search ("entity:{id}" or "post:{slug}") as readable text with its URL and metadata. Implements the fetch tool contract ChatGPT uses for connectors and deep research.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "fetch",
    "arguments": {
      "id": "entity:org:nnb-genco"
    }
  }
}