Documentation

Billing & Credits

Instructionly uses a credit-based billing system. Credits are consumed when AI instructions are retrieved via MCP.

How Credits Work

  1. Credit Reserve — When you make a request, credits are temporarily reserved from your balance
  2. Processing — Your request is processed and instructions are delivered
  3. Finalization — The final credit amount is calculated and deducted
  4. 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

  1. Navigate to Billing
  2. Click Create Billing Account
  3. Enter the account name
  4. Select your currency
  5. Add payment method details
  6. Click Create

Buying Credits

  1. Go to your billing account
  2. Click Buy Credits
  3. Select a credit pack
  4. 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:

  1. Go to Billing in your workspace
  2. Click Link Billing Account
  3. Select from your available billing accounts
  4. Click Link

Auto Top-Up

Configure automatic credit purchases to never run out:

  1. Open your billing account
  2. Go to Auto Top-Up Settings
  3. Enable auto top-up
  4. Set the threshold (e.g., when balance falls below 50 credits)
  5. Select the credit pack to purchase automatically
  6. Save settings
Recommended setting

Set your threshold higher than your typical daily usage to avoid running out during active development sessions.

Viewing Transactions

Track all billing activity:

  1. Go to your billing account
  2. Click View Transactions
  3. Filter by date range or transaction type
  4. View purchase, usage, refund, and adjustment records

Unlinking a Billing Account

Only workspace owners can unlink billing accounts:

  1. Go to Billing in your workspace
  2. Click Unlink Account
  3. Confirm the action