Research a competitor

Over MCP, ask your agent: “Add Rival Co (rival.example) to acme-builders, research it and compare it with us.” It calls the tools below. Over REST, the same steps:

1. Add the competitor

   add_company with a name and website. Keep the slug it returns.

   curlTypeScriptPython

   Copy

   curl -X POST "https://systematlas.org/api/v1/workspaces/acme-builders/companies" \
     -H "Authorization: Bearer sa_…" \
     -H "content-type: application/json" \
     -d '{"name":"Rival Co","website":"https://rival.example"}'

2. Start research

   research_company returns a run id straight away; the run continues in the background. It spends research credits: see Research and credits.

   curlTypeScriptPython

   Copy

   curl -X POST "https://systematlas.org/api/v1/workspaces/acme-builders/companies/rival-co/research" \
     -H "Authorization: Bearer sa_…" \
     -H "content-type: application/json" \
     -d '{"focus":"their dispatch software"}'

3. Poll the run

   Call get_research every 10 to 20 seconds until status is done or failed.

   curlTypeScriptPython

   Copy

   curl "https://systematlas.org/api/v1/workspaces/acme-builders/research/8f0c2a4e-1b7d-4c55-9a8e-3d2f6b1c0e91" \
     -H "Authorization: Bearer sa_…"

   Response

   Copy

   {
     "id": "8f0c2a4e-1b7d-4c55-9a8e-3d2f6b1c0e91",
     "status": "done",
     "website": "https://rival.example",
     "pagesRead": 14,
     "componentsWritten": 38,
     "valuesWritten": 61,
     "costUsd": 0.21,
     "error": null
   }

4. Compare

   compare lines the client up against the competitor, one row per primitive, biggest differences first.

   curlTypeScriptPython

   Copy

   curl "https://systematlas.org/api/v1/workspaces/acme-builders/compare?with=rival-co" \
     -H "Authorization: Bearer sa_…"