Skip to content
Amazon Ads Skills v0.2.1

Build the Right Amazon Ads Report

Translate familiar v3 report requests or an ad-hoc metric question into a validated Amazon Ads API v1 CreateReport request.

Validate before report creation
Example output visualization: Report request
Report request
skill output
Field
Status
campaign.name
valid
metric.totalCost
valid
adProduct.value
required
date.value
grain set
Primary input
Report family or business question
Primary output
Validated field list
Powered by
Amazon Ads MCP
Source contract
amazon-ads-reporting
Is this the right Skill?

Use it for a clear operating job.

Best for
  • Known v3 report equivalents
  • Ad-hoc fields and grain
  • v3-to-v1 reporting migrations
Use another path when

AMC analysis, DSP measurement workflows, or unsupported report families that do not map to Ads API v1.

Starter prompt

Start with the task, then add your scope.

Copy this into a connected client and replace the account, date, ASIN, or threshold details with yours.

Build a Sponsored Products campaign report for the last 30 days with campaign, cost, sales, clicks, impressions, and date grain. Validate every v1 field and the ad-product filter before creating it.
The Skill will request any required context or approval before guarded actions.
The outcome

A defined result, not a generic answer.

A ready-to-submit report request with the correct field grain, ad product filter, advertiser context, and known caveats.

Inputs
  • Report family or business question
  • Ad product and advertiser
  • Date range and required grain
Outputs
  • Validated field list
  • CreateReport JSON
  • Unsupported-field caveats
Workflow

The playbook your agent follows.

  1. 01

    Classify the request

    Match a known report family or switch to ad-hoc field discovery.

  2. 02

    Resolve account scope

    Separate the active profile from the advertiser account required by reporting.

  3. 03

    Validate fields

    Check identifiers, compatibility, periods, and the ad product filter.

  4. 04

    Create and retrieve

    Submit the report, retrieve its status, and hand off the download path.

Guardrails

What keeps the workflow dependable.

Ambiguous report names trigger clarification
Fields are validated before report quota is spent
Unsupported v3 reports are identified rather than approximated
Connected systems

The context and tools it coordinates.

Amazon Ads MCP
Ads API v1 reporting
Report field catalog
amazon-ads-reporting

Give your agent the complete playbook.

Connect Skills once, then start with the prompt above whenever this job comes up.