System Atlas
SystemAtlas

optimal_engine_send

Send the workspace's company maps (components with values, flows, sources, confidence, provenance) to its connected cloud Optimal Engine. Each item becomes engine evidence plus a pending claim for review. Fails with 409 for a local engine: use optimal_engine_export then. Needs an editor key.

Write · editor keyMCP tool

Parameters

  • workspacestringrequired

    Workspace slug

  • companystringoptional

    Company slug; omit for every company (send, export) or the client (pull, import). For pull and import a domain adds the company once.

    max 200 chars

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": "optimal_engine_send",
  "arguments": {
    "workspace": "acme-builders"
  }
}

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
{
  "sent": 42,
  "skipped": 0
}

Over REST

The same call without MCP: POST/api/v1/workspaces/:slug/optimal-engine/send

Previouspropose_primitiveNext optimal_engine_pull