manage_billing
InactiveTool of io.github.butterbase-ai/mcp
Manage billing, plans, usage, and spending caps for the Butterbase platform account. This is a platform-scoped tool — it operates on the authenticated account, not on a specific app. Actions: - "status": Get current plan, usage summary, and spending cap in one call - "portal": Generate a Stripe billing portal URL for payment method / invoice management - "topup": Add credit to the account balance (prepaid top-up) - "cap_get": Retrieve the current monthly spending cap - "cap_raise": Raise the monthly spending cap by a given amount - "plans": List all available subscription plans with pricing - "usage": Query detailed metered usage for a date range and optional meter type Parameters by action: status: { action: "status" } portal: { action: "portal" } topup: { action: "topup", amount: <number in USD cents> } cap_get: { action: "cap_get" } cap_raise: { action: "cap_raise", raise_by: <number in USD cents> } plans: { action: "plans" } usage: { action: "usage", start_date?: "YYYY-MM-DD", end_date?: "YYYY-MM-DD", meter?: "compute" | "storage" | ... } Examples: Check current plan and balance: Input: { action: "status" } Output: { plan: "pro", balance_cents: 5000, spending_cap_cents: 20000, usage: { ... } } Open billing portal: Input: { action: "portal" } Output: { url: "https://billing.stripe.com/session/..." } Top up $25: Input: { action: "topup", amount: 2500 } Output: { success: true, new_balance_cents: 7500 } Get current spending cap: Input: { action: "cap_get" } Output: { spending_cap_cents: 20000 } Raise spending cap by $50: Input: { action: "cap_raise", raise_by: 5000 } Output: { spending_cap_cents: 25000 } List available plans: Input: { action: "plans" } Output: [{ id: "free", name: "Free", ... }, { id: "pro", name: "Pro", ... }] Query compute usage for April 2025: Input: { action: "usage", start_date: "2025-04-01", end_date: "2025-04-30", meter: "compute" } Output: { usage: [{ date: "2025-04-01", value: 1234 }, ...] } Common errors: - AUTH_INSUFFICIENT_PERMISSIONS: Must be authenticated as the account owner - INSUFFICIENT_BALANCE: Account balance too low for top-up operation - INVALID_AMOUNT: amount / raise_by must be a positive integer (cents)
Parameters schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"action"
],
"properties": {
"meter": {
"type": "string",
"description": "Meter type to filter usage by, e.g. \"compute\", \"storage\" (used with \"usage\")"
},
"action": {
"enum": [
"status",
"portal",
"topup",
"cap_get",
"cap_raise",
"plans",
"usage"
],
"type": "string",
"description": "The billing action to perform"
},
"amount": {
"type": "integer",
"description": "Amount in USD cents (required for \"topup\")",
"exclusiveMinimum": 0
},
"end_date": {
"type": "string",
"description": "End date for usage query in YYYY-MM-DD format (used with \"usage\")"
},
"raise_by": {
"type": "integer",
"description": "Amount in USD cents to raise the spending cap by (required for \"cap_raise\")",
"exclusiveMinimum": 0
},
"start_date": {
"type": "string",
"description": "Start date for usage query in YYYY-MM-DD format (used with \"usage\")"
}
},
"additionalProperties": false
}Parent server
io.github.butterbase-ai/mcp
https://github.com/butterbase-ai/butterbase-oss
1/7 registries