System Atlas
SystemAtlas

top

The top organizations by a metric within a scope, keyset-paged: a published figure (revenue, employees, funding: each value with its year, the page it was published on (url), the publisher (source) and approx when it is an estimate) or a rankings dimension (0-1 score such as energy or entropy). strict keeps only reported figures. Same locks as the rankings board: without a Member key, values past the free top rows and Member dimensions are withheld. Public.

PublicMCP tool

Parameters

  • metricenumrequired

    A rankings dimension (0-1 score) or a figure (revenue, employees, funding)

    energyeconomictemporalhumanpowerinformationentropytechnicalscalespatialrevenueemployeesfunding
  • industrystringoptional

    Taxonomy key (sector, industry or segment); includes everything under it

    max 80 chars
  • regionstringoptional

    Region word, e.g. US or Texas

    max 120 chars
  • kindstringoptional

    Organization kind, e.g. company, nonprofit, government

    max 40 chars
  • sizestringoptional

    Size band, e.g. 51-200

    max 40 chars
  • modelstringoptional

    Business model key

    max 40 chars
  • strictbooleanoptional

    Only well-evidenced numbers: a broad map, or a reported (not estimated) figure

  • fieldsstringoptional

    Keys to keep per item, comma-separated; aliases values, sources, counts, confidence

    max 300 chars
  • limitnumberoptional

    Items per response, 1-200 (the budget may stop earlier)

    ≥ 1≤ 200
  • cursorstringoptional

    next_cursor from the previous response

    max 2000 chars
  • viewenumoptional

    compact (default), full (every field) or v1 (the old shape, unpaged, refused over 64 KB)

    compactfullv1
  • budgetnumberoptional

    Token budget, 200-8000 (default 2000, 6000 for full)

    ≥ 200≤ 8000

Example call

Agents call tools by name; you rarely write this by hand. It is here so you can test the server from a shell or your own code.

{
  "name": "top",
  "arguments": {
    "metric": "revenue",
    "industry": "staffing",
    "limit": 2
  }
}

Response

The result is one text content block holding this JSON (abbreviated here). Errors come back with isError: true and a message such as Error 401: … or Invalid input: ….

Response
{
  "metric": "revenue",
  "total": 120,
  "items": [
    {
      "h": "org:randstad-1c2d3e4f",
      "ref": "randstad-1c2d3e4f",
      "name": "Randstad",
      "domain": "randstad.com",
      "industry": "staffing",
      "rank": 1,
      "value": 27000000000,
      "year": 2025,
      "url": "https://www.randstad.com/investors/annual-report-2025",
      "source": "Randstad annual report",
      "mapped": 13
    },
    {
      "h": "org:adecco-5a6b7c8d",
      "ref": "adecco-5a6b7c8d",
      "name": "Adecco",
      "domain": "adecco.com",
      "industry": "staffing",
      "rank": 2,
      "value": 25000000000,
      "year": 2025,
      "mapped": 11
    }
  ],
  "truncated": true,
  "next_cursor": "eyJrIjpb…",
  "hint": "More: call top with cursor=<next_cursor>.",
  "tokens": 150
}

Over REST

The same call without MCP: GET/api/v1/top

PreviousaggregateNext diff