get_timeseries

Arguments

Read time series

Use this JSON-RPC call through an initialized MCP client. Replace example values with your actual website, dates or confirmed setup details.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_timeseries",
    "arguments": {
      "site": "site_example",
      "from": "2026-10-01",
      "to": "2026-10-07",
      "compare": "none"
    }
  }
}

Decoded result

Illustrative JSON parsed from the result’s text block.

{
  "site": {
    "id": "site_example",
    "domain": "shop.example.com",
    "currency": "USD"
  },
  "period": {
    "from": "2026-10-01T00:00:00.000Z",
    "to": "2026-10-08T00:00:00.000Z",
    "label": "Custom",
    "compare": "none",
    "attribution_model": "first_touch"
  },
  "granularity": "daily",
  "points": [
    {
      "label": "Oct 1",
      "visitors": 100,
      "revenue": 20000,
      "orders": 4,
      "top_source": "Google Organic",
      "comparison_visitors": null,
      "comparison_revenue": null
    }
  ]
}

Result fields

The decoded data follows the time series response contract, without the REST envelope.

{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"site\": {\n    \"id\": \"site_example\",\n    \"domain\": \"shop.example.com\",\n    \"currency\": \"USD\"\n  },\n  \"period\": {\n    \"from\": \"2026-10-01T00:00:00.000Z\",\n    \"to\": \"2026-10-08T00:00:00.000Z\",\n    \"label\": \"Custom\",\n    \"compare\": \"none\",\n    \"attribution_model\": \"first_touch\"\n  },\n  \"granularity\": \"daily\",\n  \"points\": [\n    {\n      \"label\": \"Oct 1\",\n      \"visitors\": 100,\n      \"revenue\": 20000,\n      \"orders\": 4,\n      \"top_source\": \"Google Organic\",\n      \"comparison_visitors\": null,\n      \"comparison_revenue\": null\n    }\n  ]\n}"
    }
  ]
}

Behavior and limits

Money is integer cents in site.currency. Percentages use a 0–100 scale.

Long daily ranges can be grouped weekly, and long weekly ranges monthly. Inspect returned points rather than assuming one point per day.

Larger-site results may also include from, to, gross_sales and refunds per point and a coverage object.

Report tools return the report data directly inside MCP text content. They do not add the REST status/data envelope.

With multiple websites and no site argument, this report tool returns needs_site: true and the available websites. Choose a real website and call it again.

Related documentation