← AdAgntCONTENT HISTORY

Update to AdAgnt

Snapshot Nov 16, 2026 · 18:12 UTC · version 1.0.2

Collection source: downloaded plugin package.

WHAT CHANGED

Payment or plan references changed

Skill instructions — Now says: 352 tools across eight ad platforms. Most failed calls are not hard problems — - **`get_roas_estimates` throws without saved revenue assumptions.** Check ...

Observed in published text. Live prices and checkout terms have not been verified by this change.

Save AdAgnt and check future changes in Following.

Up to 3 plugins free · no card required.

All fields and original values.

Skill instructions

Before

Nov 2, 2026 · 06:11 UTC

348 tools across eight ad platforms. Most failed calls are not hard problems — - **`get_true_roas` throws without a revenue source.** Check `list_revenue_sources` first; if empty, propose `connect_revenue_source` (GA4, Shopify, Strip...

After

Nov 16, 2026 · 18:12 UTC

352 tools across eight ad platforms. Most failed calls are not hard problems — - **`get_roas_estimates` throws without saved revenue assumptions.** Check `list_revenue_sources` first; if empty, propose `set_revenue_assumptions` (a pr...

Compare saved observations

Download comparison JSON

SKILL.md text changes

− removed · + added

--- before
+++ after
@@ -5,7 +5,7 @@
 
 # AdAgnt tool-call contract
 
-348 tools across eight ad platforms. Most failed calls are not hard problems —
+352 tools across eight ad platforms. Most failed calls are not hard problems —
 they are the same handful of avoidable mistakes. This is that list.
 
 ## 1. Resolve the account before anything else
@@ -46,10 +46,12 @@
 
 ## 3. Order of operations that actually matters
 
-- **`get_true_roas` throws without a revenue source.** Check
-  `list_revenue_sources` first; if empty, propose `connect_revenue_source`
-  (GA4, Shopify, Stripe, Klaviyo — it backfills 90 days) and wait for approval.
-  Do not call it and report the error as a finding.
+- **`get_roas_estimates` throws without saved revenue assumptions.** Check
+  `list_revenue_sources` first; if empty, propose `set_revenue_assumptions`
+  (a provider label plus the user's average order value — nothing is connected
+  to GA4, Shopify, Stripe or Klaviyo; revenue is modelled as conversions ×
+  order value over 90 days) and wait for approval. Do not call it and report
+  the error as a finding.
 - **Keyword research before campaign creation.** `research_keywords` returns
   real volumes, competition and bid ranges. Inventing keywords wastes the
   user's money.
@@ -67,7 +69,7 @@
 | `NO_ACCOUNT` | No connected account for that platform | Offer to connect it. |
 | `NOT_SUPPORTED` | The operation is not available on this driver | Not a bug. Say so plainly and stop. |
 | `PLATFORM_ERROR` | The ad platform itself rejected the call | Report the platform's reason. Do not retry a write. |
-| `QUOTA_EXCEEDED` | Monthly tool-call limit reached | Report the limit; `get_usage_status` shows plan and reset date. |
+| `QUOTA_EXCEEDED` | A monthly allowance was reached (free plan: 20 reads and 10 changes a month) | Report it. `get_usage_status` shows what is left and the reset date. |
 
 **Known `NOT_SUPPORTED`: AppLovin on a live account.** All writes throw, plus
 creative-set listing, asset listing and targeting search. Campaign reads and
@@ -90,9 +92,12 @@
 
 ## 6. Quota
 
-Metered per tool call, reads included. `get_usage_status` returns the plan,
-the monthly limit, the reset date, and the upgrade options. When quota is hit,
-tools stop cleanly — nothing is left half-changed.
+Every plan, free included, connects any number of ad accounts. The free plan
+allows 20 reads (reports, analysis, diagnostics) and 10 writes a month; paid
+plans raise both. `get_usage_status` returns the plan, this month's reads and
+writes so far, how many are left (null = no limit on this plan), the reset
+date, and the plans above. When an allowance is hit, the tool stops cleanly —
+nothing is left half-changed.
 
 ## 7. Results
 
Full technical diff · 1 changed fields

changed /skill_md_contents

BEFORE
"---\nname: adagnt-mcp\ndescription: The AdAgnt tool-call contract — how to resolve accounts, the hard argument limits that reject calls, what each error code means, and how quota works. Load this before calling AdAgnt tools so calls succeed first time instead of failing validation.\n---\n\n# AdAgnt tool-call contract\n\n348 tools across eight ad platforms. Most failed calls are not hard problems —\nthey are the same handful of avoidable mistakes. This is that list.\n\n## 1. Resolve the account before anything else\n\nTools operate on the user's *primary* account for a platform unless told\notherwise.\n\n- `list_connected_accounts` — what is connected, and which is primary\n- `get_connections_status` — whether a platform is linked and healthy\n- `switch_primary_account` — change the default (a write)\n\n**Amazon is different.** Every Amazon tool needs a **profile**, which pairs an\nadvertiser account with one marketplace. Call `amazon_list_profiles` first and\npass the profile explicitly. A US profile cannot see UK campaigns.\n\n**AppLovin** uses accounts from `applovin_list_accounts`.\n\nIf no account exists you get `NO_ACCOUNT`. In sandbox that usually means the\nplatform has not been touched yet — a demo account with 90 days of history is\ncreated the first time you use a platform, so simply proceeding will seed it.\n\n## 2. Hard argument limits that reject the call\n\nThese are enforced by schema. Getting them wrong returns `INVALID_ARGS` and\nnothing is created.\n\n| Tool | Field | Limit |\n|---|---|---|\n| `create_search_campaign` | `ad_groups[].headlines` | **exactly 15** |\n| `create_search_campaign` | `ad_groups[].descriptions` | **exactly 4** |\n| `create_search_campaign` | `ad_groups[].keywords` | **at least 5** |\n| `create_ad` | `headlines` | 3–15 |\n| `update_ad_headlines` | `headlines` | 3–15 |\n\n**Write the full set yourself.** Do not ask the user for fifteen headlines, and\nnever promise them a smaller number — Google itself allows 3–15 headlines and\n2–4 descriptions, so this constraint is AdAgnt's and stricter than the platform's.\n\n## 3. Order of operations that actually matters\n\n- **`get_true_roas` throws without a revenue source.** Check\n  `list_revenue_sources` first; if empty, propose `connect_revenue_source`\n  (GA4, Shopify, Stripe, Klaviyo — it backfills 90 days) and wait for approval.\n  Do not call it and report the error as a finding.\n- **Keyword research before campaign creation.** `research_keywords` returns\n  real volumes, competition and bid ranges. Inventing keywords wastes the\n  user's money.\n- **Assets before campaigns** on Meta and TikTok —\n  `validate_and_prepare_*_assets`, `upload_tiktok_images`, `validate_video`.\n- **Amazon:** profile → campaign → ad group → product ad → keywords. Each step\n  needs the ID from the one before.\n\n## 4. Error codes, and what each one actually means\n\n| Code | Meaning | What to do |\n|---|---|---|\n| `INVALID_ARGS` | Arguments failed validation | Read the message — it names the field. Fix and retry **once**. |\n| `NOT_FOUND` | The named object does not exist | List first, then act on a real ID. Never guess an ID. |\n| `NO_ACCOUNT` | No connected account for that platform | Offer to connect it. |\n| `NOT_SUPPORTED` | The operation is not available on this driver | Not a bug. Say so plainly and stop. |\n| `PLATFORM_ERROR` | The ad platform itself rejected the call | Report the platform's reason. Do not retry a write. |\n| `QUOTA_EXCEEDED` | Monthly tool-call limit reached | Report the limit; `get_usage_status` shows plan and reset date. |\n\n**Known `NOT_SUPPORTED`: AppLovin on a live account.** All writes throw, plus\ncreative-set listing, asset listing and targeting search. Campaign reads and\nthe whole reporting surface work. In sandbox all 36 AppLovin tools work. Tell\nthe user which they are hitting rather than implying a bug.\n\n## 5. Writes\n\n- Every write tool is annotated **destructive**, so ChatGPT raises its own\n  permission prompt. That prompt describes intent, not values — it is not a\n  substitute for showing the user the actual budget, keywords and ad copy.\n- **Never auto-retry a write after an ambiguous failure.** That is how\n  duplicate campaigns and double spend happen. Retry only `INVALID_ARGS`, which\n  provably did nothing.\n- **Verify with an independent read.** Do not report success or failure from\n  the write's own return value alone. A write here has come back looking like a\n  failure while the campaign was in fact created — reporting that verbatim\n  would have had the user create it a second time. Call the matching list/get\n  tool and report what you observed there.\n\n## 6. Quota\n\nMetered per tool call, reads included. `get_usage_status` returns the plan,\nthe monthly limit, the reset date, and the upgrade options. When quota is hit,\ntools stop cleanly — nothing is left half-changed.\n\n## 7. Results\n\nEvery tool returns a JSON object, and the MCP layer sends it as\n`structuredContent` alongside the text. Read fields directly rather than\nre-parsing the text block.\n"
AFTER
"---\nname: adagnt-mcp\ndescription: The AdAgnt tool-call contract — how to resolve accounts, the hard argument limits that reject calls, what each error code means, and how quota works. Load this before calling AdAgnt tools so calls succeed first time instead of failing validation.\n---\n\n# AdAgnt tool-call contract\n\n352 tools across eight ad platforms. Most failed calls are not hard problems —\nthey are the same handful of avoidable mistakes. This is that list.\n\n## 1. Resolve the account before anything else\n\nTools operate on the user's *primary* account for a platform unless told\notherwise.\n\n- `list_connected_accounts` — what is connected, and which is primary\n- `get_connections_status` — whether a platform is linked and healthy\n- `switch_primary_account` — change the default (a write)\n\n**Amazon is different.** Every Amazon tool needs a **profile**, which pairs an\nadvertiser account with one marketplace. Call `amazon_list_profiles` first and\npass the profile explicitly. A US profile cannot see UK campaigns.\n\n**AppLovin** uses accounts from `applovin_list_accounts`.\n\nIf no account exists you get `NO_ACCOUNT`. In sandbox that usually means the\nplatform has not been touched yet — a demo account with 90 days of history is\ncreated the first time you use a platform, so simply proceeding will seed it.\n\n## 2. Hard argument limits that reject the call\n\nThese are enforced by schema. Getting them wrong returns `INVALID_ARGS` and\nnothing is created.\n\n| Tool | Field | Limit |\n|---|---|---|\n| `create_search_campaign` | `ad_groups[].headlines` | **exactly 15** |\n| `create_search_campaign` | `ad_groups[].descriptions` | **exactly 4** |\n| `create_search_campaign` | `ad_groups[].keywords` | **at least 5** |\n| `create_ad` | `headlines` | 3–15 |\n| `update_ad_headlines` | `headlines` | 3–15 |\n\n**Write the full set yourself.** Do not ask the user for fifteen headlines, and\nnever promise them a smaller number — Google itself allows 3–15 headlines and\n2–4 descriptions, so this constraint is AdAgnt's and stricter than the platform's.\n\n## 3. Order of operations that actually matters\n\n- **`get_roas_estimates` throws without saved revenue assumptions.** Check\n  `list_revenue_sources` first; if empty, propose `set_revenue_assumptions`\n  (a provider label plus the user's average order value — nothing is connected\n  to GA4, Shopify, Stripe or Klaviyo; revenue is modelled as conversions ×\n  order value over 90 days) and wait for approval. Do not call it and report\n  the error as a finding.\n- **Keyword research before campaign creation.** `research_keywords` returns\n  real volumes, competition and bid ranges. Inventing keywords wastes the\n  user's money.\n- **Assets before campaigns** on Meta and TikTok —\n  `validate_and_prepare_*_assets`, `upload_tiktok_images`, `validate_video`.\n- **Amazon:** profile → campaign → ad group → product ad → keywords. Each step\n  needs the ID from the one before.\n\n## 4. Error codes, and what each one actually means\n\n| Code | Meaning | What to do |\n|---|---|---|\n| `INVALID_ARGS` | Arguments failed validation | Read the message — it names the field. Fix and retry **once**. |\n| `NOT_FOUND` | The named object does not exist | List first, then act on a real ID. Never guess an ID. |\n| `NO_ACCOUNT` | No connected account for that platform | Offer to connect it. |\n| `NOT_SUPPORTED` | The operation is not available on this driver | Not a bug. Say so plainly and stop. |\n| `PLATFORM_ERROR` | The ad platform itself rejected the call | Report the platform's reason. Do not retry a write. |\n| `QUOTA_EXCEEDED` | A monthly allowance was reached (free plan: 20 reads and 10 changes a month) | Report it. `get_usage_status` shows what is left and the reset date. |\n\n**Known `NOT_SUPPORTED`: AppLovin on a live account.** All writes throw, plus\ncreative-set listing, asset listing and targeting search. Campaign reads and\nthe whole reporting surface work. In sandbox all 36 AppLovin tools work. Tell\nthe user which they are hitting rather than implying a bug.\n\n## 5. Writes\n\n- Every write tool is annotated **destructive**, so ChatGPT raises its own\n  permission prompt. That prompt describes intent, not values — it is not a\n  substitute for showing the user the actual budget, keywords and ad copy.\n- **Never auto-retry a write after an ambiguous failure.** That is how\n  duplicate campaigns and double spend happen. Retry only `INVALID_ARGS`, which\n  provably did nothing.\n- **Verify with an independent read.** Do not report success or failure from\n  the write's own return value alone. A write here has come back looking like a\n  failure while the campaign was in fact created — reporting that verbatim\n  would have had the user create it a second time. Call the matching list/get\n  tool and report what you observed there.\n\n## 6. Quota\n\nEvery plan, free included, connects any number of ad accounts. The free plan\nallows 20 reads (reports, analysis, diagnostics) and 10 writes a month; paid\nplans raise both. `get_usage_status` returns the plan, this month's reads and\nwrites so far, how many are left (null = no limit on this plan), the reset\ndate, and the plans above. When an allowance is hit, the tool stops cleanly —\nnothing is left half-changed.\n\n## 7. Results\n\nEvery tool returns a JSON object, and the MCP layer sends it as\n`structuredContent` alongside the text. Read fields directly rather than\nre-parsing the text block.\n"
Full snapshot data
{
  "description": "The AdAgnt tool-call contract — how to resolve accounts, the hard argument limits that reject calls, what each error code means, and how quota works. Load this before calling AdAgnt tools so calls succeed first time instead of failing validation.",
  "included_files": [],
  "name": "adagnt-mcp",
  "skill_md_contents": "---\nname: adagnt-mcp\ndescription: The AdAgnt tool-call contract — how to resolve accounts, the hard argument limits that reject calls, what each error code means, and how quota works. Load this before calling AdAgnt tools so calls succeed first time instead of failing validation.\n---\n\n# AdAgnt tool-call contract\n\n352 tools across eight ad platforms. Most failed calls are not hard problems —\nthey are the same handful of avoidable mistakes. This is that list.\n\n## 1. Resolve the account before anything else\n\nTools operate on the user's *primary* account for a platform unless told\notherwise.\n\n- `list_connected_accounts` — what is connected, and which is primary\n- `get_connections_status` — whether a platform is linked and healthy\n- `switch_primary_account` — change the default (a write)\n\n**Amazon is different.** Every Amazon tool needs a **profile**, which pairs an\nadvertiser account with one marketplace. Call `amazon_list_profiles` first and\npass the profile explicitly. A US profile cannot see UK campaigns.\n\n**AppLovin** uses accounts from `applovin_list_accounts`.\n\nIf no account exists you get `NO_ACCOUNT`. In sandbox that usually means the\nplatform has not been touched yet — a demo account with 90 days of history is\ncreated the first time you use a platform, so simply proceeding will seed it.\n\n## 2. Hard argument limits that reject the call\n\nThese are enforced by schema. Getting them wrong returns `INVALID_ARGS` and\nnothing is created.\n\n| Tool | Field | Limit |\n|---|---|---|\n| `create_search_campaign` | `ad_groups[].headlines` | **exactly 15** |\n| `create_search_campaign` | `ad_groups[].descriptions` | **exactly 4** |\n| `create_search_campaign` | `ad_groups[].keywords` | **at least 5** |\n| `create_ad` | `headlines` | 3–15 |\n| `update_ad_headlines` | `headlines` | 3–15 |\n\n**Write the full set yourself.** Do not ask the user for fifteen headlines, and\nnever promise them a smaller number — Google itself allows 3–15 headlines and\n2–4 descriptions, so this constraint is AdAgnt's and stricter than the platform's.\n\n## 3. Order of operations that actually matters\n\n- **`get_roas_estimates` throws without saved revenue assumptions.** Check\n  `list_revenue_sources` first; if empty, propose `set_revenue_assumptions`\n  (a provider label plus the user's average order value — nothing is connected\n  to GA4, Shopify, Stripe or Klaviyo; revenue is modelled as conversions ×\n  order value over 90 days) and wait for approval. Do not call it and report\n  the error as a finding.\n- **Keyword research before campaign creation.** `research_keywords` returns\n  real volumes, competition and bid ranges. Inventing keywords wastes the\n  user's money.\n- **Assets before campaigns** on Meta and TikTok —\n  `validate_and_prepare_*_assets`, `upload_tiktok_images`, `validate_video`.\n- **Amazon:** profile → campaign → ad group → product ad → keywords. Each step\n  needs the ID from the one before.\n\n## 4. Error codes, and what each one actually means\n\n| Code | Meaning | What to do |\n|---|---|---|\n| `INVALID_ARGS` | Arguments failed validation | Read the message — it names the field. Fix and retry **once**. |\n| `NOT_FOUND` | The named object does not exist | List first, then act on a real ID. Never guess an ID. |\n| `NO_ACCOUNT` | No connected account for that platform | Offer to connect it. |\n| `NOT_SUPPORTED` | The operation is not available on this driver | Not a bug. Say so plainly and stop. |\n| `PLATFORM_ERROR` | The ad platform itself rejected the call | Report the platform's reason. Do not retry a write. |\n| `QUOTA_EXCEEDED` | A monthly allowance was reached (free plan: 20 reads and 10 changes a month) | Report it. `get_usage_status` shows what is left and the reset date. |\n\n**Known `NOT_SUPPORTED`: AppLovin on a live account.** All writes throw, plus\ncreative-set listing, asset listing and targeting search. Campaign reads and\nthe whole reporting surface work. In sandbox all 36 AppLovin tools work. Tell\nthe user which they are hitting rather than implying a bug.\n\n## 5. Writes\n\n- Every write tool is annotated **destructive**, so ChatGPT raises its own\n  permission prompt. That prompt describes intent, not values — it is not a\n  substitute for showing the user the actual budget, keywords and ad copy.\n- **Never auto-retry a write after an ambiguous failure.** That is how\n  duplicate campaigns and double spend happen. Retry only `INVALID_ARGS`, which\n  provably did nothing.\n- **Verify with an independent read.** Do not report success or failure from\n  the write's own return value alone. A write here has come back looking like a\n  failure while the campaign was in fact created — reporting that verbatim\n  would have had the user create it a second time. Call the matching list/get\n  tool and report what you observed there.\n\n## 6. Quota\n\nEvery plan, free included, connects any number of ad accounts. The free plan\nallows 20 reads (reports, analysis, diagnostics) and 10 writes a month; paid\nplans raise both. `get_usage_status` returns the plan, this month's reads and\nwrites so far, how many are left (null = no limit on this plan), the reset\ndate, and the plans above. When an allowance is hit, the tool stops cleanly —\nnothing is left half-changed.\n\n## 7. Results\n\nEvery tool returns a JSON object, and the MCP layer sends it as\n`structuredContent` alongside the text. Read fields directly rather than\nre-parsing the text block.\n"
}

SHA-256 of public snapshot: 7e035eda81a6a2830d15d161a75a912899172a4eab1bea16b1c1fd8fa9565879