--- title: "Metronome: review, setup & limitations · Undominated.ai" canonical: https://undominated.ai/skills/stripe-metronome/ description: "Stripe's Metronome skill for usage ingestion, contracts, and invoice sync, with confirmation required before writes because sandbox and production share one API host." --- # Metronome: review, setup & limitations · Undominated.ai > Stripe's Metronome skill for usage ingestion, contracts, and invoice sync, with confirmation required before writes because sandbox and production share one API host. [← Explore all skills](/skills/) BILLING / Stripe # Metronome Stripe's Metronome skill for usage ingestion, contracts, and invoice sync, with confirmation required before writes because sandbox and production share one API host. [See setup guidance ↓](#setup)[Original source ↗](https://github.com/stripe/ai/tree/789ef5e0a55ee1d0787a5974660b15bf76dc29b5/skills/metronome) SOURCE REVIEW Reviewed 2026-10-15 Evidence 4 linked sources Publisher Stripe Licence [MIT ↗](https://github.com/stripe/ai/blob/789ef5e0a55ee1d0787a5974660b15bf76dc29b5/LICENSE) Revision 789ef5e0a55e [Read what was—and wasn’t—checked ↓](#review) “Guides Metronome usage-based billing integration decisions — event ingestion (single and batch, idempotency, billable metrics), contract design (rate cards, overrides, dimensional pricing, products), invoicing lifecycle (grace periods, finalization, Stripe sync), credit and commit management (prepaid, postpaid, thresholds, auto-recharge), and Stripe integration (arrears invoicing, tax providers, line item limits). Use when building, modifying, or reviewing any Metronome integration — including ingesting usage events, creating customers, contracts, or rate cards, designing billable metric group keys, managing credits and commits, configuring invoicing, syncing invoices with Stripe Billing, billing AI applications for token usage, setting up self-serve (PLG) pricing, reviewing customer health, commit burn, portfolios, or renewals, or migrating from Stripe Billing Meters to Metronome.” [Stripe · upstream description ↗](https://github.com/stripe/ai/blob/789ef5e0a55ee1d0787a5974660b15bf76dc29b5/skills/metronome/SKILL.md) Our analysis follows below. 01 / THE REASONING ## Why this made the selection. - The catalogue has stripe-pay and withholds two other Stripe skills; it has no Metronome skill. - The file separates read-only CSM review from workflows that create contracts and end Stripe subscriptions. ### A good fit for - Designing a Metronome contract and rate card - Reviewing usage-event idempotency before ingestion ### Weigh up before choosing - This review did not execute the skill or call api.metronome.com. - Remote skills linked on docs.metronome.com were not fetched. - The README install command tracks docs.stripe.com and was not byte-compared with this pinned file. - Sandbox and production share api.metronome.com; the bearer token determines the environment. Linked workflows can write Metronome objects and end Stripe subscriptions, with separate Stripe account and mode confirmation required. 02 / THE REVIEW RECORD ## What we actually inspected. Source review has boundaries. A clear record is more useful than a “safe” badge. ### Material inspected - skills/metronome/SKILL.md - README.md - LICENSE ### Our findings - The skill says to use Contracts rather than legacy Plans for new customers, and Edits rather than Amendments for mid-term changes. - It requires a unique transaction_id that stays fixed across retries, batch POST /v1/ingest of 1 to 100 events, and USD amounts in cents. - It says sandbox and production share https://api.metronome.com, so the token selects the environment, and it requires a separate confirmation before Stripe writes. ### Not established by this review - The skill was not executed. - No Metronome or Stripe API call was made. - Linked docs.metronome.com skills were not opened. - Not executed: it was not installed or run. The review applies to the material and revision named here. A newer upstream release can change its behavior. 03 / PUT IT TO WORK ## Add a skill to your workflow. [Upstream setup instructions ↗](https://github.com/stripe/ai/blob/789ef5e0a55ee1d0787a5974660b15bf76dc29b5/README.md) DOCUMENTED COMMAND npx skills add https://docs.stripe.com Copy command ↗ Run in your terminal to choose your AI tools, project or global scope, and installation method. This short command follows the current upstream version; the review covers the revision shown above. - The README presents that command as the manual skill install. - It tracks https://docs.stripe.com rather than the pinned commit reviewed here. - Other README lines install the Stripe plugin for Claude, Codex, Cursor, or Grok and were not treated as this file's command. ### Before you start - A skills-compatible client - A Metronome bearer token only when an API call is made - Explicit confirmation before any write ### Compatibility Claude Code · OpenAI Codex · Cursor · Grok ### Docs skill; writes need confirmation - Read Metronome and Stripe docs - Create Metronome objects only after the user confirms the token's environment - End Stripe subscriptions only in the migration workflow after a separate confirmation ### Cost model MIT, copyright 2024-2025 Stripe; Metronome and Stripe accounts are required only to call the APIs 04 / FOLLOW THE EVIDENCE ## The source trail. Our notes are separate from the original resource. Check upstream before adopting a new version. - [metronome SKILL.md ↗](https://github.com/stripe/ai/blob/789ef5e0a55ee1d0787a5974660b15bf76dc29b5/skills/metronome/SKILL.md) Checked 2026-10-14 https://github.com/stripe/ai/blob/789ef5e0a55ee1d0787a5974660b15bf76dc29b5/skills/metronome/SKILL.md Supports: contracts, idempotency, and confirmation rules - [MIT LICENSE ↗](https://github.com/stripe/ai/blob/789ef5e0a55ee1d0787a5974660b15bf76dc29b5/LICENSE) Checked 2026-10-14 https://github.com/stripe/ai/blob/789ef5e0a55ee1d0787a5974660b15bf76dc29b5/LICENSE Supports: MIT grant - [README manual install ↗](https://github.com/stripe/ai/blob/789ef5e0a55ee1d0787a5974660b15bf76dc29b5/README.md) Checked 2026-10-14 https://github.com/stripe/ai/blob/789ef5e0a55ee1d0787a5974660b15bf76dc29b5/README.md Supports: the docs.stripe.com install command - [Pinned source review C2-W50 ↗](https://raw.githubusercontent.com/stripe/ai/789ef5e0a55ee1d0787a5974660b15bf76dc29b5/skills/metronome/SKILL.md) Checked 2026-10-15 https://raw.githubusercontent.com/stripe/ai/789ef5e0a55ee1d0787a5974660b15bf76dc29b5/skills/metronome/SKILL.md Supports: upstreamDescription, limitations, review.notTested, review.reviewedAt KEEP COMPARING ## Other approaches to consider. Related by category or shared topics. These are alternatives to inspect, not a measured quality order. [### API and Interface Design ↗ Designs public interfaces so the right call is easy and a breaking change is explicit.](/skills/addyosmani-api-and-interface-design/)[### Integration Resilience Engineer ↗ Designs resilient HTTP, messaging and scheduled integrations: timeout budgets derived from the caller’s SLO, retryable-versus-terminal failure classification, idempotency and deduplication, circuit breakers, DLQ behaviour, and distributed locking for scheduled jobs.](/skills/jetbrains-integration-resilience-engineer/)[### Stripe docs CLI ↗ Pins Stripe's skill for reading docs through the Stripe CLI, including the login step it requires for gated pages.](/skills/stripe-docs/) [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/) ## Continue your investigation - [Choose a toolkit](/tools/) - [Inspect execution hosts](/agents/) - [Check tool access](/mcp-servers/) - [Check project dependencies](/check-repo/)