Update to Omneky
Snapshot Oct 24, 2026 · 13:12 UTC · version 2.0.30
Collection source: downloaded plugin package.
Payment or plan references changed
Full description — Now says: 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,...
Observed in published text. Live prices and checkout terms have not been verified by this change.
Up to 3 plugins free · no card required.
All fields and original values.
Full description
Oct 8, 2026 · 06:23 UTC
Company plan upgrade, Stripe Customer Portal, and prepaid credit balance / history for the signed-in Omneky account. Production mcp.omneky.com exposes these tools; still confirm they appear on tools/list before calling. Out of credits → ...
Oct 24, 2026 · 13:12 UTC
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 Checkou...
Skill instructions
Oct 8, 2026 · 06:23 UTC
Company plan upgrade, Stripe Customer Portal, and prepaid credit balance / history for the signed-in Omneky account. Production mcp.omneky.com exposes these tools; still confirm they appear on tools/list before calling. Out of cred...
Oct 24, 2026 · 13:12 UTC
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 C...
Compare saved observations
Download comparison JSONSKILL.md text changes
− removed · + added
--- before +++ after @@ -1,139 +1,148 @@ --- name: omneky-billing description: >- - Company plan upgrade, Stripe Customer Portal, and prepaid credit balance / - history for the signed-in Omneky account. Production mcp.omneky.com exposes - these tools; still confirm they appear on tools/list before calling. Out of - credits → upgrade plan. Never collect a card PAN. Intent keywords: upgrade - plan, Stripe portal, invoices, card on file, checkout session, credit - balance, billing summary. + 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. --- -# Omneky billing +# Plan, credit history, and card on file (read only) -## Activation analytics - -If the host exposes a skill-activation / analytics hook, call it once per new user request with this skill name; otherwise skip silently. Never invent a tracking tool. Omneky MCP does **not** expose `track_skill_activation`. - -## Purpose - -Operational plan / portal / prepaid-credit workflows via cgp-backend-backed -MCP tools. Flow = Stripe Checkout / Customer Portal **URL redirects**. Never -complete Checkout yourself. Never collect a PAN. Never invent Nexus debit or -prepaid-credit purchase tools. +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 | + +## Flow + +Lead with the answer, one next step, and confidence. Do not narrate +the billing tools unless one is missing. + +- **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. ## When to use -- User asks which plan they are on, remaining credits, card on file, invoices, - or wants to upgrade -- Creative path returned `credit_insufficient` -- Tools below appear on this session’s `tools/list` +- 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 ## When not to use -- Paid-media ROAS / campaign spend → `omneky-analytics` -- Bank transfers / third-party invoices / general payment rails -- Inventing auto-topup or card-PAN capture - -## OpenAI runtime contract - -- Use only tools from the current OpenAI host + Omneky MCP (`https://mcp.omneky.com/mcp`). Never invent tools. -- Prefer native ChatGPT / host widgets and question UI for decisions. Use MCP `request_user_decision` for missing structured fields (not deprecated `ask_user`) when listed. Else `omneky-failure-modes` § Approval / plain-chat fallback. -- When intake is incomplete, ask **one** concise chat question. Never invent a question tool. -- Approval turns: end the turn after Approve / Deny (host UI or plain chat); mutate only next turn after Approve. -- Never invent tokens; OAuth is host-managed. - -## Non-negotiable output / safety contract - -- Confirm tool names on `tools/list` before calling. Billing tools may be - **absent** on some ChatGPT sessions — follow `omneky-failure-modes` - § Billing tools absent. If absent, tell the user to manage the plan in the - Omneky app / settings; never invent balance or billing tools. -- Out of credits → **plan upgrade** path (`list_available_plans` + - `start_plan_upgrade`, or Customer Portal). Do not invent prepaid purchase. -- `list_available_plans` returns lookup keys — Nexus has **no dollar prices** - here; do not invent a price catalog. -- Owner-only tools may refuse for non-owners — explain; do not bypass. -- After handing `checkout_url` / `portal_url`, wait for the user; poll - `get_checkout_session_status` **once** after they say they paid (plan-upgrade - Checkout only). Managed-launch payment uses - `get_managed_launch_payment_status` instead — do not mix them. -- Credits / deductions: existing MCP balance / history / upgrade tools only - (cgp-backend path). Never invent Nexus debit routes. -- No subscription promo copy in chat — operational gates only (e.g. image ~5 / - video ~30 credit callouts belong on creative skills). - -## Staged workflow - -### Stage 1 — Presence check - -1. Confirm allowlisted names exist on `tools/list`. If **absent**, stop — - do not invent tools or a fake balance; point to Omneky app / settings - (`omneky-failure-modes` § Billing tools absent). Creative siblings may - still generate after operational-cost callout and rely on - `credit_insufficient` as the hard gate. - -### Stage 2 — Snapshot - -1. `get_billing_summary` — plan + credit snapshot (not a price catalog). -2. Optional: `get_company` for identity / plan fields. -3. Dedicated balance: `get_account_credit_balance` (`credit_balance`, - `usd_per_credit`). -4. Ledger: `get_credit_history` (capped JSON rows). -5. Card on file: `get_payment_method_summary` (brand / last4 / expiry only). - -### Stage 3 — Upgrade / portal - -1. `list_available_plans` → keys such as `cgp_standard_monthly`, … -2. Either: - - `start_plan_upgrade` with a chosen key (saved-card change or - `checkout_url`), **or** - - `create_billing_portal_session` → `portal_url` when the user should pick - a plan / see live prices / invoices. -3. Ask the user to open the URL in the browser. End turn if waiting. - -### Stage 4 — After payment - -1. User says they finished plan-upgrade Checkout → - `get_checkout_session_status` **once**. -2. Re-read `get_account_credit_balance` / `get_billing_summary` if useful. -3. Managed-launch `status=payment_required` Checkout → - `get_managed_launch_payment_status` (not `get_checkout_session_status`). - -### Stage 5 — Hand back - -Return to `omneky-creative` / `omneky-image-ads` / `omneky-product-video` -when the original intent was generation. - -## Allowlisted tools (when listed) - -`get_billing_summary`, `get_company`, `get_account_credit_balance`, -`get_credit_history`, `list_available_plans`, `start_plan_upgrade`, -`create_billing_portal_session`, `get_payment_method_summary`, -`get_checkout_session_status`, `get_managed_launch_payment_status`. - -## Failure boundaries - -| Failure | Required response | -| --- | --- | -| Tools missing from `tools/list` | Stop; Omneky app / settings; never invent tools (`omneky-failure-modes` § Billing tools absent). | -| Non-owner on upgrade / portal | Explain owner-only; do not invent bypass. | -| User pastes card PAN in chat | Refuse to process PAN; send them to Stripe portal URL only. | -| Invented prepaid top-up tool | Refuse; use plan upgrade / portal. | -| Tight-loop checkout polling | One `get_checkout_session_status` after user confirmation. | -| Confused managed-launch vs plan Checkout | Use the matching status tool only. | -| `credit_insufficient` mid-creative | If balance/upgrade tools present → upgrade path; else Omneky app; do not retry generate until funded. | - -## Sibling map - -| Need | Skill | -| --- | --- | -| Balance-only gate | `omneky-credit-balance` | -| Resume image/video after top-up | `omneky-creative` / `omneky-image-ads` / `omneky-product-video` | -| Auth / tool missing | `omneky-failure-modes` / `omneky-getting-started` | - -## Never invent - -- Prepaid-credit purchase, auto-topup, webhook, or card-PAN tools -- Nexus debit routes or non-cgp balance endpoints -- Dollar prices from `list_available_plans` (keys only) +- 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) +- Collecting a card number + +## 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. + +| 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` | + +## credit_insufficient + +The render or launch did not start and nothing was charged. The server +reports `required` and `balance`. + +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). + +## If a billing tool is not available + +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). + +## 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`. + +<!-- 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). +<!-- host:end -->
Full technical diff · 2 changed fields
changed /description
"Company plan upgrade, Stripe Customer Portal, and prepaid credit balance / history for the signed-in Omneky account. Production mcp.omneky.com exposes these tools; still confirm they appear on tools/list before calling. Out of credits → upgrade plan. Never collect a card PAN. Intent keywords: upgrade plan, Stripe portal, invoices, card on file, checkout session, credit balance, billing summary."
"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."
changed /skill_md_contents
"---\nname: omneky-billing\ndescription: >-\n Company plan upgrade, Stripe Customer Portal, and prepaid credit balance /\n history for the signed-in Omneky account. Production mcp.omneky.com exposes\n these tools; still confirm they appear on tools/list before calling. Out of\n credits → upgrade plan. Never collect a card PAN. Intent keywords: upgrade\n plan, Stripe portal, invoices, card on file, checkout session, credit\n balance, billing summary.\n---\n\n# Omneky billing\n\n## Activation analytics\n\nIf the host exposes a skill-activation / analytics hook, call it once per new user request with this skill name; otherwise skip silently. Never invent a tracking tool. Omneky MCP does **not** expose `track_skill_activation`.\n\n## Purpose\n\nOperational plan / portal / prepaid-credit workflows via cgp-backend-backed\nMCP tools. Flow = Stripe Checkout / Customer Portal **URL redirects**. Never\ncomplete Checkout yourself. Never collect a PAN. Never invent Nexus debit or\nprepaid-credit purchase tools.\n\n## When to use\n\n- User asks which plan they are on, remaining credits, card on file, invoices,\n or wants to upgrade\n- Creative path returned `credit_insufficient`\n- Tools below appear on this session’s `tools/list`\n\n## When not to use\n\n- Paid-media ROAS / campaign spend → `omneky-analytics`\n- Bank transfers / third-party invoices / general payment rails\n- Inventing auto-topup or card-PAN capture\n\n## OpenAI runtime contract\n\n- Use only tools from the current OpenAI host + Omneky MCP (`https://mcp.omneky.com/mcp`). Never invent tools.\n- Prefer native ChatGPT / host widgets and question UI for decisions. Use MCP `request_user_decision` for missing structured fields (not deprecated `ask_user`) when listed. Else `omneky-failure-modes` § Approval / plain-chat fallback.\n- When intake is incomplete, ask **one** concise chat question. Never invent a question tool.\n- Approval turns: end the turn after Approve / Deny (host UI or plain chat); mutate only next turn after Approve.\n- Never invent tokens; OAuth is host-managed.\n\n## Non-negotiable output / safety contract\n\n- Confirm tool names on `tools/list` before calling. Billing tools may be\n **absent** on some ChatGPT sessions — follow `omneky-failure-modes`\n § Billing tools absent. If absent, tell the user to manage the plan in the\n Omneky app / settings; never invent balance or billing tools.\n- Out of credits → **plan upgrade** path (`list_available_plans` +\n `start_plan_upgrade`, or Customer Portal). Do not invent prepaid purchase.\n- `list_available_plans` returns lookup keys — Nexus has **no dollar prices**\n here; do not invent a price catalog.\n- Owner-only tools may refuse for non-owners — explain; do not bypass.\n- After handing `checkout_url` / `portal_url`, wait for the user; poll\n `get_checkout_session_status` **once** after they say they paid (plan-upgrade\n Checkout only). Managed-launch payment uses\n `get_managed_launch_payment_status` instead — do not mix them.\n- Credits / deductions: existing MCP balance / history / upgrade tools only\n (cgp-backend path). Never invent Nexus debit routes.\n- No subscription promo copy in chat — operational gates only (e.g. image ~5 /\n video ~30 credit callouts belong on creative skills).\n\n## Staged workflow\n\n### Stage 1 — Presence check\n\n1. Confirm allowlisted names exist on `tools/list`. If **absent**, stop —\n do not invent tools or a fake balance; point to Omneky app / settings\n (`omneky-failure-modes` § Billing tools absent). Creative siblings may\n still generate after operational-cost callout and rely on\n `credit_insufficient` as the hard gate.\n\n### Stage 2 — Snapshot\n\n1. `get_billing_summary` — plan + credit snapshot (not a price catalog).\n2. Optional: `get_company` for identity / plan fields.\n3. Dedicated balance: `get_account_credit_balance` (`credit_balance`,\n `usd_per_credit`).\n4. Ledger: `get_credit_history` (capped JSON rows).\n5. Card on file: `get_payment_method_summary` (brand / last4 / expiry only).\n\n### Stage 3 — Upgrade / portal\n\n1. `list_available_plans` → keys such as `cgp_standard_monthly`, …\n2. Either:\n - `start_plan_upgrade` with a chosen key (saved-card change or\n `checkout_url`), **or**\n - `create_billing_portal_session` → `portal_url` when the user should pick\n a plan / see live prices / invoices.\n3. Ask the user to open the URL in the browser. End turn if waiting.\n\n### Stage 4 — After payment\n\n1. User says they finished plan-upgrade Checkout →\n `get_checkout_session_status` **once**.\n2. Re-read `get_account_credit_balance` / `get_billing_summary` if useful.\n3. Managed-launch `status=payment_required` Checkout →\n `get_managed_launch_payment_status` (not `get_checkout_session_status`).\n\n### Stage 5 — Hand back\n\nReturn to `omneky-creative` / `omneky-image-ads` / `omneky-product-video`\nwhen the original intent was generation.\n\n## Allowlisted tools (when listed)\n\n`get_billing_summary`, `get_company`, `get_account_credit_balance`,\n`get_credit_history`, `list_available_plans`, `start_plan_upgrade`,\n`create_billing_portal_session`, `get_payment_method_summary`,\n`get_checkout_session_status`, `get_managed_launch_payment_status`.\n\n## Failure boundaries\n\n| Failure | Required response |\n| --- | --- |\n| Tools missing from `tools/list` | Stop; Omneky app / settings; never invent tools (`omneky-failure-modes` § Billing tools absent). |\n| Non-owner on upgrade / portal | Explain owner-only; do not invent bypass. |\n| User pastes card PAN in chat | Refuse to process PAN; send them to Stripe portal URL only. |\n| Invented prepaid top-up tool | Refuse; use plan upgrade / portal. |\n| Tight-loop checkout polling | One `get_checkout_session_status` after user confirmation. |\n| Confused managed-launch vs plan Checkout | Use the matching status tool only. |\n| `credit_insufficient` mid-creative | If balance/upgrade tools present → upgrade path; else Omneky app; do not retry generate until funded. |\n\n## Sibling map\n\n| Need | Skill |\n| --- | --- |\n| Balance-only gate | `omneky-credit-balance` |\n| Resume image/video after top-up | `omneky-creative` / `omneky-image-ads` / `omneky-product-video` |\n| Auth / tool missing | `omneky-failure-modes` / `omneky-getting-started` |\n\n## Never invent\n\n- Prepaid-credit purchase, auto-topup, webhook, or card-PAN tools\n- Nexus debit routes or non-cgp balance endpoints\n- Dollar prices from `list_available_plans` (keys only)\n"
"---\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"
Full snapshot data
{
"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.",
"included_files": [],
"name": "omneky-billing",
"skill_md_contents": "---\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"
}SHA-256 of public snapshot: dd6ee0ab17da8b0bea136d4430aadac5a68644438111cab9896e81b7b0e2c55a