Billing & Credits
Instructionly uses a credit-based billing system. Credits are consumed when AI instructions are retrieved via MCP.
How Credits Work
- Credit Reserve — When you make a request, credits are temporarily reserved from your balance
- Processing — Your request is processed and instructions are delivered
- Finalization — The final credit amount is calculated and deducted
- Tracking — All transactions are recorded for transparency
Credit Consumption
Credits are consumed based on:
- Number of instructions delivered
- Complexity of skill matching
- Session activity
Transaction Types
| Type | Description |
|---|---|
| Purchase | Credits added via manual purchase or auto top-up |
| Usage | Credits consumed by MCP requests |
| Refund | Credits returned (e.g., failed transactions) |
| Adjustment | Manual credit adjustments by support or gift code redemption |
Creating a Billing Account
- Navigate to Billing
- Click Create Billing Account
- Enter the account name
- Select your currency
- Add payment method details
- Click Create
Buying Credits
- Go to your billing account
- Click Buy Credits
- Select a credit pack
- Complete the payment via Stripe
Credit Packs
| Pack | Price | Credits | Bonus |
|---|---|---|---|
| Starter | $10 | 100 credits | - |
| Basic | $25 | 263 credits | +5% (13 extra) |
| Growth | $50 | 550 credits | +10% (50 extra) |
| Scale | $100 | 1,150 credits | +15% (150 extra) |
| Pro | $250 | 3,000 credits | +20% (500 extra) |
| Enterprise | $500 | 6,250 credits | +25% (1,250 extra) |
Linking a Billing Account to a Workspace
Each workspace needs a linked billing account to use credits:
- Go to Billing in your workspace
- Click Link Billing Account
- Select from your available billing accounts
- Click Link
Auto Top-Up
Configure automatic credit purchases to never run out:
- Open your billing account
- Go to Auto Top-Up Settings
- Enable auto top-up
- Set the threshold (e.g., when balance falls below 50 credits)
- Select the credit pack to purchase automatically
- Save settings
Set your threshold higher than your typical daily usage to avoid running out during active development sessions.
Viewing Transactions
Track all billing activity:
- Go to your billing account
- Click View Transactions
- Filter by date range or transaction type
- View purchase, usage, refund, and adjustment records
Unlinking a Billing Account
Only workspace owners can unlink billing accounts:
- Go to Billing in your workspace
- Click Unlink Account
- Confirm the action