Billing and AI credits

MCP Stack uses prepaid AI credits for hosted agent usage. Owners and Admins can buy top-ups through Stripe Checkout; Developers can view balance and history. Hosted MCP server counts may be capped by your self-serve plan.

Credit flow#

Top-ups add credits to the organization ledger; agent and hosted usage debits the balance over time.

Requirements#

• billing view access to see balance and ledger (Owners, Admins, and Developers)
• billing manage access to start checkout (Owner or Admin)
• Stripe-supported payment method for self-serve top-ups

Role details live in Organization roles and billing access.

Dashboard path#

Settings → Billing shows balance, Purchases, Usage, and hosted MCP summary.

1. Open Settings → Billing.
2. Review current AI credit balance.
3. Open Purchases for top-up history and Usage for debits.
4. Owners/Admins: click buy/top-up, complete Stripe Checkout, then sync if prompted.
5. Review hosted MCP usage summary when using hosted runtimes.

Team self-serve plans include 10 hosted MCP servers. Existing configs above the cap remain, but new hosted servers are blocked until you disable configs, upgrade, or receive an operator override.

Enterprise workspaces may show invoice status instead of self-serve plan cards.

CLI path#

Start billing checkout from the dashboard. Use the CLI to inspect usage-related platform state:

mcpstack agents usage ag_support --json
mcpstack servers list --json

Use API keys with appropriate billing permissions for automation against the credit APIs below.

API path#

Read credit summary:

GET /api/v1/organizations/{orgId}/ai-credits/summary
Authorization: Bearer {token}

Read ledger (paginated):

GET /api/v1/organizations/{orgId}/ai-credits/ledger?category=purchases&page=1&pageSize=50
GET /api/v1/organizations/{orgId}/ai-credits/ledger?category=usage&page=1&pageSize=50

Start Stripe checkout (billing manage required):

POST /api/v1/organizations/{orgId}/ai-credits/checkout-session
Authorization: Bearer {token}
Content-Type: application/json
 
{
  "creditAmountUsd": 50
}

Sync after checkout:

POST /api/v1/organizations/{orgId}/ai-credits/checkout-session/{sessionId}/sync
Authorization: Bearer {token}

Troubleshooting#

Quick answer#

Developers see credits and usage; Owners/Admins buy top-ups from Settings → Billing. Agent usage debits the same ledger that purchases fill.