System Atlas
SystemAtlas

diff

What one organization has that another lacks, by primitive (side a or b, with up to five of its components), then primitives both have where values differ. Registry refs, or two company slugs of a workspace (with a key). Summary counts first; paged at the token budget. Public for registry refs.

PublicMCP tool

Parameters

  • astringrequired

    Registry ref, or a company slug when workspace is given

    min 1 charmax 200 chars
  • bstringrequired

    Registry ref, or a company slug when workspace is given

    min 1 charmax 200 chars
  • workspacestringoptional

    Compare two companies of this workspace instead (needs a key)

  • 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": "diff",
  "arguments": {
    "a": "instawork-0a1b2c3d",
    "b": "gigsmart-4e5f6a7b"
  }
}

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
{
  "a": {
    "id": "instawork-0a1b2c3d",
    "name": "Instawork",
    "prims": 18
  },
  "b": {
    "id": "gigsmart-4e5f6a7b",
    "name": "GigSmart",
    "prims": 15
  },
  "only_a": 5,
  "only_b": 2,
  "shared": 13,
  "differ": 1,
  "items": [
    {
      "h": "prim:worker_vetting",
      "l": "Worker vetting",
      "part": "supply",
      "side": "a",
      "a": [
        "Background checks"
      ]
    },
    {
      "h": "prim:payroll",
      "l": "Payroll",
      "part": "back_office",
      "side": "both",
      "vals": [
        [
          "frequency",
          "Weekly",
          "Daily"
        ]
      ]
    }
  ],
  "hint": "Call get_organization ref=instawork-0a1b2c3d with node=prim:worker_vetting to see what Instawork runs there.",
  "tokens": 170
}

Over REST

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

PrevioustopNext coverage