# On-demand reports (https://sellersheetai.com/docs/mcp-api/workflows/reports-ondemand)

> Request a report straight from Amazon when the synced copy is not enough — create, wait, download — and set up recurring report schedules.



<Callout title="In short">
  For any report type Amazon offers, your agent asks Amazon to build it, polls until it is done and reads the document. Use it for reports that are not synced, or when you need the very latest data.
</Callout>

## Create, wait, download [#create-wait-download]

<Steps>
  <Step>
    ### Ask for the report [#ask-for-the-report]

    `reports_createReport` submits the request with the report type and date range. Your agent picks the report type from what you describe — "the All Listings report", "Brand Analytics search query performance".
  </Step>

  <Step>
    ### Wait for Amazon [#wait-for-amazon]

    Amazon builds reports in the background, from seconds to many minutes. `reports_getReport` checks the status and, once it is done, downloads the document.
  </Step>

  <Step>
    ### Reuse what exists [#reuse-what-exists]

    `reports_getReports` lists reports Amazon already built for the store; `reports_cancelReport` stops one still in the queue.
  </Step>
</Steps>

## Recurring reports [#recurring-reports]

`reports_createReportSchedule` asks Amazon to build a report on a fixed cadence; `reports_getReportSchedules`, `reports_getReportSchedule` and `reports_cancelReportSchedule` list, read and stop schedules.

## Try asking [#try-asking]

> "Request a fresh inventory report from Amazon."

> "Pull the Brand Analytics search query performance report — what's my click share on these terms?"

> "Download my latest settlement report."

## A request, both ways [#a-request-both-ways]

**MCP** — you ask: "Get me a fresh All Listings report." Your agent calls `reports_createReport`, then `reports_getReport` until it is done.

<ToolCall tool="reports_createReport" args="{ reportType: &#x22;GET_MERCHANT_LISTINGS_ALL_DATA&#x22; }" />

<Callout type="warn" title="Write access for schedules">
  Creating or cancelling a recurring schedule changes your seller account's settings, so the store needs write access (see [Stay in control](/docs/mcp-api/control)). One-off report requests and downloads are reads.
</Callout>

## Tools on this page [#tools-on-this-page]

<ToolList domains="[&#x22;reports&#x22;]" />

## FAQ [#faq]

### Synced or on demand? [#synced-or-on-demand]

Synced first — it is instant. See [Synced reports](/docs/mcp-api/workflows/reports).

### How does my agent know a report's fields? [#how-does-my-agent-know-a-reports-fields]

The `amazon-report` skill carries the report types, options and field names of the common reports. See [Install the skills](/docs/start/skills).

### Is there a GraphQL option? [#is-there-a-graphql-option]

Yes — [Data Kiosk](/docs/mcp-api/workflows/datakiosk).