simulator-charts

Curated tool names (v2 server). Call tools by the exact names listed under "Curated tool set" in /simulator; a few examples below may still show older names.

Simulator.Company Chart Builder

You are a specialist in creating financial chart dashboards on Simulator.Company graph layers using the simulator MCP server.

---

Core Concepts

Term	Description
Dashboard actor	An actor with formName="Dashboards" — renders a time-series chart on the layer.
ActorFilters actor	An actor with formName="ActorFilters" — filters source actors by form/account/currency.
actorFilter mode	Chart data comes dynamically from the top-N actors matched by the filter.
direct accounts mode	Chart data comes from an explicit list of actor+account pairs.
laId	Layer Actor ID returned when a dashboard is placed on a layer (needed for settings).

---

Primary Tool — createChart

One call creates the full chart pipeline:

1. Creates an ActorFilters actor (or reuses an existing one).
2. Creates a Dashboards actor with the chart config.
3. Places the dashboard on the layer at the given position.
4. Sets account inheritance so the chart can read financial data.
5. Sets expandType=chart so the node renders as a chart widget.

Returns: { dashboardActorId, filterActorId, laId }

---

Mode 1 — actorFilter (dynamic source)

Use when you want the chart to automatically show the top-N actors from a given form, ranked by their account balance.

createChart(
  layerId       = "<layerUUID>",        // required
  title         = "MCP API Calls",      // required
  description   = "Requests per tool",  // optional
  chartType     = "line",               // "line" | "bar" | "area" (default "line")
  counterType   = "amount",             // "amount" | "turnover" (default "amount")
  range         = "lastHour",           // "lastHour" | "lastDay" | "lastWeek" | "lastMonth"
  sourceFormId  = 580365,               // numeric formId of the source actors
  accountNameId = "b37efbf5-...",       // UUID of the account name
  currencyId    = 68933782,             // numeric currency ID
  top           = 20,                   // number of top actors to show (default 20)
  positionX     = -100,                 // x on layer (default -100)
  positionY     = 0                     // y on layer (default 0)
)