Amberflo MCP server. Query and manage Amberflo metering & billing: customers, meters, usage, plans, invoices, prepaid.
Add to your MCP config, then reload & authorize:
{
"mcpServers": {
"amberflo": {
"url": "https://amberflo.usefulapi.io/mcp"
}
}
}| Tool | Type | What it does |
|---|---|---|
amberflo_list_customers | read | List customers List every customer registered in your Amberflo account with their ids, names, emails, traits and enabled status — the usual first call to discover customer ids. |
amberflo_get_customer | read | Get customer Fetch a single customer by its Amberflo customerId, returning that customer's full profile and traits. |
amberflo_list_meters | read | List meters List all meter definitions in your account (id, meterApiName, label, type and aggregation) so you know which meters the usage tools can target. |
amberflo_get_usage | read | Get usage Query aggregated usage for a single meter over a time range, optionally grouped by dimension, filtered, and limited to the top N groups. |
amberflo_get_all_usage | read | Get all usage Get total usage across all meters over a time range, optionally grouped by customer or restricted to a single customer. |
amberflo_explain_usage | read | Explain usage Drill into the raw meter events behind a meter's usage over a time range to debug why an aggregated number looks off. |
amberflo_get_customer_plan | read | Get customer plan Get a customer's latest assigned pricing product plan so you can see exactly what they are currently billed on. |
amberflo_list_customer_plan_history | read | List customer plan history List the full history of pricing product plans assigned to a customer over time. |
amberflo_list_customer_invoices | read | List customer invoices List all invoices for a customer, optionally scoped to one product, each with its payment status. |
amberflo_get_customer_invoice | read | Get customer invoice Get a single customer invoice — either the current open invoice or a specific past one addressed by plan, year, month and day. |
amberflo_list_prepaid_orders | read | List prepaid orders List a customer's active prepaid credit orders for a given product. |
amberflo_create_customer | write | Create customer Register a new customer in Amberflo (id and name required, plus optional email, enabled flag and traits) and optionally auto-create it in Stripe. |
amberflo_assign_customer_plan | write | Assign customer plan Attach a pricing product plan to a customer, changing what that customer is billed on going forward. |
amberflo_ingest_usage | write | Ingest usage Record a single usage meter event to Amberflo's ingestion host, writing billable usage data for a customer. |
amberflo_usage_status | Usage status (free-tier meter) Report the caller's current free-tier usage this month: calls used, monthly limit, remaining, and whether the cap is reached. Read-only; does not count against the meter. | |
amberflo_upgrade | Upgrade to Pro (unlimited) Subscribe to the Pro plan for UNLIMITED Amberflo tool calls (the free tier caps monthly usage). Choose monthly ($9/month) or yearly ($90/year — 2 months free) billing. Returns a Stripe Checkout link to open in your browser; after payment your account upgrades automatically. Read-only; does not count against the meter. |
| Plan | Price | Limit |
|---|---|---|
| Free | $0 | 100 tool calls / month |
| Pro | $9/mo · $90/yr | Unlimited |
This is a Model Context Protocol endpoint — meant to be connected from an AI client, not opened in a browser. An invalid_token response at the URL is the auth gate working as designed; clients authenticate automatically.