sparkx-query-ads-performance SKILL.md skillA

sparkx-query-ads-performance from sparkxai/sparkxai-mcp is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add sparkxai/sparkxai-mcp/sparkx-query-ads-performance@v1.4.9

Pins v1.4.9 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
sparkxai/sparkxai-mcp
Path
skills/sparkx-query-ads-performance/SKILL.md
Versions recorded
15
Latest version
v1.4.9, committed Nov 3, 2026
First version recorded
Aug 25, 2026
Size
41,513 bytes
Repository stars
19
License
none declared

Query advertising performance metrics: spend, clicks, sales, ACOS, ROAS, etc. For analyzing ad performance, comparing time periods, ranking by entity, trend analysis. Keywords: ad data, performance, spend analysis, ACOS, sales, conversion rate, campaign performance, adGroup comparison, keyword analysis, ASIN ads, search term report, daily/weekly/monthly trends, top N ranking, week-over-week, year-over-year, hourly data, by hour, intraday, AMS, Amazon Marketing Stream, keyword placement…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Query Ads Performance Skill

## MCP Tool

This skill maps to MCP tool: **`get_ads_perf`**. Required scope: `amazon_sa_performance_data:read`.

Profile scope is resolved from the authenticated bearer token. `profileIds` is **required** — always call `get_user_authorized_context` first to obtain authorized profile IDs, then pass one or more into `profileIds`. **Every requested ID must be authorized: one unauthorized value fails the entire call** with `invalid_params` / `Requested profileIds contain unauthorized values` — nothing is silently dropped and you never get a partial result (see Platform-Wide Rules below). Take the IDs verbatim from `get_user_authorized_context`; don't hand-type them or reuse them from an earlier session. If the user didn't specify a store, pass **all** authorized `profileIds`. Never pass `tenantId` or `userId`; the server derives them from the token.

**`userContext` (required)**: Must pass a non-empty string on every call. Preserve the user's original query as much as possible, plus the agent's reason for calling this tool. Summarize if too long, max 100 characters.

## Platform-Wide Rules
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add sparkxai/sparkxai-mcp/sparkx-query-ads-performance@sha256:cb25eaa0b4a8ff0a

The line at the top of this page pins the label v1.4.9, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_i3wtcniumo3qridx.svg)](https://markdownregistry.com/a/art_i3wtcniumo3qridx)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 15 versions of this file, between Aug 25, 2026 and Nov 3, 2026, about one every 5 days.

versioncommittedcommitsizeaudit
v1.4.9 latest2026-11-03 ca50742 41,513 BA view · diff
v1.4.82026-10-27 0ba4904 40,407 BA view · diff
v1.4.72026-10-22 223b6df 39,301 BA view · diff
v1.4.62026-10-21 edc9390 39,301 BA view · diff
v1.4.52026-10-20 902e7d0 38,021 BA view · diff
v1.4.32026-10-13 4d4d72e 38,021 BA view · diff
v1.4.22026-09-23 69e5126 38,490 BA view · diff
v1.4.22026-09-23 06df073 34,355 BA view · diff
v1.4.12026-09-18 1b3f28f 33,104 BA view · diff
v1.4.02026-09-17 387383b 29,106 BA view · diff
v1.3.02026-09-08 87fbf11 24,804 BA view · diff
v1.2.12026-08-28 41d644d 23,922 BA view · diff
v1.2.02026-08-28 888a421 23,597 BA view · diff
v1.2.02026-08-27 c170f96 23,020 BA view · diff
v1.1.02026-08-25 e9f215e 22,931 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (41513 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

sparkxai/sparkxai-mcp · 19 stars · license none declared · pushed 2026-11-03 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_i3wtcniumo3qridx
GET https://markdownregistry.com/api/v1/resolve?ref=sparkxai/sparkxai-mcp/sparkx-query-ads-performance
GET https://markdownregistry.com/api/v1/blob/cb25eaa0b4a8ff0a69bdb43fbbce73e23d41e775cf343293fb01c9152e127bde

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from sparkxai/sparkxai-mcp

sparkx-ads-structure-analysis SKILL.md skill
sparkxai/sparkxai-mcp · skills/sparkx-ads-structure-analysis/SKILL.md · Analyze how ad spend and efficiency break down across a structural dimension — campaign type (SP/SB/SD)…
v1.1.6 · audit A · 19 stars
sparkx-create-ai-group SKILL.md skill
sparkxai/sparkxai-mcp · skills/sparkx-create-ai-group/SKILL.md · Create a NEW AI managed group (托管组) for Amazon Sponsored ads and place campaigns under it when required. Routes by ad…
v1.2.4 · audit A · 19 stars
sparkx-create-campaign SKILL.md skill
sparkxai/sparkxai-mcp · skills/sparkx-create-campaign/SKILL.md · Create new Amazon Sponsored Products campaigns in bulk through `create_sp_sb_campaign`, or add ad groups to an existing…
v1.0.5 · audit A · 19 stars
sparkx-delete-ai-group SKILL.md skill
sparkxai/sparkxai-mcp · skills/sparkx-delete-ai-group/SKILL.md · Delete (archive) an AI managed group (托管组) itself - SD, SP, or SB - releasing its campaigns or migrating them to…
v1.0.9 · audit A · 19 stars
sparkx-edit-ads SKILL.md skill
sparkxai/sparkxai-mcp · skills/sparkx-edit-ads/SKILL.md · Edit live Amazon Sponsored ad entities in bulk through the single tool `batch_update_ads` - campaign daily budget /…
v1.1.7 · audit B · 19 stars
sparkx-edit-ai-group SKILL.md skill
sparkxai/sparkxai-mcp · skills/sparkx-edit-ai-group/SKILL.md · Modify an EXISTING AI managed group (托管组) for Amazon Sponsored ads - change target ACOS/ROAS, budget, turn its AI…
v1.2.4 · audit A · 19 stars
sparkx-monthly-ads-report SKILL.md skill
sparkxai/sparkxai-mcp · skills/sparkx-monthly-ads-report/SKILL.md · Generate a monthly ad performance recap for ads managers / account managers at month-end. Includes full-month KPIs (MoM…
v1.2.2 · audit A · 19 stars
sparkx-product-diagnosis SKILL.md skill
sparkxai/sparkxai-mcp · skills/sparkx-product-diagnosis/SKILL.md · Diagnose product-level (ASIN) health: rank products by spend/sales/ACOS, segment the catalog into a portfolio tier…
v1.2.3 · audit A · 19 stars
sparkx-promo-reset SKILL.md skill
sparkxai/sparkxai-mcp · skills/sparkx-promo-reset/SKILL.md · After a promotion (Prime Day, Prime Big Deal Days, Black Friday / Cyber Monday, holiday events), find every bid…
v1.0.4 · audit A · 19 stars
sparkx-query-entity-metadata SKILL.md skill
sparkxai/sparkxai-mcp · skills/sparkx-query-entity-metadata/SKILL.md · Query advertising entity metadata: name, status, configuration, settings (no time range or metrics). For finding entity…
v1.4.9 · audit A · 19 stars
sparkx-query-operation-log SKILL.md skill
sparkxai/sparkxai-mcp · skills/sparkx-query-operation-log/SKILL.md · Query SparkX AI platform operation logs: user and AI action history on ad entities. For tracking change history…
v1.3.8 · audit A · 19 stars
sparkx-search-term-diagnosis SKILL.md skill
sparkxai/sparkxai-mcp · skills/sparkx-search-term-diagnosis/SKILL.md · Diagnose where ad spend goes at the search-term level: tag every search term (keyword vs ASIN, branded vs non-branded…
v1.0.4 · audit A · 19 stars

Every file in sparkxai/sparkxai-mcp

Browse by kind, by grade A, or by owner.