xnurta-query-ads-performance SKILL.md skillA

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

Install it, pinned
mdr add xnurta/xnurta-mcp/xnurta-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
xnurta/xnurta-mcp
Path
skills/xnurta-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
14
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 xnurta/xnurta-mcp/xnurta-query-ads-performance@sha256:374f724e8f74e4f6

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_v6wef7ngn7obucqa.svg)](https://markdownregistry.com/a/art_v6wef7ngn7obucqa)

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 641f204 41,513 BA view · diff
v1.4.82026-10-27 a5809ec 40,407 BA view · diff
v1.4.72026-10-22 dd28221 39,301 BA view · diff
v1.4.62026-10-21 f5d271f 39,301 BA view · diff
v1.4.52026-10-20 c1749c4 38,021 BA view · diff
v1.4.32026-10-13 a02926e 38,021 BA view · diff
v1.4.22026-09-23 6a94284 38,021 BA view · diff
v1.4.22026-09-23 5d9f33d 33,895 BA view · diff
v1.4.12026-09-18 840438d 32,660 BA view · diff
v1.4.02026-09-17 2d791b3 28,721 BA view · diff
v1.3.02026-09-08 9a6a3a3 24,482 BA view · diff
v1.2.12026-08-28 8589622 23,611 BA view · diff
v1.2.02026-08-28 de3ebef 23,288 BA view · diff
v1.2.02026-08-27 ac16bb5 22,715 BA view · diff
v1.1.02026-08-25 a203c6d 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

xnurta/xnurta-mcp · 14 stars · license none declared · pushed 2026-11-03 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_v6wef7ngn7obucqa
GET https://markdownregistry.com/api/v1/resolve?ref=xnurta/xnurta-mcp/xnurta-query-ads-performance
GET https://markdownregistry.com/api/v1/blob/374f724e8f74e4f66efc6bd14cd633af4bb481cf978ac134e64f02a64f1ec183

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 xnurta/xnurta-mcp

xnurta-ads-structure-analysis SKILL.md skill
xnurta/xnurta-mcp · skills/xnurta-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 · 14 stars
xnurta-create-ai-group SKILL.md skill
xnurta/xnurta-mcp · skills/xnurta-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 type -…
v1.2.4 · audit A · 14 stars
xnurta-create-campaign SKILL.md skill
xnurta/xnurta-mcp · skills/xnurta-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 · 14 stars
xnurta-delete-ai-group SKILL.md skill
xnurta/xnurta-mcp · skills/xnurta-delete-ai-group/SKILL.md · Delete (archive) an AI managed group itself - SD, SP, or SB - releasing its campaigns or migrating them to another…
v1.0.9 · audit A · 14 stars
xnurta-edit-ads SKILL.md skill
xnurta/xnurta-mcp · skills/xnurta-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 · 14 stars
xnurta-edit-ai-group SKILL.md skill
xnurta/xnurta-mcp · skills/xnurta-edit-ai-group/SKILL.md · Modify an EXISTING AI managed group for Amazon Sponsored ads - change target ACOS/ROAS, budget, turn its AI on/off…
v1.2.4 · audit A · 14 stars
xnurta-monthly-ads-report SKILL.md skill
xnurta/xnurta-mcp · skills/xnurta-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 · 14 stars
xnurta-product-diagnosis SKILL.md skill
xnurta/xnurta-mcp · skills/xnurta-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 · 14 stars
xnurta-promo-reset SKILL.md skill
xnurta/xnurta-mcp · skills/xnurta-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 · 14 stars
xnurta-query-entity-metadata SKILL.md skill
xnurta/xnurta-mcp · skills/xnurta-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 · 14 stars
xnurta-query-operation-log SKILL.md skill
xnurta/xnurta-mcp · skills/xnurta-query-operation-log/SKILL.md · Query Xnurta platform operation logs: user and AI action history on ad entities. For tracking change history, auditing…
v1.3.8 · audit A · 14 stars
xnurta-search-term-diagnosis SKILL.md skill
xnurta/xnurta-mcp · skills/xnurta-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 · 14 stars

Every file in xnurta/xnurta-mcp

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