System Atlas
SystemAtlas

Contribute to the registry

Add sourced findings about any organization, with your agent or by hand, and how they are scored.

The registry is built by everyone who uses it. When your agent researches a competitor, a supplier, a peer in your industry or an organization in a different industry altogether, what it finds on the open web can go into the public record for that organization, with its source. You get credit on the organization’s history, and the next person who looks it up starts from your work.

The one rule: every fact has a source
A contribution is a fact plus the public page it comes from and the words on that page that state it. No source, no contribution. Leaked, private or paywalled material is never accepted, and nothing you keep private in your own workspace is ever shared.

  1. Find it on the open web

    Point your agent at what you want to learn, for example: “Read rival.example’s careers and product pages and tell me how they dispatch crews.” Use search first: if the organization or the primitive already exists, attach to it instead of creating a new one.

  2. Submit with source and quote

    contribute takes the organization’s registry ref and up to 20 items. Each item has a label, an optional primitive and values, the source URL and the quote: words copied exactly from that page.

    curl -X POST "https://systematlas.org/api/v1/contributions" \
  -H "Authorization: Bearer sa_…" \
  -H "content-type: application/json" \
  -d '{"company":"rival-co-1a2b3c4d","items":[{"label":"Uses ServiceTitan","source":{"url":"https://rival.example/careers"},"quote":"experience with ServiceTitan"}]}'
    Response
    {
  "company": "rival-co-1a2b3c4d",
  "items": [
    {
      "label": "Uses ServiceTitan",
      "source": {
        "url": "https://rival.example/careers"
      },
      "quote": "experience with ServiceTitan"
    }
  ]
}

  3. It is checked and scored

    Each item gets a trust score from 0 to 100, with its reasons:

    • The source loads, is not a look-alike or parked domain, and the quote is on the page.
    • It agrees with what is already known, or says why not.
    • Your record: how many of your past contributions were accepted.
    • How specific it is: names, numbers and dates score higher.

    75 or more appears on the public profile as a draft the organization can review. Lower scores wait for the organization’s owner, or for the System Atlas team when nobody has claimed it.

  4. Something no primitive covers

    If what you found fits nothing in the industry’s structure, propose a primitive with propose_primitive, with at least one source and quote. Seen at three or more organizations, it is ready to be added to the next version of the schema.

    curl -X POST "https://systematlas.org/api/v1/proposals" \
  -H "Authorization: Bearer sa_…" \
  -H "content-type: application/json" \
  -d '{"industry":"staffing","label":"Shift marketplace","layer":"software","description":"A self-serve app where vetted workers claim open shifts.","sources":[{"url":"https://rival.example/workers","quote":"Pick up open shifts from your phone"}]}'

  5. Go deeper with research credits

    Any signed-in user can also spend research credits to research the parts of an organization or an industry that are not mapped yet. Its public findings join the registry the same way, with the same evidence rules, and credit you.

Your own research counts too
When you research companies for yourself, in your workspace, findings that rest on public sources can be shared to the registry. Your workspace’s private data, uploads about your own company and anything you mark private never are.
PreviousResearch a competitorNext Search and place data with your agent