Loading...
Loading...
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.
npx skill4agent add stripe/ai metronomehttps://api.metronome.comAuthorization| Building… | Recommended API | Details |
|---|---|---|
| Ingesting usage events | | Send usage events, the API quickstart, the Ingest API reference, and Set ingest aliases |
| Defining what to measure | Billable Metrics API | Create billable metrics |
| Enterprise pricing agreements | Contracts + Rate Cards | Provision a customer contract, Create and manage rate cards, and the Create a contract and Add rates API references |
| Mid-term contract changes | Contract Edits | Edit a contract, Contract edits and overrides, and Manage contract lifecycle |
| Invoice lifecycle and finalization | Invoices API | How Metronome invoices work |
| Prepaid or postpaid commitments and one-off top-ups | Commits + Credits | Apply credits and commits to contracts and Payment-gated commits |
| Syncing invoices to Stripe | Stripe billing provider config | Invoice with Stripe |
| Prepaid balances, auto-recharge, spend alerts, and thresholds | Notifications API | Set prepaid balance thresholds, Enforce spend thresholds, and Threshold notifications |
.mdhttps://api.metronome.comGET /v1/account| Task | Metronome skill | What it does |
|---|---|---|
| Migrating from Stripe Billing Meters, Subscriptions, and Credit Grants to Metronome | stripe-to-metronome-migration | Changes production state when executed: creates Metronome customers, contracts, and credits, flips billable status, and ends Stripe subscriptions at cutover. Also covers scoping, concept mapping, group key design, the parallel run, and rollback. |
Designing | metronome-group-keys | Creates the billable metric and product after a confirmation gate. Sizes cardinality risk first: a compound key’s cost is the product of each dimension’s cardinality, and |
| Setting up Metronome from scratch: billable metrics, products, rate card, customer, and contract | metronome-setup-catalog | Creates objects. End-to-end setup from pricing intent to a verified draft invoice. |
| Creating a customer record | metronome-create-customer | Creates objects. Duplicate check and preview, then |
| Creating a new contract from signed order-form terms | metronome-create-contract | Creates objects. Commits, credits, and rate overrides on a new contract, including commit-specific discounts; for an existing contract use Contract Edits (routing table above). |
| Billing an AI application for token usage | metronome-token-billing | Creates objects. Models AI plans, builds the managed rate card with your markup over Stripe’s model catalog, provisions the customer, and validates the Stripe and Metronome flow. |
| Self-serve (PLG) billing setup, pricing changes, and single-customer diagnostics, in business terms | metronome-plg-billing | Creates and changes objects in its start-billing and change-pricing modes; customer-story mode is a read-only diagnostic. |
| Customer health reviews for Metronome CSMs: anomalies, commit burn, portfolio briefing, renewal prep | metronome-csm-reviews | Read-only. Written for Metronome’s account team rather than for building an integration. |
POST /v1/credits/migrateToContractsPOST /v2/contracts/edit/v1/contracts/amendtransition: {type: "renewal", from_contract_id}POST /v1/ingest200event_typetransaction_idbilling_period_end_dateusage_filtergroup_keygroup_valuesending_beforerollover_fractionapplicable_product_idsapplicable_product_tagsspecifiersspend_threshold_configurationproduct_idnamedescriptionpriorityprepaid_balance_threshold_configuration1000totalbilling_provider_configurationrevenue_system_configuration