← OmnekyCONTENT HISTORY

Update to Omneky

Snapshot Oct 27, 2026 · 00:28 UTC · version 2.0.31

Collection source: downloaded plugin package.

WHAT CHANGED

Payment or plan references changed

Full description — Now says: get_account by name for remaining Omneky prepaid ad credits. Also plan entitlements and credit history. Use when the user asks how many ad credits remain,...

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

Save Omneky and check future changes in Following.

Up to 3 plugins free · no card required.

All fields and original values.

Full description

Before

Oct 24, 2026 · 13:12 UTC

get_billing_summary, get_credit_history, get_payment_method_summary, and get_checkout_session_status by name for the signed-in company's Omneky plan, credit ledger, card on file (brand and last four only), and an open Stripe Checkout ses...

After

Oct 27, 2026 · 00:28 UTC

get_account by name for remaining Omneky prepaid ad credits. Also plan entitlements and credit history. Use when the user asks how many ad credits remain, credit balance, credit history, out of credits, which plan, or card on file. Do no...

Skill instructions

Before

Oct 24, 2026 · 13:12 UTC

get_billing_summary, get_credit_history, get_payment_method_summary, and get_checkout_session_status by name for the signed-in company's Omneky plan, credit ledger, card on file (brand and last four only), and an open Stripe Checko...

After

Oct 27, 2026 · 00:28 UTC

get_account by name for remaining Omneky prepaid ad credits. Also plan entitlements and credit history. Use when the user asks how many ad credits remain, credit balance, credit history, out of credits, which plan, or card on file....

Compare saved observations

Download comparison JSON

SKILL.md text changes

− removed · + added

--- before
+++ after
@@ -1,148 +1,114 @@
 ---
 name: omneky-billing
 description: >-
-  Call get_billing_summary, get_credit_history,
-  get_payment_method_summary, and get_checkout_session_status by name
-  for the signed-in company's Omneky plan, credit ledger, card on file
-  (brand and last four only), and an open Stripe Checkout session. Read
-  only. Use when the user asks about their plan, credit history, recent
-  credit charges, out of credits, or card on file. Do not use for
-  campaign spend/ROAS (omneky-analytics-and-catalogue), competitor
-  analysis (omneky-competitor-analysis), A/B tests (omneky-ab-tests),
-  first-run onboarding (omneky-onboarding), agency (omneky-agency),
-  weekly marketing plans (omneky-marketing-plan), creating ads,
-  launching campaigns (omneky-launch-and-connect), or collecting card
-  numbers. Keywords: billing summary, plan, credit history, credits
-  used, out of credits, card on file, checkout status.
+  Call get_account by name for remaining Omneky prepaid ad
+  credits. Also plan entitlements and credit history. Use when the user asks how many ad credits remain,
+  credit balance, credit history, out of credits, which plan,
+  or card on file. Do not use for campaign spend/ROAS
+  (omneky-analytics-and-catalogue), competitor analysis
+  (omneky-competitor-analysis), A/B tests (omneky-ab-tests),
+  first-run onboarding (omneky-onboarding), agency
+  (omneky-agency), weekly marketing plans
+  (omneky-marketing-plan), creating ads, launching
+  campaigns (omneky-launch-and-connect), or collecting card numbers.
+  Keywords: ad credits, credit balance, remaining credits, how many
+  credits, credit history audit, top-up, plan, card on file.
 ---
 
-# Plan, credit history, and card on file (read only)
+# Ad credits and plan (read only)
 
-The connected Omneky MCP server exposes read-only billing on this
-listing. Call `get_billing_summary`, `get_credit_history`,
-`get_payment_method_summary`, and `get_checkout_session_status`
-**by those exact names**. There is no plan-upgrade, portal, or
-credit-balance tool on this listing.
-
-Never collect a PAN. Never invent a purchase, upgrade, or top-up
-tool. To add credits or change the plan, the user goes to the Omneky
-app (Ads Central).
-
-Handoff fields:
-[handoff-contract](../_shared/references/handoff-contract.md).
-Sourced ids (how to obtain / what to do if absent):
-[preconditions](../_shared/references/preconditions.md).
-Other intents:
-[capability-registry](../_shared/references/capability-registry.md).
-Write for:
-[marketer-persona](../_shared/references/marketer-persona.md).
-
-## Goal
-
-Answer plan, credit-history, card-on-file, and checkout-status
-questions from the live reads. Never collect a PAN.
-
-## Prerequisites
-
-| Need | Check | If missing |
-|---|---|---|
-| Plan and credit snapshot | `get_billing_summary` | Say the tool is missing; Omneky app |
-| Ledger | `get_credit_history` | Skip the audit line |
-| Card on file | `get_payment_method_summary` | Say the tool is missing; Omneky app |
-| Checkout started in the Omneky app | `get_checkout_session_status` | Ask them to check the Omneky app |
+Use this when the user asks how many ad credits remain, what they
+have spent credits on, which plan they are on, or what card is on
+file. One job: read-only billing answers.
+
+There is no upgrade, portal or checkout tool, and no payment links.
+
+<!-- host:begin name="stripe-redirect" -->
+Never collect a PAN. Never invent a purchase or upgrade tool, and never
+send payment, checkout or portal links. The user adds credits or
+changes plan in the Omneky app.
+<!-- host:end -->
 
-## Flow
+Handoff fields: [handoff-contract](../_shared/references/handoff-contract.md).
+Sourced ids: [preconditions](../_shared/references/preconditions.md).
+<!-- host:begin name="scan-tools-routing" -->
+Acceptance gates: [creative-quality-gates](../_shared/references/creative-quality-gates.md).
+Other intents: [capability-registry](../_shared/references/capability-registry.md).
+Write for: [marketer-persona](../_shared/references/marketer-persona.md).
+<!-- host:end -->
 
-Lead with the answer, one next step, and confidence. Do not narrate
-the billing tools unless one is missing.
+## Goal
 
-- **plan-and-credits.** `get_billing_summary` for the plan and the
-  credit snapshot it reports. Say what it returned; do not compute a
-  balance it did not report.
-- **credits-and-cost.** `quote_creative_credits` when they asked what
-  a generate, edit, or resize costs. Each image ad is 5 credits and
-  each multi-scene product video is 30.
-- **credit-history-audit.** `get_credit_history` as a dated ledger
-  (grants and charges), not a live balance.
-- **card-on-file.** `get_payment_method_summary` — brand and last
-  four only.
-- **checkout-status.** When the user says they finished a Stripe
-  Checkout they started in the Omneky app, call
-  `get_checkout_session_status` once with the session id they have.
+Show credits, the shortfall if any, and the credit history.
 
 ## When to use
 
-- Which plan, credit snapshot, credit history, recent charges
-- Card on file (brand / last four)
-- Status of a Checkout they started in the Omneky app
-- `credit_insufficient` after a creative or launch, when the user asks
-  what happened
+- Remaining credits, credit history, which plan, card on file
+- `credit_insufficient` after a creative or launch
 
 ## When not to use
 
 - Campaign spend, ROAS, or daily metrics (analytics skill)
-- Weekly marketing plan create / revise / poll / approve
-- Creating or launching ads
-- Upgrading the plan or buying credits (Omneky app)
+- Weekly marketing plans (`omneky-marketing-plan`)
+<!-- host:begin name="billing-creative-when-not" -->
+- Creating ads (`omneky-image-ads`) or launching them
+  (`omneky-launch-and-connect`)
+<!-- host:end -->
 - Collecting a card number
 
+## Prerequisites
+
+| Need | Check | If missing |
+|---|---|---|
+| Balance | `get_account` | Say the tool is missing; Omneky app |
+| Ledger | `get_account` (`include_credit_history=true`) | Skip the audit line |
+
 ## Call by name
 
-Call only names that appear on this session's `tools/list`; if one is
-missing, use the fallback at the end of this skill.
+Call only names on this session's `tools/list`.
 
 | User ask | Tool |
 |---|---|
-| which plan, Stripe flags, credit snapshot | `get_billing_summary` |
-| credit grants / usage ledger | `get_credit_history` |
-| card brand / last4 only | `get_payment_method_summary` |
-| after the user returns from a Checkout | `get_checkout_session_status` |
-| company record without the credit snapshot | `get_company` |
-| what a creative will cost | `quote_creative_credits` |
+| how many credits remain | `get_account` |
+| credit grants and usage ledger | `get_account` (`include_credit_history=true`) |
+| plan and credit snapshot | `get_account` |
+| which plans exist, buy credits, change plan | no tool: the user does it on omneky.com |
+| card brand and last4 | `get_account` |
+| company record | `get_account` |
 
-## credit_insufficient
+## Flow
 
-The render or launch did not start and nothing was charged. The server
-reports `required` and `balance`.
+1. Call the tool for the ask. Lead with the number, the shortfall if
+   any, and one next step.
+2. For "what will this cost": there is no quote tool. Say a paid run
+   uses credits and its result reports `credits_charged`; the amount
+   shows in `get_account` (`include_credit_history=true`). Never invent a figure.
+3. Present `get_account` (`include_credit_history=true`) as a dated ledger, not the balance.
+4. For plans, plan changes or top-ups, say the user buys credits or
+   changes plan on omneky.com (Ads Central).
 
-1. Tell the user the shortfall in one line.
-2. Credits and plan changes happen in the Omneky app (Ads Central).
-   There is no upgrade tool on this listing; do not invent one.
-3. Do not retry the job until they say they have added credits.
-
-## Prices
-
-The host decides whether to quote or ask before a paid call; there is
-no fixed confirm step. Each image ad costs 5 credits and each
-multi-scene product video costs 30 credits, charged when the job is
-submitted. `quote_creative_credits` returns exact amounts (edits,
-resizes, batches), including each line's `expected_credits` to pass
-back on the paid tool when that field is listed. Do not pass
-`expected_credits` for a figure you did not get from a quote.
-Creative procedure lives in `omneky-image-ads`,
-`omneky-product-video`, and `omneky-edit-and-resize`. See
-[creative-pricing-and-polling](../_shared/references/creative-pricing-and-polling.md).
+## credit_insufficient
 
-## If a billing tool is not available
+Nothing started and nothing was charged. Tell the user `required` and
+`balance` in one line and that credits are added in the Omneky app.
+Do not retry until they say they have enough.
 
-If this session cannot call a billing read, say the tool is not
-available in this session. Do **not** invent a balance, a purchase
-tool, or a claim that Omneky has no credits. The user can check
-credits and plan in the Omneky app (Ads Central).
+<!-- host:begin name="creative-quote-rules" -->
+Quote rules for creative jobs:
+[creative-pricing-and-polling](../_shared/references/creative-pricing-and-polling.md).
+<!-- host:end -->
 
 ## Failure and recovery
 
 Auth / 401 → `omneky-getting-started-and-failures` (host OAuth).
-`credit_insufficient` → nothing charged; the user can add credits in the Omneky app.
-`needs_user_decision` → `request_user_decision`; never dump JSON.
-Missing tool → say so; Omneky app. Do not invent it.
-Never ask for internal ids. Never silent-switch `brand_id`.
+A billing tool is missing → say so; the user checks in the Omneky app.
+Never invent a balance or a purchase tool.
+`needs_user_decision` → fill the missing detail and call again.
 
 <!-- host:begin name="capability-gaps-link" -->
 ## Gaps
 
-This connector cannot do comment/social inbox, landing pages,
-subtitle burn-in, email/SMS, organic scheduling, Meta Ad Library
-competitor ads, virtual try-on, or website builder. Decline those.
-See [capability-gaps](../_shared/references/capability-gaps.md).
+Decline social inbox, landing pages, subtitle burn-in, email/SMS,
+organic scheduling, Ad Library ads, try-on, and website builder
+([capability-gaps](../_shared/references/capability-gaps.md)).
 <!-- host:end -->
Full technical diff · 2 changed fields

changed /description

BEFORE
"Call get_billing_summary, get_credit_history, get_payment_method_summary, and get_checkout_session_status by name for the signed-in company's Omneky plan, credit ledger, card on file (brand and last four only), and an open Stripe Checkout session. Read only. Use when the user asks about their plan, credit history, recent credit charges, out of credits, or card on file. Do not use for campaign spend/ROAS (omneky-analytics-and-catalogue), competitor analysis (omneky-competitor-analysis), A/B tests (omneky-ab-tests), first-run onboarding (omneky-onboarding), agency (omneky-agency), weekly marketing plans (omneky-marketing-plan), creating ads, launching campaigns (omneky-launch-and-connect), or collecting card numbers. Keywords: billing summary, plan, credit history, credits used, out of credits, card on file, checkout status."
AFTER
"Call get_account by name for remaining Omneky prepaid ad credits. Also plan entitlements and credit history. Use when the user asks how many ad credits remain, credit balance, credit history, out of credits, which plan, or card on file. Do not use for campaign spend/ROAS (omneky-analytics-and-catalogue), competitor analysis (omneky-competitor-analysis), A/B tests (omneky-ab-tests), first-run onboarding (omneky-onboarding), agency (omneky-agency), weekly marketing plans (omneky-marketing-plan), creating ads, launching campaigns (omneky-launch-and-connect), or collecting card numbers. Keywords: ad credits, credit balance, remaining credits, how many credits, credit history audit, top-up, plan, card on file."

changed /skill_md_contents

BEFORE
"---\nname: omneky-billing\ndescription: >-\n  Call get_billing_summary, get_credit_history,\n  get_payment_method_summary, and get_checkout_session_status by name\n  for the signed-in company's Omneky plan, credit ledger, card on file\n  (brand and last four only), and an open Stripe Checkout session. Read\n  only. Use when the user asks about their plan, credit history, recent\n  credit charges, out of credits, or card on file. Do not use for\n  campaign spend/ROAS (omneky-analytics-and-catalogue), competitor\n  analysis (omneky-competitor-analysis), A/B tests (omneky-ab-tests),\n  first-run onboarding (omneky-onboarding), agency (omneky-agency),\n  weekly marketing plans (omneky-marketing-plan), creating ads,\n  launching campaigns (omneky-launch-and-connect), or collecting card\n  numbers. Keywords: billing summary, plan, credit history, credits\n  used, out of credits, card on file, checkout status.\n---\n\n# Plan, credit history, and card on file (read only)\n\nThe connected Omneky MCP server exposes read-only billing on this\nlisting. Call `get_billing_summary`, `get_credit_history`,\n`get_payment_method_summary`, and `get_checkout_session_status`\n**by those exact names**. There is no plan-upgrade, portal, or\ncredit-balance tool on this listing.\n\nNever collect a PAN. Never invent a purchase, upgrade, or top-up\ntool. To add credits or change the plan, the user goes to the Omneky\napp (Ads Central).\n\nHandoff fields:\n[handoff-contract](../_shared/references/handoff-contract.md).\nSourced ids (how to obtain / what to do if absent):\n[preconditions](../_shared/references/preconditions.md).\nOther intents:\n[capability-registry](../_shared/references/capability-registry.md).\nWrite for:\n[marketer-persona](../_shared/references/marketer-persona.md).\n\n## Goal\n\nAnswer plan, credit-history, card-on-file, and checkout-status\nquestions from the live reads. Never collect a PAN.\n\n## Prerequisites\n\n| Need | Check | If missing |\n|---|---|---|\n| Plan and credit snapshot | `get_billing_summary` | Say the tool is missing; Omneky app |\n| Ledger | `get_credit_history` | Skip the audit line |\n| Card on file | `get_payment_method_summary` | Say the tool is missing; Omneky app |\n| Checkout started in the Omneky app | `get_checkout_session_status` | Ask them to check the Omneky app |\n\n## Flow\n\nLead with the answer, one next step, and confidence. Do not narrate\nthe billing tools unless one is missing.\n\n- **plan-and-credits.** `get_billing_summary` for the plan and the\n  credit snapshot it reports. Say what it returned; do not compute a\n  balance it did not report.\n- **credits-and-cost.** `quote_creative_credits` when they asked what\n  a generate, edit, or resize costs. Each image ad is 5 credits and\n  each multi-scene product video is 30.\n- **credit-history-audit.** `get_credit_history` as a dated ledger\n  (grants and charges), not a live balance.\n- **card-on-file.** `get_payment_method_summary` — brand and last\n  four only.\n- **checkout-status.** When the user says they finished a Stripe\n  Checkout they started in the Omneky app, call\n  `get_checkout_session_status` once with the session id they have.\n\n## When to use\n\n- Which plan, credit snapshot, credit history, recent charges\n- Card on file (brand / last four)\n- Status of a Checkout they started in the Omneky app\n- `credit_insufficient` after a creative or launch, when the user asks\n  what happened\n\n## When not to use\n\n- Campaign spend, ROAS, or daily metrics (analytics skill)\n- Weekly marketing plan create / revise / poll / approve\n- Creating or launching ads\n- Upgrading the plan or buying credits (Omneky app)\n- Collecting a card number\n\n## Call by name\n\nCall only names that appear on this session's `tools/list`; if one is\nmissing, use the fallback at the end of this skill.\n\n| User ask | Tool |\n|---|---|\n| which plan, Stripe flags, credit snapshot | `get_billing_summary` |\n| credit grants / usage ledger | `get_credit_history` |\n| card brand / last4 only | `get_payment_method_summary` |\n| after the user returns from a Checkout | `get_checkout_session_status` |\n| company record without the credit snapshot | `get_company` |\n| what a creative will cost | `quote_creative_credits` |\n\n## credit_insufficient\n\nThe render or launch did not start and nothing was charged. The server\nreports `required` and `balance`.\n\n1. Tell the user the shortfall in one line.\n2. Credits and plan changes happen in the Omneky app (Ads Central).\n   There is no upgrade tool on this listing; do not invent one.\n3. Do not retry the job until they say they have added credits.\n\n## Prices\n\nThe host decides whether to quote or ask before a paid call; there is\nno fixed confirm step. Each image ad costs 5 credits and each\nmulti-scene product video costs 30 credits, charged when the job is\nsubmitted. `quote_creative_credits` returns exact amounts (edits,\nresizes, batches), including each line's `expected_credits` to pass\nback on the paid tool when that field is listed. Do not pass\n`expected_credits` for a figure you did not get from a quote.\nCreative procedure lives in `omneky-image-ads`,\n`omneky-product-video`, and `omneky-edit-and-resize`. See\n[creative-pricing-and-polling](../_shared/references/creative-pricing-and-polling.md).\n\n## If a billing tool is not available\n\nIf this session cannot call a billing read, say the tool is not\navailable in this session. Do **not** invent a balance, a purchase\ntool, or a claim that Omneky has no credits. The user can check\ncredits and plan in the Omneky app (Ads Central).\n\n## Failure and recovery\n\nAuth / 401 → `omneky-getting-started-and-failures` (host OAuth).\n`credit_insufficient` → nothing charged; the user can add credits in the Omneky app.\n`needs_user_decision` → `request_user_decision`; never dump JSON.\nMissing tool → say so; Omneky app. Do not invent it.\nNever ask for internal ids. Never silent-switch `brand_id`.\n\n<!-- host:begin name=\"capability-gaps-link\" -->\n## Gaps\n\nThis connector cannot do comment/social inbox, landing pages,\nsubtitle burn-in, email/SMS, organic scheduling, Meta Ad Library\ncompetitor ads, virtual try-on, or website builder. Decline those.\nSee [capability-gaps](../_shared/references/capability-gaps.md).\n<!-- host:end -->\n"
AFTER
"---\nname: omneky-billing\ndescription: >-\n  Call get_account by name for remaining Omneky prepaid ad\n  credits. Also plan entitlements and credit history. Use when the user asks how many ad credits remain,\n  credit balance, credit history, out of credits, which plan,\n  or card on file. Do not use for campaign spend/ROAS\n  (omneky-analytics-and-catalogue), competitor analysis\n  (omneky-competitor-analysis), A/B tests (omneky-ab-tests),\n  first-run onboarding (omneky-onboarding), agency\n  (omneky-agency), weekly marketing plans\n  (omneky-marketing-plan), creating ads, launching\n  campaigns (omneky-launch-and-connect), or collecting card numbers.\n  Keywords: ad credits, credit balance, remaining credits, how many\n  credits, credit history audit, top-up, plan, card on file.\n---\n\n# Ad credits and plan (read only)\n\nUse this when the user asks how many ad credits remain, what they\nhave spent credits on, which plan they are on, or what card is on\nfile. One job: read-only billing answers.\n\nThere is no upgrade, portal or checkout tool, and no payment links.\n\n<!-- host:begin name=\"stripe-redirect\" -->\nNever collect a PAN. Never invent a purchase or upgrade tool, and never\nsend payment, checkout or portal links. The user adds credits or\nchanges plan in the Omneky app.\n<!-- host:end -->\n\nHandoff fields: [handoff-contract](../_shared/references/handoff-contract.md).\nSourced ids: [preconditions](../_shared/references/preconditions.md).\n<!-- host:begin name=\"scan-tools-routing\" -->\nAcceptance gates: [creative-quality-gates](../_shared/references/creative-quality-gates.md).\nOther intents: [capability-registry](../_shared/references/capability-registry.md).\nWrite for: [marketer-persona](../_shared/references/marketer-persona.md).\n<!-- host:end -->\n\n## Goal\n\nShow credits, the shortfall if any, and the credit history.\n\n## When to use\n\n- Remaining credits, credit history, which plan, card on file\n- `credit_insufficient` after a creative or launch\n\n## When not to use\n\n- Campaign spend, ROAS, or daily metrics (analytics skill)\n- Weekly marketing plans (`omneky-marketing-plan`)\n<!-- host:begin name=\"billing-creative-when-not\" -->\n- Creating ads (`omneky-image-ads`) or launching them\n  (`omneky-launch-and-connect`)\n<!-- host:end -->\n- Collecting a card number\n\n## Prerequisites\n\n| Need | Check | If missing |\n|---|---|---|\n| Balance | `get_account` | Say the tool is missing; Omneky app |\n| Ledger | `get_account` (`include_credit_history=true`) | Skip the audit line |\n\n## Call by name\n\nCall only names on this session's `tools/list`.\n\n| User ask | Tool |\n|---|---|\n| how many credits remain | `get_account` |\n| credit grants and usage ledger | `get_account` (`include_credit_history=true`) |\n| plan and credit snapshot | `get_account` |\n| which plans exist, buy credits, change plan | no tool: the user does it on omneky.com |\n| card brand and last4 | `get_account` |\n| company record | `get_account` |\n\n## Flow\n\n1. Call the tool for the ask. Lead with the number, the shortfall if\n   any, and one next step.\n2. For \"what will this cost\": there is no quote tool. Say a paid run\n   uses credits and its result reports `credits_charged`; the amount\n   shows in `get_account` (`include_credit_history=true`). Never invent a figure.\n3. Present `get_account` (`include_credit_history=true`) as a dated ledger, not the balance.\n4. For plans, plan changes or top-ups, say the user buys credits or\n   changes plan on omneky.com (Ads Central).\n\n## credit_insufficient\n\nNothing started and nothing was charged. Tell the user `required` and\n`balance` in one line and that credits are added in the Omneky app.\nDo not retry until they say they have enough.\n\n<!-- host:begin name=\"creative-quote-rules\" -->\nQuote rules for creative jobs:\n[creative-pricing-and-polling](../_shared/references/creative-pricing-and-polling.md).\n<!-- host:end -->\n\n## Failure and recovery\n\nAuth / 401 → `omneky-getting-started-and-failures` (host OAuth).\nA billing tool is missing → say so; the user checks in the Omneky app.\nNever invent a balance or a purchase tool.\n`needs_user_decision` → fill the missing detail and call again.\n\n<!-- host:begin name=\"capability-gaps-link\" -->\n## Gaps\n\nDecline social inbox, landing pages, subtitle burn-in, email/SMS,\norganic scheduling, Ad Library ads, try-on, and website builder\n([capability-gaps](../_shared/references/capability-gaps.md)).\n<!-- host:end -->\n"
Full snapshot data
{
  "description": "Call get_account by name for remaining Omneky prepaid ad credits. Also plan entitlements and credit history. Use when the user asks how many ad credits remain, credit balance, credit history, out of credits, which plan, or card on file. Do not use for campaign spend/ROAS (omneky-analytics-and-catalogue), competitor analysis (omneky-competitor-analysis), A/B tests (omneky-ab-tests), first-run onboarding (omneky-onboarding), agency (omneky-agency), weekly marketing plans (omneky-marketing-plan), creating ads, launching campaigns (omneky-launch-and-connect), or collecting card numbers. Keywords: ad credits, credit balance, remaining credits, how many credits, credit history audit, top-up, plan, card on file.",
  "included_files": [],
  "name": "omneky-billing",
  "skill_md_contents": "---\nname: omneky-billing\ndescription: >-\n  Call get_account by name for remaining Omneky prepaid ad\n  credits. Also plan entitlements and credit history. Use when the user asks how many ad credits remain,\n  credit balance, credit history, out of credits, which plan,\n  or card on file. Do not use for campaign spend/ROAS\n  (omneky-analytics-and-catalogue), competitor analysis\n  (omneky-competitor-analysis), A/B tests (omneky-ab-tests),\n  first-run onboarding (omneky-onboarding), agency\n  (omneky-agency), weekly marketing plans\n  (omneky-marketing-plan), creating ads, launching\n  campaigns (omneky-launch-and-connect), or collecting card numbers.\n  Keywords: ad credits, credit balance, remaining credits, how many\n  credits, credit history audit, top-up, plan, card on file.\n---\n\n# Ad credits and plan (read only)\n\nUse this when the user asks how many ad credits remain, what they\nhave spent credits on, which plan they are on, or what card is on\nfile. One job: read-only billing answers.\n\nThere is no upgrade, portal or checkout tool, and no payment links.\n\n<!-- host:begin name=\"stripe-redirect\" -->\nNever collect a PAN. Never invent a purchase or upgrade tool, and never\nsend payment, checkout or portal links. The user adds credits or\nchanges plan in the Omneky app.\n<!-- host:end -->\n\nHandoff fields: [handoff-contract](../_shared/references/handoff-contract.md).\nSourced ids: [preconditions](../_shared/references/preconditions.md).\n<!-- host:begin name=\"scan-tools-routing\" -->\nAcceptance gates: [creative-quality-gates](../_shared/references/creative-quality-gates.md).\nOther intents: [capability-registry](../_shared/references/capability-registry.md).\nWrite for: [marketer-persona](../_shared/references/marketer-persona.md).\n<!-- host:end -->\n\n## Goal\n\nShow credits, the shortfall if any, and the credit history.\n\n## When to use\n\n- Remaining credits, credit history, which plan, card on file\n- `credit_insufficient` after a creative or launch\n\n## When not to use\n\n- Campaign spend, ROAS, or daily metrics (analytics skill)\n- Weekly marketing plans (`omneky-marketing-plan`)\n<!-- host:begin name=\"billing-creative-when-not\" -->\n- Creating ads (`omneky-image-ads`) or launching them\n  (`omneky-launch-and-connect`)\n<!-- host:end -->\n- Collecting a card number\n\n## Prerequisites\n\n| Need | Check | If missing |\n|---|---|---|\n| Balance | `get_account` | Say the tool is missing; Omneky app |\n| Ledger | `get_account` (`include_credit_history=true`) | Skip the audit line |\n\n## Call by name\n\nCall only names on this session's `tools/list`.\n\n| User ask | Tool |\n|---|---|\n| how many credits remain | `get_account` |\n| credit grants and usage ledger | `get_account` (`include_credit_history=true`) |\n| plan and credit snapshot | `get_account` |\n| which plans exist, buy credits, change plan | no tool: the user does it on omneky.com |\n| card brand and last4 | `get_account` |\n| company record | `get_account` |\n\n## Flow\n\n1. Call the tool for the ask. Lead with the number, the shortfall if\n   any, and one next step.\n2. For \"what will this cost\": there is no quote tool. Say a paid run\n   uses credits and its result reports `credits_charged`; the amount\n   shows in `get_account` (`include_credit_history=true`). Never invent a figure.\n3. Present `get_account` (`include_credit_history=true`) as a dated ledger, not the balance.\n4. For plans, plan changes or top-ups, say the user buys credits or\n   changes plan on omneky.com (Ads Central).\n\n## credit_insufficient\n\nNothing started and nothing was charged. Tell the user `required` and\n`balance` in one line and that credits are added in the Omneky app.\nDo not retry until they say they have enough.\n\n<!-- host:begin name=\"creative-quote-rules\" -->\nQuote rules for creative jobs:\n[creative-pricing-and-polling](../_shared/references/creative-pricing-and-polling.md).\n<!-- host:end -->\n\n## Failure and recovery\n\nAuth / 401 → `omneky-getting-started-and-failures` (host OAuth).\nA billing tool is missing → say so; the user checks in the Omneky app.\nNever invent a balance or a purchase tool.\n`needs_user_decision` → fill the missing detail and call again.\n\n<!-- host:begin name=\"capability-gaps-link\" -->\n## Gaps\n\nDecline social inbox, landing pages, subtitle burn-in, email/SMS,\norganic scheduling, Ad Library ads, try-on, and website builder\n([capability-gaps](../_shared/references/capability-gaps.md)).\n<!-- host:end -->\n"
}

SHA-256 of public snapshot: 6ffa54d33cc6e0842e52dc469b65f9c841e47cc988bd266b3d54926bd0da0d41