System Atlas
SystemAtlas

list_listings

Open marketplace listings: owners offering access to their verified map, filtered by words (query), the part licensed (people, process, software, data, decisions, figures, screens or full), industry, pricing (once or yearly) and bids, sorted new, price-asc, price-desc or parts. Each row has the listing id, title, organization and its registry ref, the scope, how many confirmed parts a grant delivers, price (minor units), currency, pricing and term. Paged (cursor); view=full adds the facet counts. Needs a key.

Needs a keyMCP tool

Parameters

  • querystringoptional

    Words in the listing's title, summary, organization or domain

    max 100 chars
  • partstringoptional

    Only listings licensing this part: people, process, software, data, decisions, figures, screens, or full

    max 20 chars
  • industrystringoptional

    Industry key

    max 80 chars
  • pricingenumoptional
    onceyearly
  • bidsbooleanoptional

    Only listings that take bids

  • sortenumoptional

    Default new

    newprice-ascprice-descparts
  • 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": "list_listings",
  "arguments": {
    "part": "software",
    "sort": "parts"
  }
}

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
{
  "total": 31,
  "page": 1,
  "cols": [
    "id",
    "title",
    "org",
    "ref",
    "domain",
    "industry",
    "scope",
    "parts",
    "price",
    "currency",
    "pricing",
    "termDays",
    "bids"
  ],
  "rows": [
    [
      "5b0e2c1a-7d4f-4e8a-9c3b-1f2e3d4c5b6a",
      "Acme's software stack, with screenshots",
      "Acme Builders",
      "acme-builders-3f2a9c1d",
      "acmebuilders.example",
      "construction",
      [
        "software",
        "screens"
      ],
      42,
      90000,
      "usd",
      "yearly",
      365,
      true
    ]
  ],
  "url": "https://systematlas.org/marketplace/browse",
  "truncated": true,
  "next_cursor": "eyJwZyI6Mn0",
  "hint": "More listings: call list_listings with the same filters and cursor=<next_cursor>.",
  "tokens": 170
}

Over REST

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

PreviouscoverageNext registry_guide